360 Secure SkillHub
360 安全技能中心

Zhihu Aiops

面向智护运维平台（Zhihu AIOps）的运维工作流与 API 参考集合，覆盖资产与资产模型查询、CMDB 发现、告警看板、VictoriaMetrics 与 Categraf SNMP 指标查询、纳管资产巡检报告生成，以及连通性检测后新增操作系统监控资产；当前版本仅为文档与参考步骤，未附带可执行脚本。

luckypig1209
luckypig1209
热度 23.51
最近更新 2026-05-28 09:06:25
分类：数据依赖：第三方 API / 代码执行应用场景：API 集成 / 数据处理 / 报告撰写 / DevOps

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add zhihu-aiops
Metadata
name
zhihu-aiops
description
Use this skill when working with the Zhihu AIOps / 智护运维平台, including asset management, CMDB discovery, monitoring, alarm dashboards, Categraf SNMP metrics in VictoriaMetrics, managed asset inspection reports, and adding OS monitoring assets. This first release provides reference-guided workflows and API documentation; executable CLI helpers will be added in a later version.
version
1.0.0
metadata
{"openclaw":{"requires":{"env":["ZHIHU_API_URL","ZHIHU_USER","ZHIHU_PASSWORD","VM_URL"],"bins":["curl","python3"]},"primaryEnv":"ZHIHU_API_URL"}}

Zhihu AIOps Skill

This skill provides workflows and API references for the 智护运维平台 / Zhihu AIOps platform.

Use it for:

  • Querying platform assets, asset models, asset types, and managed devices.
  • Creating operating-system monitoring assets after connectivity checks.
  • Querying dashboard and alarm summaries.
  • Working with CMDB / asset discovery scan tasks and scan results.
  • Querying VictoriaMetrics and Categraf SNMP snmp_* metrics.
  • Generating managed asset inspection reports.

Configuration

Set these environment variables before calling platform APIs:

export ZHIHU_API_URL="http://zhihu-server:48080/admin-api"
export ZHIHU_USER="admin"
export ZHIHU_PASSWORD="your-password"
export VM_URL="http://zhihu-metric:9090"

Do not hard-code customer IPs, test-environment URLs, usernames, passwords, or API keys into prompts or generated scripts. Prefer environment variables.

Core Workflow

  1. Read the relevant reference file from references/ based on the user's goal.
  2. Login to the Zhihu platform before calling protected platform APIs.
  3. Send Authorization: Bearer <accessToken> with platform requests unless the target environment expects the raw token format.
  4. For managed assets, query asset models first when the model ID is unknown, then call /cqt/asset-info/page with the correct modelId and modelCode.
  5. For SNMP/network/security/storage device metrics, use VictoriaMetrics snmp_* metrics collected by Categraf, not Zabbix.
  6. For inspection reports, combine platform managed asset data with VictoriaMetrics/SNMP data only when realtime metric status is requested.

Reference Map

  • Asset center APIs: references/api_asset.md
  • CMDB discovery APIs: references/api_cmdb.md
  • Dashboard and alarm summary APIs: references/api_dashboard.md
  • Monitor center APIs: references/api_monitor.md
  • VictoriaMetrics APIs: references/api_victoriametrics.md
  • Categraf SNMP metrics: references/api_snmp_metrics.md
  • Add OS monitoring workflow: references/add-os-monitor.md
  • Managed asset inspection workflow: references/inspection-run.md

Common Tasks

Query Managed Assets

Read references/api_asset.md. If the user asks for concrete assets rather than model definitions, use /cqt/asset-info/page. For known managed inspection models, use the model information in references/inspection-run.md.

Generate Managed Asset Inspection Report

Read references/inspection-run.md, then query these categories as needed:

  • Security device: modelId=254, modelCode=securitydevice
  • Network device: modelId=185, modelCode=networkdevice
  • Terminal device: modelId=260, modelCode=terminaldevice
  • Storage device: modelId=261, modelCode=storagedevice
  • Database: modelId=183, modelCode=storagebase
  • Operating system: modelId=195, modelCode=operatesystem

Query SNMP Metrics

Read references/api_snmp_metrics.md. Use VM_URL and VictoriaMetrics APIs:

  • /api/v1/series for metric discovery.
  • /api/v1/query for instant queries.
  • /api/v1/query_range for trends.

Prefer snmp_* metrics for network devices, security devices, storage devices, switches, routers, firewalls, and other SNMP-managed assets.

Add OS Monitoring

Read references/add-os-monitor.md. Required user inputs are target IP, port, username, password, and monitor name. Login first, resolve the operating-system model/items dynamically, test connectivity, then create the asset.

Current Limitations

This first ClawHub package is documentation-first and registration-ready. It does not yet include a production CLI wrapper. When deterministic execution is required, implement scripts in scripts/ in the next phase, for example:

python3 scripts/zhihu_cli.py login
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 snmp-discover
python3 scripts/zhihu_cli.py vm-query --query 'up'