Zhihu Aiops

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.

luckypig1209@luckypig1209

Install

openclaw skills install @luckypig1209/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:

bash

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

Read the relevant reference file from references/ based on the user's goal.
Login to the Zhihu platform before calling protected platform APIs.
Send Authorization: Bearer <accessToken> with platform requests unless the target environment expects the raw token format.
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.
For SNMP/network/security/storage device metrics, use VictoriaMetrics snmp_* metrics collected by Categraf, not Zabbix.
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: