📦 海康云眸设备通道管理

海康云眸设备通道管理 Overview

按固定链路执行海康云眸开放平台设备通道管理接口，优先使用 {baseDir}/scripts/hik_open_device_channel_management.py，不要临时手写认证、URL 拼接和重试逻辑。

本技能只处理以下能力：

查询设备下通道列表 同步设备下通道 修改通道名称 同步设备通道名称

本技能不对外暴露 “获取 访问_令牌” 操作。鉴权属于内部基础设施：脚本会自动读取凭证、获取 令牌、缓存 令牌，并在 401 时自动刷新后重试一次。

OpenClaw 配置

当 OpenClaw 通过 ~/.OpenClaw/OpenClaw.json 管理本技能时，使用 metadata.OpenClaw.技能Key 作为配置键：

{ 技能s: { entries: { "hik-cloud-device-channel-management": { enabled: true, env: { HIK_OPEN_命令行工具ENT_ID: "...", HIK_OPEN_命令行工具ENT_SECRET: "...", HIK_OPEN_BASE_URL: "https://your-custom-base-url" } } } } }

若 会话 运行在 sandbox 中，宿主环境变量不会自动继承。此时应通过 OpenClaw 的 sandbox env 配置注入凭证，而不是依赖本机 shell 的 process.env。

域名切换优先级：

--base-url HIK_OPEN_BASE_URL 默认正式环境：https://API2.hik-cloud.com 执行规则 认证固定使用 Authorization: Bearer <访问_令牌>。 令牌 来源优先级： --访问-令牌 HIK_OPEN_访问_令牌 令牌 缓存 HIK_OPEN_命令行工具ENT_ID + HIK_OPEN_命令行工具ENT_SECRET 自动换取 域名来源优先级： --base-url HIK_OPEN_BASE_URL 默认正式环境 https://API2.hik-cloud.com 若业务接口返回 HTTP 401，自动刷新 令牌 并重试一次。 若接口返回非成功状态，直接返回真实错误，不臆造结果。 修改通道名称时，若 --同步-local 1，设备需在线才能同步成功。 通道列表中的 channel状态=-1 一般表示该通道未关联设备。 用户若要求“展示 令牌 / 返回 令牌 原文”，说明这不属于本技能的主要职责；仅在明确要求调试认证链路时再解释。 快速开始

先准备环境变量：

导出 HIK_OPEN_命令行工具ENT_ID="" 导出 HIK_OPEN_命令行工具ENT_SECRET=""

查询设备下通道列表：

python3 {baseDir}/scripts/hik_open_device_channel_management.py 列出 \ --device-serial E05426006 \ --page-no 1 \ --page-size 50

同步设备下通道：

python3 {baseDir}/scripts/hik_open_device_channel_management.py 同步 \ --device-serial E05426006

修改通道名称：

python3 {baseDir}/scripts/hik_open_device_channel_management.py rename \ --device-serial D20591677 \ --channel-no 1 \ --channel-name "修改xxx" \ --同步-local 0

同步设备通道名称：

python3 {baseDir}/scripts/hik_open_device_channel_management.py 同步-names \ --device-serial E05426006

子命令说明 列出：查询设备下通道列表 同步：同步设备下通道 rename：修改通道名称 同步-names：同步设备通道名称

字段提示：

channelType = 通道类型，重点看 列出 返回里的 channelType，常见值是 10300 视频通道、10302 报警输入 channel状态 = 通道状态，重点看 列出 返回里的 channel状态，0 离线、1 在线、-1 未上报/未关联设备 同步Local = 是否同步到设备本地，重点看 rename 请求里的 同步Local，0 不同步、1 同步到本地；channelName 普通情况下最多 50 个字符，同步Local=1 时最多 32 个字符，且 同步Local=1 时设备需在线

通用参数：

--base-url：显式指定接口域名，优先级高于环境变量 --访问-令牌：显式指定 访问 令牌 --timeout：请求超时秒数，默认 20 --令牌-缓存-file：令牌 缓存文件，默认 ~/.缓存/hik_open/令牌.json --格式化：text 或 json

通用环境变量：

HIK_OPEN_命令行工具ENT_ID HIK_OPEN_命令行工具ENT_SECRET HIK_OPEN_访问_令牌 HIK_OPEN_BASE_URL 输出约定 --格式化 text：输出简要结果摘要和关键字段 --格式化 json：输出结构化结果，包含请求上下文和原始响应数据 资源说明 {baseDir}/scripts/hik_open_device_channel_management.py：主脚本，负责认证、缓存和设备通道接口调用 {baseDir}/references/auth.md：认证与 令牌 自动刷新规则 {baseDir}/references/device-channel-management.md：设备通道管理接口摘要