海康云眸设备分组管理

Overview

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

本技能只处理以下能力：

• - 新增组
• 删除组
• 更新组
• 查询单个组详情
• 查询所有组织
• 查询下级组
• 设备转移分组

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

OpenClaw 配置

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

CODEBLOCK0

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

域名切换优先级：

1. 1. INLINECODE4
2. INLINECODE5
3. 默认正式环境：INLINECODE6

执行规则

1. 1. 认证固定使用 Authorization: Bearer <access_token>。
2. token 来源优先级：

1. 3. 若业务接口返回 HTTP 401，自动刷新 token 并重试一次。
2. 若接口返回非成功状态，直接返回真实错误，不臆造结果。
3. 组详情和删除操作使用 groupNo；设备转组使用 targetGroupId，不要混用。
4. INLINECODE14 为空表示根组织；若用户未明确提供父组信息，不要擅自假设要挂到某个已有组织下。
5. 用户若要求“展示 token / 返回 token 原文”，说明这不属于本技能的主要职责；仅在明确要求调试认证链路时再解释。

快速开始

先准备环境变量：

CODEBLOCK1

新增组：

CODEBLOCK2

删除组：

CODEBLOCK3

更新组：

CODEBLOCK4

查询单个组：

CODEBLOCK5

查询所有组织：

CODEBLOCK6

查询下级组：

CODEBLOCK7

设备转移分组：

CODEBLOCK8

子命令说明

• - create：新增组
• INLINECODE16：删除组
• INLINECODE17：更新组名称
• INLINECODE18：查询单个组详情
• INLINECODE19：查询所有组织
• INLINECODE20：查询下级组
• INLINECODE21：将设备转移到目标组

通用参数：

• - --base-url：显式指定接口域名，优先级高于环境变量
• INLINECODE23：显式指定 access token
• INLINECODE24：请求超时秒数，默认 INLINECODE25
• INLINECODE26：token 缓存文件，默认 INLINECODE27
• INLINECODE28：text 或 INLINECODE30

通用环境变量：

• - INLINECODE31
• INLINECODE32
• INLINECODE33
• INLINECODE34

输出约定

• - --format text：输出简要结果摘要和关键字段
• INLINECODE36：输出结构化结果，包含请求上下文和原始响应数据

资源说明

• - {baseDir}/scripts/hik_open_device_group_management.py：主脚本，负责认证、缓存、组织接口调用
• INLINECODE38：认证与 token 自动刷新规则
• INLINECODE39：设备分组管理接口摘要