设备直播链接接口

POST /api/device/live 用于获取指定设备的 H5 播放器直播链接。接口会校验设备归属，然后返回可直接在浏览器中打开的播放器 URL。

⚠️ 展示规则（MUST 严格遵守）

脚本输出 JSON 格式的结构化数据，这是预期行为。以下展示规则是给 agent 的格式化指令：agent MUST 解析脚本输出的 JSON，按下述规则转换为用户友好的格式后再展示，MUST NOT 直接展示原始 JSON。

脚本输出中包含 _device_name 字段（设备名称），用于展示。

1. 当 code == 0 且 data 包含 live_url 时，MUST 使用 Markdown 链接格式：

📺 「客厅摄像机」的直播：

▶️ 点击打开直播播放器

关键规则：

• 从 _device_name 获取设备名称，用「设备名称」展示，而不是 MAC 地址
• 如果 _device_name 为空，则用去掉 xxxxS_ 前缀的 MAC 地址作为备选
• live_url MUST 用 Markdown 链接语法 [文字](url) 输出，MUST NOT 输出裸 URL 文本
• 链接文字用 ▶️ 点击打开直播播放器

2. 当 code != 0 时，回复："接口调用失败，错误码 {code}，原因：{message}"

前置依赖

脚本依赖 httpx。如果未安装，脚本会提示 python3 -m pip install httpx。

配置声明

本 skill 依赖以下配置项，agent 和用户 MUST 在运行前确认已正确配置。

必需配置

可选配置

Fallback 配置路径

脚本默认会读取 ~/.openclaw/.env 文件作为 fallback 配置源。该文件为所有 skill 共享，格式为 KEY=VALUE（每行一条）。生产环境 MUST 设置 AI_GATEWAY_NO_ENV_FILE=true 禁用此 fallback，改为通过环境变量直接传递所有配置。

安全注意事项

• 共享凭证文件 ~/.openclaw/.env 可被同一用户下所有 skill 读取。生产环境 MUST 通过环境变量传递 API_KEY，MUST NOT 依赖共享凭证文件
• TLS 证书验证默认启用，MUST NOT 在生产环境禁用（禁用会导致中间人攻击风险，攻击者可截获 API_KEY 和设备数据）
• 使用前 MUST 确认 AI_GATEWAY_HOST 指向可信域名
• MUST 使用最小权限的 API_KEY，避免复用高权限凭证。本 skill 仅需设备直播链接获取权限

网络访问声明

本 skill 仅访问以下端点（均为 AI_GATEWAY_HOST 下的路径）：

脚本不访问任何其他网络资源。

快速开始

python3 get_live_url.py --device-id "xxxxS_aabbccddeeff"

请求格式

请求体

响应格式

{
  "code": 0,
  "message": "success",
  "request_id": "\x3C32位请求追踪ID>",
  "data": {
    "live_url": "https://example.com/h5player/pro/autoPlay.html?..."
  },
  "_device_name": "客厅摄像机"
}

data 字段

错误码

注意事项

• device_id 不能为空，否则返回错误码 2001
• 设备不属于当前用户时会直接报错
• 建议每次播放前重新获取链接（token 有时效性）
• 全局请求超时为 120 秒