ClawHub

Zhihu Aiops

Other

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.

Install

openclaw skills install zhihu-aiops

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'