ClawHub

jf-open-pro-device-reboot

API key required
Other

杰峰设备重启技能（开发版）。支持远程重启设备，部分设备支持关闭操作。

Install

openclaw skills install jf-open-pro-device-reboot

jf-open-pro-device-reboot - 杰峰设备重启技能（开发版）

技能描述

支持杰峰设备远程重启功能：

  • 设备重启 - 远程重启设备
  • 设备关闭 - 部分设备支持关闭操作（大部分设备为重启）

⚠️ 警告： 重启设备会导致设备暂时离线，请谨慎操作。

触发词

  • 重启设备 / 设备重启 / 远程重启
  • 关闭设备 / 设备关机

前置条件

必需配置

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

环境变量

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

API 接口

功能地址方法需要 Token需要在线
设备重启/关闭POST /gwp/v3/rtc/device/opdev/{token}POST✅✅

核心功能

设备重启/关闭（OPMachine）

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

Name: OPMachine

请求参数：

参数类型必需说明
Namestring✅固定为 OPMachine
OPMachine.Actionstring✅Reboot=重启，Shutdown=关闭

响应参数：

字段类型说明
codeint平台状态码（2000=成功）
msgstring响应消息
dataobject响应数据
├─ Namestring方法名称
├─ Retint设备状态码（100=成功）
└─ SessionIDstring会话 ID

使用示例

环境准备

# 设置环境变量（使用占位符，请替换为实际值）
export JF_UUID="uuidxxxx"
export JF_APP_KEY="appkeyxxxx"
export JF_APP_SECRET="appsecretxxxx"
export JF_MOVE_CARD="2"
export JF_DEVICE_SN="devicesnxxxx"
export JF_DEVICE_TOKEN="devicetokenxxxx"
export JF_ENDPOINT="api-cn.jftechws.com"

1. 重启设备

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

# 重启设备
python3 device_reboot.py --action reboot

2. 关闭设备（部分设备支持）

# 关闭设备
python3 device_reboot.py --action shutdown

3. 确认操作

# 带确认提示的重启
python3 device_reboot.py --action reboot --confirm

# 带确认提示的关闭
python3 device_reboot.py --action shutdown --confirm

状态码

平台状态码

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

设备状态码（Ret）

Ret说明
100成功

注意事项

  1. ⚠️ 谨慎操作 - 重启会导致设备暂时离线
  2. 设备在线 - 设备需在线才能执行重启
  3. 关闭支持 - 大部分设备只支持重启，不支持关闭
  4. Token 有效期 - deviceToken 有效期 24 小时
  5. 重启时间 - 设备重启通常需要 1-3 分钟
  6. 业务影响 - 重启期间无法进行任何设备操作

相关文件

文件说明
SKILL.md技能文档
scripts/device_reboot.pyPython 执行脚本
scripts/crypto.py签名/时间戳加密工具（复用）

参考文档