跳转至

快速上手

5 分钟内让 OLAV 看见你的网络：安装、配置设备、采集数据、发出第一个查询。

功能声明

ID 声明 状态
C-NE-01 安装 olav-netops 后 /netops_init --dry-run 通过环境检查 ⬜ 待验证
C-NE-02 安装 olav-netops 后 olav list 包含 ops-orchestrator ⬜ 待验证
C-NE-03 /netops_init 采集设备数据并写入 netops.parsed_outputs 🔶 需设备环境
C-NE-04 /netops_init 从 LLDP/CDP 发现数据生成拓扑链接 🔶 需设备环境

第一步：安装 olav-netops

pip install olav-netops

cd olav
uv pip install -e olav-netops/

验证扩展已加载：

olav list

输出应包含：

  • ops  (or ops-orchestrator)
    Deep troubleshooting with full ReAct loop; includes lab emulation for CAB validation
    Location: .olav/workspace/ops/

第二步：配置设备

编辑 Nornir 清单文件定义网络设备：

nano .olav/workspace/ops/config/nornir/hosts.yaml

示例 hosts.yaml：

R1:
  hostname: 10.0.1.1
  platform: cisco_ios
  groups:
    - core_routers

R2:
  hostname: 10.0.1.2
  platform: cisco_ios
  groups:
    - core_routers

组默认值在 groups.yaml 中配置：

core_routers:
  username: admin
  password: "${NORNIR_PASSWORD}"
  connection_options:
    netmiko:
      extras:
        timeout: 30

第三步：运行初始化

olav --agent ops "/netops_init"

初始化执行 5 个阶段的流水线：

阶段 执行内容
0 检查环境：Nornir 配置、LLM 可用性、workspace
1 SSH 连接所有设备，执行 show 命令，TextFSM 解析
2 分析解析差距（P0 关键 / P1 重要 / P2 可选）
3 自动修复解析失败，验证发现命令（CDP/LLDP）
4 从 LLDP/CDP 邻居数据构建拓扑图
5 注册每日采集 cron 任务

先试运行

在不接触设备的情况下测试环境： 

olav --agent ops "/netops_init --dry-run"

第四步：发出第一个查询

olav "我的网络有多少台设备？"

olav "展示网络拓扑"

olav "所有 BGP 邻居都建立了吗？"

OLAV 从 DuckDB 快照数据库查询已采集的数据并返回结构化答案。查询不需要访问设备——所有数据来自快照。

下一步