← Back to Skills Marketplace
47
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install jf-open-pro-device-reboot
Description
杰峰设备重启技能（开发版）。支持远程重启设备，部分设备支持关闭操作。
README (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 |
签名/时间戳加密工具（复用） |
参考文档
Usage Guidance
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.
Capability Tags
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install jf-open-pro-device-reboot - After installation, invoke the skill by name or use
/jf-open-pro-device-reboot - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
jf-open-pro-device-reboot 1.0.0 初始版本
- 支持杰峰设备的远程重启功能，部分设备支持关闭操作
- 提供重启/关闭的 API 接口使用说明与环境变量配置需求
- 支持通过脚本一键重启或关闭设备，并可添加操作确认
- 列出接口返回码说明及常见注意事项
- 适配不同区域 API 入口地址
Metadata
Frequently Asked Questions
What is jf-open-pro-device-reboot?
杰峰设备重启技能（开发版）。支持远程重启设备，部分设备支持关闭操作。 It is an AI Agent Skill for Claude Code / OpenClaw, with 47 downloads so far.
How do I install jf-open-pro-device-reboot?
Run "/install jf-open-pro-device-reboot" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is jf-open-pro-device-reboot free?
Yes, jf-open-pro-device-reboot is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does jf-open-pro-device-reboot support?
jf-open-pro-device-reboot is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created jf-open-pro-device-reboot?
It is built and maintained by jftech (@jftech); the current version is v1.0.0.
More Skills