← 返回 Skills 市场

🔌

jf-open-pro-device-reboot

Name: jf-open-pro-device-reboot
Author: jftech

作者 jftech · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ⚠ suspicious

总下载

当前安装

版本数

在 OpenClaw 中安装

/install jf-open-pro-device-reboot

功能描述

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

使用说明 (SKILL.md)

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

技能描述

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

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

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

触发词

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

前置条件

必需配置

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

环境变量

变量名	说明	默认值	必需
`JF_UUID`	开放平台用户 uuid	-	✅
`JF_APP_KEY`	开放平台应用 appKey	-	✅
`JF_APP_SECRET`	开放平台应用密钥	-	✅
`JF_MOVE_CARD`	移动卡标识（用于签名）	`2`	✅
`JF_DEVICE_SN`	设备序列号	-	✅
`JF_DEVICE_TOKEN`	设备接口访问令牌	-	✅
`JF_ENDPOINT`	API 接入地址	`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

请求参数：

参数	类型	必需	说明
Name	string	✅	固定为 `OPMachine`
OPMachine.Action	string	✅	`Reboot`=重启，`Shutdown`=关闭

响应参数：

字段	类型	说明
code	int	平台状态码（2000=成功）
msg	string	响应消息
data	object	响应数据
├─ Name	string	方法名称
├─ Ret	int	设备状态码（100=成功）
└─ SessionID	string	会话 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	成功	-
28007	Header 参数错误	检查 uuid、appKey、timeMillis、signature
40103	无效 Token	deviceToken 过期，重新获取
50000	服务器内部错误	联系杰峰技术支持

设备状态码（Ret）

Ret	说明
100	成功

注意事项

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

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

参考文档

杰峰开放平台

安全使用建议

Install only if you trust the publisher and understand that running the script can take a device offline immediately. Set JF_ENDPOINT only to an official JF regional host, protect the JF_* secrets, and prefer using --confirm until the skill adds default confirmation and endpoint allowlisting.

能力标签

crypto

能力评估

ℹ Purpose & Capability

The stated purpose, remote reboot/shutdown of JF devices, matches the included script and documentation.

⚠ Instruction Scope

Reboot and shutdown are high-impact operations, and the script only asks for confirmation when --confirm is supplied rather than requiring confirmation by default.

✓ Install Mechanism

The artifact contains a skill document and two Python scripts; no hidden installer, package install, or automatic execution path was found.

⚠ Credentials

The skill requires sensitive JF account and device tokens in environment variables and uses JF_ENDPOINT directly to build the request host, so a bad or influenced endpoint could receive authentication material.

✓ Persistence & Privilege

No persistence, background worker, privilege escalation, local indexing, or broad filesystem access was found.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install jf-open-pro-device-reboot
安装完成后，直接呼叫该 Skill 的名称或使用 /jf-open-pro-device-reboot 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

jf-open-pro-device-reboot 1.0.0 初始版本 - 支持杰峰设备的远程重启功能，部分设备支持关闭操作 - 提供重启/关闭的 API 接口使用说明与环境变量配置需求 - 支持通过脚本一键重启或关闭设备，并可添加操作确认 - 列出接口返回码说明及常见注意事项 - 适配不同区域 API 入口地址

元数据

Slug jf-open-pro-device-reboot

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题