{"skill":{"slug":"hik-cloud-open-device-alarm-capability-management","displayName":"海康云眸设备告警能力管理","summary":"调用海康云眸开放平台设备报警能力管理接口，包括获取常规报警能力列表、修改报警能力状态和设置智能检测开关。用户提到报警能力、移动侦测、视频遮挡、区域入侵、智能检测开关等场景时使用。本技能自动处理 access_token 获取与刷新，不向用户暴露 token 调用流程。","description":"---\r\nname: hik-cloud-device-alarm-capability-management\r\ndescription: 调用海康云眸开放平台设备报警能力管理接口，包括获取常规报警能力列表、修改报警能力状态和设置智能检测开关。用户提到报警能力、移动侦测、视频遮挡、区域入侵、智能检测开关等场景时使用。本技能自动处理 access_token 获取与刷新，不向用户暴露 token 调用流程。\r\nmetadata: { \"openclaw\": { \"skillKey\": \"hik-cloud-device-alarm-capability-management\", \"emoji\": \"🚨\", \"primaryEnv\": \"HIK_OPEN_CLIENT_SECRET\", \"requires\": { \"bins\": [\"python3\"], \"env\": [\"HIK_OPEN_CLIENT_ID\", \"HIK_OPEN_CLIENT_SECRET\"] } } }\r\n---\r\n\r\n# 海康云眸设备报警能力管理\r\n\r\n## Overview\r\n\r\n按固定链路执行海康云眸开放平台设备报警能力管理类接口，优先使用 `{baseDir}/scripts/hik_open_device_alarm_capability_management.py`，不要临时手写认证、URL 拼接和重试逻辑。\r\n\r\n本技能只处理以下能力：\r\n\r\n- 获取设备常规报警能力列表\r\n- 修改报警能力状态\r\n- 设备智能检测开关状态\r\n\r\n本技能不对外暴露 “获取 access_token” 操作。鉴权属于内部基础设施：脚本会自动读取凭证、获取 token、缓存 token，并在 401 时自动刷新后重试一次。\r\n\r\n## OpenClaw 配置\r\n\r\n当 OpenClaw 通过 `~/.openclaw/openclaw.json` 管理本技能时，使用 `metadata.openclaw.skillKey` 作为配置键：\r\n\r\n```json5\r\n{\r\n  skills: {\r\n    entries: {\r\n      \"hik-cloud-device-alarm-capability-management\": {\r\n        enabled: true,\r\n        env: {\r\n          HIK_OPEN_CLIENT_ID: \"...\",\r\n          HIK_OPEN_CLIENT_SECRET: \"...\",\r\n          HIK_OPEN_BASE_URL: \"https://your-custom-base-url\"\r\n        }\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n若 Session 运行在 sandbox 中，宿主环境变量不会自动继承。此时应通过 OpenClaw 的 sandbox env 配置注入凭证，而不是依赖本机 shell 的 `process.env`。\r\n\r\n域名切换优先级：\r\n\r\n1. `--base-url`\r\n2. `HIK_OPEN_BASE_URL`\r\n3. 默认正式环境：`https://api2.hik-cloud.com`\r\n\r\n## 执行规则\r\n\r\n1. 认证固定使用 `Authorization: Bearer <access_token>`。\r\n2. token 来源优先级：\r\n   - `--access-token`\r\n   - `HIK_OPEN_ACCESS_TOKEN`\r\n   - token cache\r\n   - `HIK_OPEN_CLIENT_ID + HIK_OPEN_CLIENT_SECRET` 自动换取\r\n3. 域名来源优先级：\r\n   - `--base-url`\r\n   - `HIK_OPEN_BASE_URL`\r\n   - 默认正式环境 `https://api2.hik-cloud.com`\r\n4. 若业务接口返回 HTTP `401`，自动刷新 token 并重试一次。\r\n5. 若接口返回非成功状态，直接返回真实错误，不臆造结果。\r\n6. 报警能力状态修改使用 `channelId`，不是 `channelNo`。\r\n7. 智能检测开关接口仅适用于萤石设备。\r\n8. 用户若要求“展示 token / 返回 token 原文”，说明这不属于本技能的主要职责；仅在明确要求调试认证链路时再解释。\r\n\r\n## 快速开始\r\n\r\n先准备环境变量：\r\n\r\n```bash\r\nexport HIK_OPEN_CLIENT_ID=\"<YOUR_CLIENT_ID>\"\r\nexport HIK_OPEN_CLIENT_SECRET=\"<YOUR_CLIENT_SECRET>\"\r\n```\r\n\r\n查询报警能力列表：\r\n\r\n```bash\r\npython3 {baseDir}/scripts/hik_open_device_alarm_capability_management.py list \\\r\n  --device-serial 123456789\r\n```\r\n\r\n修改报警能力状态：\r\n\r\n```bash\r\npython3 {baseDir}/scripts/hik_open_device_alarm_capability_management.py update-status \\\r\n  --channel-id 4da6ac157d61421999b82d4aa6e1e64e \\\r\n  --ability-code 10600 \\\r\n  --status 1\r\n```\r\n\r\n设置智能检测开关：\r\n\r\n```bash\r\npython3 {baseDir}/scripts/hik_open_device_alarm_capability_management.py intelligence-switch \\\r\n  --device-serial 123456 \\\r\n  --enable 1 \\\r\n  --channel-no 1 \\\r\n  --type 302\r\n```\r\n\r\n## 子命令说明\r\n\r\n- `list`：获取设备常规报警能力列表\r\n- `update-status`：修改报警能力状态\r\n- `intelligence-switch`：设置设备智能检测开关\r\n\r\n返回结果重点：\r\n\r\n- `list` 重点看顶层 `code` / `message` 和 `data[].abilityCode` / `data[].status`\r\n- `update-status` 重点看 `channelId + abilityCode + status`，返回后看顶层 `code` / `message`\r\n- `intelligence-switch` 重点看 `deviceSerial + enable + type`，返回后看 `code` / `success`，`message` 为可选提示字段\r\n\r\n字段选择：\r\n\r\n- `abilityCode` 是常规报警能力编码，适用于 `list` / `update-status`\r\n- `status` 是常规报警能力状态，适用于 `list` / `update-status`\r\n- `type` 是智能检测开关类型，适用于 `intelligence-switch`\r\n- `abilityCode` 和 `type` 不能混用\r\n\r\n通用参数：\r\n\r\n- `--base-url`：显式指定接口域名，优先级高于环境变量\r\n- `--access-token`：显式指定 access token\r\n- `--timeout`：请求超时秒数，默认 `20`\r\n- `--token-cache-file`：token 缓存文件，默认 `~/.cache/hik_open/token.json`\r\n- `--format`：`text` 或 `json`\r\n\r\n通用环境变量：\r\n\r\n- `HIK_OPEN_CLIENT_ID`\r\n- `HIK_OPEN_CLIENT_SECRET`\r\n- `HIK_OPEN_ACCESS_TOKEN`\r\n- `HIK_OPEN_BASE_URL`\r\n\r\n## 输出约定\r\n\r\n- `--format text`：输出简要结果摘要和关键字段\r\n- `--format json`：输出结构化结果，包含请求上下文和原始响应数据\r\n\r\n## 资源说明\r\n\r\n- `{baseDir}/scripts/hik_open_device_alarm_capability_management.py`：主脚本，负责认证、缓存和报警能力接口调用\r\n- `{baseDir}/references/auth.md`：认证与 token 自动刷新规则\r\n- `{baseDir}/references/device-alarm-capability-management.md`：设备报警能力管理文档摘要\r\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":374,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1778140766705,"updatedAt":1778492867743},"latestVersion":{"version":"1.0.0","createdAt":1778140766705,"changelog":"Initial release: 设备告警能力查询、管理","license":"MIT-0"},"metadata":{"setup":[{"key":"HIK_OPEN_CLIENT_ID","required":true},{"key":"HIK_OPEN_CLIENT_SECRET","required":true}],"os":null,"systems":null},"owner":{"handle":"hik-cloud-open","userId":"s176q7t00k9tdn5af695hb4fq183ged9","displayName":"hik-cloud","image":"https://avatars.githubusercontent.com/u/269703506?v=4"},"moderation":null}