Skill: luckypig1209/zhihu-aiops (version 1.0.0)

--- 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: ```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 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: ```bash 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' ```


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (HIGH)