智护 AIOps Skill - 智护运维平台智能运维集成#

当前版本: v1.0.1 | 最后更新: 2026-05-28 | 状态: 文档型 Skill，可注册安装，脚本执行能力将在下一阶段补充

智护 AIOps Skill 面向智护运维平台的智能问答、数字员工和 AIOps 场景，提供资产、监控、告警、CMDB 发现、纳管设备巡检、VictoriaMetrics 查询和 Categraf SNMP 指标查询的统一参考文档与操作流程。

本 Skill 适合用于：

• 查询智护平台资产中心数据，包括资产类型、资产模型、资产列表和纳管设备。
• 生成纳管设备巡检报告，覆盖安全设备、网络设备、终端设备、存储设备、数据库和操作系统。
• 查询展示中心和监控中心告警数据，包括告警总览、告警 TOP、告警列表和告警趋势。
• 查询 CMDB / 资产发现任务、扫描记录、扫描资产和 IP 使用率。
• 查询 VictoriaMetrics 中由 Categraf 写入的主机指标和 snmp_* SNMP 设备指标。
• 指导新增操作系统监控资产，包括登录、模型字段解析、连通性测试和资产创建。

配置#

使用前请配置智护平台和 VictoriaMetrics 连接信息：

bash

# 智护平台 API 地址，通常为当前部署环境内的后端服务地址
export ZHIHU_API_URL="http://zhihu-server:48080/admin-api"

# 智护平台登录账号
export ZHIHU_USER="admin"
export ZHIHU_PASSWORD="your-password"

# VictoriaMetrics 地址，Categraf 主机指标和 SNMP 指标统一写入该时序库
export VM_URL="http://zhihu-metric:9090"

不要在 Skill、脚本、提示词或文档中写死客户真实 IP、生产账号、生产密码或 API Key。跨环境部署时优先使用环境变量。

平台架构#

text

用户 / AI Agent
  |
  | 自然语言问题
  v
OpenClaw / ClawHub Skill
  |
  | 读取 SKILL.md 和 references/*.md
  v
智护平台 API
  |-- 资产中心: /cqt/asset-type、/cqt/asset-model、/cqt/asset-info
  |-- 监控中心: /monitor/*
  |-- 展示中心: /dashboard/*
  |-- CMDB 发现: /cmdb/*
  |
  v
智护数据

VictoriaMetrics
  ^
  |
Categraf
  |-- 主机 CPU / 内存 / 磁盘 / 网络指标
  |-- SNMP 网络设备 / 安全设备 / 存储设备指标，指标名前缀为 snmp_*

在智护当前架构中，网络设备、安全设备、存储设备等 SNMP 纳管设备不再依赖 Zabbix 查询，统一通过 Categraf 采集并写入 VictoriaMetrics。涉及交换机、路由器、防火墙、安全设备、存储设备、接口流量、SNMP 可达性时，应优先查询 snmp_* 指标。

API 基础信息#

• Base URL: ${ZHIHU_API_URL:-http://zhihu-server:48080/admin-api}
• 请求方法: 以 POST 为主，部分接口支持 GET
• Content-Type: application/json
• 认证方式: 登录接口获取 Bearer Token
• 时序库: ${VM_URL:-http://zhihu-metric:9090}
• 时序查询协议: Prometheus / VictoriaMetrics 兼容 API

认证方式#

智护平台 API 使用登录接口获取访问令牌：

bash

curl -sS -X POST "${ZHIHU_API_URL}/system/auth/login" \
  -H "Content-Type: application/json" \
  --data '{
    "username": "'"${ZHIHU_USER}"'",
    "password": "'"${ZHIHU_PASSWORD}"'",
    "captchaVerification": ""
  }'

响应示例：

json

{
  "code": 0,
  "data": {
    "accessToken": "token-value",
    "refreshToken": "refresh-token-value",
    "expiresTime": "2026-05-28 18:00:00"
  },
  "msg": ""
}

后续请求添加认证头：

bash

-H "Authorization: Bearer ${TOKEN}"

如果目标环境使用的是裸 token 格式，请按实际环境调整，但默认建议使用 Bearer Token。

返回格式#

智护平台接口通常返回：

json

{
  "code": 0,
  "data": {},
  "msg": ""
}

字段说明：

• code: 状态码， 0 通常表示成功。
• data: 业务数据。
• msg: 错误或提示信息。

VictoriaMetrics 接口通常返回：

json

{
  "status": "success",
  "data": {
    "resultType": "vector",
    "result": []
  }
}

API 模块索引#

1. 资产中心 Asset#

资产中心用于查询和维护资产类型、资产模型和资产实例。

能力接口说明资产类型列表/cqt/asset-type/page查询硬件资产、软件资产等资产分类资产模型列表/cqt/asset-model/page查询网络设备、数据库、操作系统等模型定义资产信息列表/cqt/asset-info/page查询具体资产实例，通常需要传入 modelId资产信息创建/cqt/asset-info/create创建资产实例资产信息更新/cqt/asset-info/update更新资产信息资产信息删除/cqt/asset-info/delete删除资产

详细参数见： references/api_asset.md

2. 纳管设备智能巡检#

智能巡检用于按模型查询智护平台当前纳管设备，并输出巡检报告。

常用模型：

类型modelIdmodelCode说明安全设备254``securitydevice防火墙、安全网关等网络设备185``networkdevice交换机、路由器等终端设备260``terminaldevice摄像头、终端等存储设备261``storagedevice存储类硬件数据库183``storagebaseOracle、MySQL、Redis 等操作系统195``operatesystemLinux、Windows 主机

巡检基础请求体示例：

json

{
  "pageNo": 1,
  "pageSize": 10,
  "isManaged": null,
  "modelId": 185,
  "conditions": [],
  "status": 1,
  "modelCode": "networkdevice",
  "isMonitorAble": true,
  "groupIdList": []
}

详细流程见： references/inspection-run.md

3. 监控中心 Monitor#

监控中心用于查询告警规则、告警概览、拨测任务和监控记录。

能力接口说明告警规则列表/monitor/alarm-rules-case/page查询告警规则告警规则状态修改/monitor/alarm-rules-case/modify-status启用或禁用规则告警等级分布/monitor/alarms/overview/priority按告警等级统计告警恢复统计/monitor/alarms/overview/resolved查看恢复趋势告警分布/monitor/alarms/overview/distribution按资产类型统计告警趋势/monitor/alarms/overview/trend查询时间趋势拨测任务列表/monitor/dialing-test-task/page查询拨测任务

详细参数见： references/api_monitor.md

4. 展示中心 Dashboard#

展示中心用于查询大屏、首页和告警统计数据。

能力接口说明告警统计/dashboard/alarms/summary告警总数、未恢复、已恢复、等级分组告警 TOP/dashboard/alarms/summary/top告警次数最多的项目告警列表/dashboard/alarms/list分页查询告警记录资产分布/dashboard/asset-monitor/summary资产模型分布统计资源告警/dashboard/asset-alarms/summary各资产类型告警数量性能 TOP/dashboard/asset-metric/summary/topCPU、内存、磁盘使用率 TOP

详细参数见： references/api_dashboard.md

5. CMDB / 资产发现#

CMDB 模块用于扫描任务、扫描记录和扫描资产查询。

能力接口说明扫描任务列表/cmdb/scan-task/page查询资产发现任务扫描任务创建/cmdb/scan-task/create创建扫描任务扫描任务更新/cmdb/scan-task/update更新扫描任务扫描任务删除/cmdb/scan-task/delete删除扫描任务扫描任务重启/cmdb/scan-task/restart重新执行扫描扫描记录列表/cmdb/scan-record/page查询扫描历史扫描资产列表/cmdb/scan-record/asset/page查询发现的资产IP 使用率/cmdb/scan-record/asset/ip-usage统计 IP 使用情况

详细参数见： references/api_cmdb.md

6. VictoriaMetrics#

VictoriaMetrics 提供主机指标和 SNMP 指标查询能力。

接口说明/api/v1/query即时查询/api/v1/query_range范围查询/api/v1/series序列发现，适合发现 snmp_* 指标/api/v1/label/__name__/values查询指标名称/api/v1/label/{label}/values查询标签值

详细参数见： references/api_victoriametrics.md

7. Categraf SNMP 指标#

SNMP 设备指标统一使用 snmp_* 前缀。

常见查询：

promql

# 发现 SNMP 指标序列
{__name__=~"snmp_.*"}

# 查询指定设备 SNMP 可达性，具体指标名以采集模板为准
snmp_up{host_ip="10.0.0.5"}

# 查询接口入方向流量，换算为 bits/s
rate(snmp_ifHCInOctets{host_ip="10.0.0.5"}[5m]) * 8

# 查询接口出方向流量，换算为 bits/s
rate(snmp_ifHCOutOctets{host_ip="10.0.0.5"}[5m]) * 8

详细说明见： references/api_snmp_metrics.md

8. 操作系统监控添加#

当用户要求添加 Linux / Windows 主机监控时，需要收集以下信息：

参数说明示例monitorIp目标主机 IP192.0.2.10``monitorPortSSH 或 WinRM 端口22 / 5985``userName登录用户名root / Administrator``password登录密码your-password``name监控名称web-server-01

执行流程：

1. 登录智护平台获取 Token。
2. 查询操作系统资产模型和字段映射。
3. 调用连通性测试接口。
4. 连通成功后创建操作系统资产。
5. 返回创建结果和后续监控建议。

详细流程见： references/add-os-monitor.md

使用示例#

查询告警统计#

bash

TOKEN=$(curl -sS -X POST "${ZHIHU_API_URL}/system/auth/login" \
  -H "Content-Type: application/json" \
  --data '{"username":"'"${ZHIHU_USER}"'","password":"'"${ZHIHU_PASSWORD}"'","captchaVerification":""}' \
  | python3 -c 'import sys,json; print((json.load(sys.stdin).get("data") or {}).get("accessToken", ""))')

curl -sS -X POST "${ZHIHU_API_URL}/dashboard/alarms/summary" \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "Content-Type: application/json" \
  --data '{}'

查询网络设备资产#

bash

curl -sS -X POST "${ZHIHU_API_URL}/cqt/asset-info/page" \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "Content-Type: application/json" \
  --data '{
    "pageNo": 1,
    "pageSize": 10,
    "isManaged": null,
    "modelId": 185,
    "conditions": [],
    "status": 1,
    "modelCode": "networkdevice",
    "isMonitorAble": true,
    "groupIdList": []
  }'

查询 SNMP 指标序列#

bash

curl -sS "${VM_URL}/api/v1/series?match%5B%5D=%7B__name__%3D~%5C%22snmp_.*%5C%22%7D"

查询任意 PromQL#

bash

curl -sG "${VM_URL}/api/v1/query" \
  --data-urlencode 'query=up'

参考文档#

核心 API#

• references/api_asset.md - 资产中心 API 详细参数
• references/api_cmdb.md - CMDB / 资产发现 API 详细参数
• references/api_dashboard.md - 展示中心 API 详细参数
• references/api_monitor.md - 监控中心 API 详细参数

指标与巡检#

• references/api_victoriametrics.md - VictoriaMetrics API 参考
• references/api_snmp_metrics.md - Categraf SNMP 指标查询参考
• references/inspection-run.md - 纳管设备智能巡检工作流
• references/add-os-monitor.md - 新增操作系统监控工作流

注意事项#

1. 认证 Token: 智护平台 Token 有有效期，执行任务前建议重新登录获取。
2. 资产查询: 资产实例查询优先使用 /cqt/asset-info/page，但通常需要先知道 modelId。
3. 模型与资产不同: 资产模型是字段定义，资产信息才是具体设备或实例。
4. SNMP 架构: 当前 SNMP 设备指标统一通过 Categraf 写入 VictoriaMetrics，不再使用 Zabbix 查询链路。
5. 环境变量: 不要把测试环境 IP、账号、密码写进 Skill，统一使用 ZHIHU_API_URL、 ZHIHU_USER、 ZHIHU_PASSWORD、 VM_URL。
6. 安全边界: 该 Skill 会指导访问用户配置的智护平台和 VictoriaMetrics 地址，不应访问无关外部系统。
7. 第一阶段限制: 当前版本是文档型 Skill，能提供 API 参考和工作流指导；确定性 CLI 工具将在后续版本补充。

后续规划#

下一阶段计划增加 scripts/zhihu_cli.py，提供可直接执行的命令：

bash

python3 scripts/zhihu_cli.py login
python3 scripts/zhihu_cli.py alarm-summary
python3 scripts/zhihu_cli.py asset-page --model-code networkdevice
python3 scripts/zhihu_cli.py inspect-managed-assets --scope all
python3 scripts/zhihu_cli.py vm-query --query 'up'
python3 scripts/zhihu_cli.py snmp-discover
python3 scripts/zhihu_cli.py add-os-monitor --ip 192.0.2.10 --port 22 --username root --password your-password --name web-server-01

版本历史#

• v1.0.1 (2026-05-28): 改为中文主页文档，补充智护架构、模块索引、使用示例、巡检模型、SNMP/VictoriaMetrics 说明。
• v1.0.0 (2026-05-28): 初始 ClawHub 注册版本，整理 SKILL.md 和 references/。