← 返回 Skills 市场

🔌

jf-open-pro-device-status

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

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

cross-platform ⚠ suspicious

总下载

当前安装

版本数

在 OpenClaw 中安装

/install jf-open-pro-device-status

功能描述

杰峰设备在线状态查询技能（开发版）。专注于查询设备是否在线，支持单设备或批量查询，快速返回在线/离线状态。

使用说明 (SKILL.md)

jf-open-pro-device-status - 杰峰设备在线状态查询技能（开发版）

技能描述

专注于查询设备是否在线：

单设备查询 - 快速查询单个设备在线状态
批量查询 - 同时查询多个设备在线状态（最多 500 个）
简洁输出 - 只返回在线/离线状态，不做额外判断

特别说明： 设备与平台心跳交互，空闲时长超 250 秒即判定为离线。设备断电或断网后，最长 250 秒可查询到离线状态。

触发词

设备在线吗 / 查询设备状态 / 设备是否在线
批量查询在线 / 设备离线检测

前置条件

必需配置

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

环境变量

变量名	说明	默认值	必需
`JF_UUID`	开放平台用户 uuid	-	✅
`JF_APP_KEY`	开放平台应用 appKey	-	✅
`JF_APP_SECRET`	开放平台应用密钥	-	✅
`JF_MOVE_CARD`	移动卡标识（用于签名）	`2`	✅
`JF_ENDPOINT`	API 接入地址	`api-cn.jftechws.com`	❌

API 接口

功能	地址	方法
查询设备状态	`POST /gwp/v3/rtc/device/status`	POST

请求参数

参数	类型	必需	说明
deviceTokenList	string[]	✅	设备 Token 列表（最多 500 个）
region	string	❌	查询区域（`Global`=全球，`Local`=当前区域）

响应参数

字段	类型	说明
uuid	string	设备序列号
status	string	设备状态（`online`=在线，`notfound`=离线）
wakeUpStatus	string	低功耗设备唤醒状态（0=休眠，1=唤醒，2=准备休眠）
wakeUpEnable	string	是否支持远程唤醒（1=支持，0=需设备端唤醒）
wanIp	string	设备外网 IP

使用示例

环境准备

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

1. 查询单设备是否在线

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

# 查询单设备
python3 device_status.py --action query \
  --device-token "devicetokenxxxx"

2. 批量查询设备在线状态

# 从文件读取设备 Token 列表批量查询
python3 device_status.py --action batch-query \
  --tokens-file "tokens.txt"

3. 表格格式输出（推荐）

# 表格格式：显示设备状态和唤醒状态
python3 device_status.py --action query \
  --device-token "devicetokenxxxx" \
  --format table

4. 按区域查询

# 只查询当前区域设备
python3 device_status.py --action batch-query \
  --tokens-file "tokens.txt" \
  --region Local

设备 Token 列表文件格式

# tokens.txt - 设备 Token 列表文件
# 格式：每行一个设备 Token
NTQ0NzQ3YmE3MXwyYzFk...
NTQ0NzQ3YmE3MXw5NzRj...
NTQ0NzQ3YmE3MXxiMTFm...

状态码

code	说明	处理建议
2000	成功	-
28007	Header 参数错误	检查 uuid、appKey、timeMillis、signature
40103	无效 Token	deviceToken 过期，重新获取

注意事项

心跳判定 - 设备空闲超250 秒判定为离线
离线延迟 - 设备断电/断网后最长 250 秒可查询到离线状态
批量限制 - 单次最多查询 500 个设备
Token 有效期 - deviceToken 有效期 24 小时

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

参考文档

杰峰开放平台

安全使用建议

Install only if you trust the JFTech publisher and are comfortable sending device tokens and app credentials to the configured JF API endpoint. Treat the table output as sensitive because it may reveal external IP addresses; prefer simple or JSON output unless WAN IPs are needed, and keep credentials in a protected environment.

能力标签

crypto

能力评估

⚠ Purpose & Capability

The core device online/offline query is coherent, but the table output includes external WAN IPs despite the skill framing itself as concise online-status output.

⚠ Instruction Scope

Trigger phrases are broad everyday device-status phrases, which increases the chance of unintended invocation and remote status queries.

✓ Install Mechanism

The artifact is a small skill with Python scripts and no observed installer, background service, package-install command, or persistence mechanism.

⚠ Credentials

JF UUID, app key, app secret, device tokens, and returned metadata are used for remote API calls; this is mostly purpose-aligned but under-disclosed for sensitive operational data.

✓ Persistence & Privilege

No privilege escalation, credential-store harvesting, destructive action, scheduled task, daemon, or long-running worker behavior was found.

如何使用

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

版本历史

v1.0.0

- 初始版本发布，支持杰峰设备在线/离线状态查询。 - 支持单设备及批量（最多 500 台）状态查询。 - 简洁返回设备在线或离线状态，无附加处理。 - 提供多区域（中国、亚洲、欧洲、北美）API 接入点。 - 增加设备低功耗唤醒参数及远程唤醒能力查询。 - 附详细环境变量配置、API 参数说明和用法示例。

元数据

Slug jf-open-pro-device-status

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题