ClawHub

jf-open-pro-capture

API key required
Other

杰峰设备批量抓图技能（开发版）。支持多设备同时抓图，自动管理 Token，可选下载图片到本地。按调用次数计费。

Install

openclaw skills install jf-open-pro-capture

jf-open-pro-capture - 杰峰设备批量抓图技能（开发版）

技能描述

支持杰峰设备云抓图功能，适用于单设备或多设备批量抓图：

  • 批量抓图 - 支持多设备同时抓图
  • 自动 Token 管理 - 自动获取和管理 deviceToken
  • 本地下载 - 可选下载图片到本地存储
  • 多通道支持 - 支持多通道设备抓图
  • 图片类型 - 实时图/缩略图

计费说明： 按调用次数计费，详见 杰峰官网 - 云抓拍定价

触发词

  • 设备抓图 / 批量抓图 / 云抓图
  • 获取设备图片 / 抓图下载 / 实时抓图

前置条件

设备要求

  1. 设备在线 - 设备需在线且可访问
  2. 设备绑定 - 设备需先绑定到开放平台账号
  3. 辅码流 - 默认抓取辅码流（标清）
  4. 主码流 - 需联系销售定制固件

必需配置

  1. 签名算法 - 使用杰峰官方移位加密算法生成 signature
  2. 时间戳算法 - counter(7 位) + timeMillis(13 位)，实时生成
  3. 设备绑定 - 设备需先绑定到开放平台账号

环境变量

变量名说明默认值必需
JF_UUID开放平台用户 uuid-✅
JF_APP_KEY开放平台应用 appKey-✅
JF_APP_SECRET开放平台应用密钥-✅
JF_MOVE_CARD移动卡标识（用于签名）2✅
JF_DEVICE_SN设备序列号（单设备）-❌
JF_DEVICE_TOKEN设备接口访问令牌-❌
JF_DEVICE_USERNAME设备用户名admin❌
JF_DEVICE_PASSWORD设备密码-❌
JF_ENDPOINTAPI 接入地址api-cn.jftechws.com❌

API 接口

功能地址方法需要 Token需要在线
设备抓图POST /gwp/v3/rtc/device/capture/{token}POST✅✅
获取设备 TokenPOST /gwp/v3/rtc/device/tokenPOST✅❌

核心功能

1. 设备抓图（Capture）

API: POST /gwp/v3/rtc/device/capture/{deviceToken}

Name: OPSNAP

请求参数：

参数类型必需默认值说明
Namestring✅OPSNAP固定值
OPSNAP.Channelint❌0通道号（0=第一通道）
OPSNAP.PicTypeint❌0图片类型（0=实时图，1=缩略图）

响应参数：

字段类型说明
codeint平台状态码（2000=成功）
msgstring响应消息
dataobject响应数据
├─ Retint设备状态码（100=成功）
└─ imagestring图片地址 URL（有效期 24 小时）

2. 获取设备 Token（批量抓图必需）

API: POST /gwp/v3/rtc/device/token

请求参数：

参数类型必需说明
snsstring[]✅设备序列号列表（最多 500 个）
accessTokenstring❌用户 accessToken（可选）

响应参数：

字段类型说明
dataobject[]设备 Token 列表
├─ snstring设备序列号
└─ tokenstring设备接口访问令牌（有效期 24 小时）

使用示例

环境准备

# 设置环境变量（请替换为您的实际配置）
export JF_UUID="your-uuid"
export JF_APP_KEY="your-app-key"
export JF_APP_SECRET="your-app-secret"
export JF_MOVE_CARD="2"
export JF_DEVICE_SN="your-device-sn"
export JF_DEVICE_TOKEN="your-device-token"
export JF_DEVICE_USERNAME="admin"
export JF_DEVICE_PASSWORD="your-device-password"
export JF_ENDPOINT="api-cn.jftechws.com"

1. 单设备抓图（已有 Token）

cd ~/.openclaw/workspace/skills/developer/jf-open-pro-capture/scripts

# 抓取实时图（辅码流）
python3 capture.py --action capture \
  --device-sn "your-device-sn" \
  --device-token "your-device-token"

# 抓取缩略图
python3 capture.py --action capture --pic-type 1 \
  --device-sn "your-device-sn" \
  --device-token "your-device-token"

# 抓取第二通道
python3 capture.py --action capture --channel 1 \
  --device-sn "your-device-sn" \
  --device-token "your-device-token"

2. 单设备抓图（自动获取 Token）

# 自动获取 Token 并抓图
python3 capture.py --action capture-auto \
  --device-sn "your-device-sn" \
  --password "your-device-password"

3. 批量设备抓图

# 批量抓图（从文件读取设备列表）
python3 capture.py --action batch-capture \
  --devices-file "devices.txt" \
  --password "your-device-password"

# 批量抓图并下载
python3 capture.py --action batch-capture \
  --devices-file "devices.txt" \
  --password "your-device-password" \
  --download --output-dir "./captures"

4. 抓图并下载

# 抓图并下载到当前目录
python3 capture.py --action capture \
  --device-sn "your-device-sn" \
  --device-token "your-device-token" \
  --download

# 抓图并下载到指定目录
python3 capture.py --action capture \
  --device-sn "your-device-sn" \
  --device-token "your-device-token" \
  --download --output-dir "./captures"

5. 多通道设备抓图

# 抓取第一通道
python3 capture.py --action capture --channel 0 \
  --device-sn "your-device-sn" \
  --device-token "your-device-token"

# 抓取第二通道
python3 capture.py --action capture --channel 1 \
  --device-sn "your-device-sn" \
  --device-token "your-device-token"

6. JSON 格式输出（适合程序调用）

# 单设备抓图 - JSON 格式
python3 capture.py --action capture-auto \
  --device-sn "your-device-sn" \
  --password "your-device-password" \
  --json

# 输出：{"url": "https://..."}

# 批量抓图 - JSON 格式
python3 capture.py --action batch-capture \
  --devices-file "devices.txt" \
  --password "your-device-password" \
  --json

# 输出：{"total":3,"success":3,"failed":0,"results":[...]}

设备列表文件格式

# devices.txt - 设备列表文件
# 格式：设备序列号，设备名称（可选）
your-device-sn-01，大门摄像头
your-device-sn-02，后院摄像头
your-device-sn-03，客厅摄像头

请求参数说明

图片类型（PicType）

值类型说明
0实时图当前播放画面的截图（默认，辅码流）
1缩略图缩略图（较小尺寸）

通道号（Channel）

值说明
0第一通道（默认）
1第二通道
2+更多通道（NVR 设备）

状态码

平台状态码

code说明处理建议
2000成功-
28007Header 参数错误检查 uuid、appKey、timeMillis、signature
40103无效 TokendeviceToken 过期，重新获取
50000服务器内部错误联系杰峰技术支持

设备状态码（Ret）

Ret说明处理建议
100成功-
106用户名或密码错误检查设备凭证
503设备离线检查设备在线状态

注意事项

  1. 图片有效期 - 抓图 URL 有效期24 小时，过期自动清除
  2. 及时下载 - 建议及时下载到本地存储
  3. 计费说明 - 按调用次数计费，详见官网定价
  4. 默认辅码流 - 默认抓取辅码流（标清）
  5. 主码流 - 需联系销售定制固件
  6. Token 有效期 - deviceToken 有效期 24 小时
  7. 批量限制 - 单次最多 500 个设备
  8. 设备在线 - 设备需在线才能抓图成功

相关文件

文件说明
jf-open-pro-capture-skill.md技能文档
scripts/capture.pyPython 执行脚本
scripts/crypto.py签名/时间戳加密工具（复用）

参考文档