← 返回 Skills 市场
ninebot-device-skill
作者
ninebot-app
· GitHub ↗
· v1.0.8
· MIT-0
896
总下载
5
收藏
2
当前安装
9
版本数
在 OpenClaw 中安装
/install ninebot-device-skill
功能描述
九号电动车(Ninebot)车辆信息查询,支持九号电动车、九号电动摩托车,提供车辆开关机状态、车辆充电状态、车辆位置、车辆剩余电量、车辆剩余里程、车辆剩余充电时间等数据的查询功能
安全使用建议
This skill appears to do what it claims: query Ninebot's Device Service using a single API key. Before installing/providing your key: (1) only provide the NINEBOT_DEVICESERVICE_KEY if you trust the publisher and you actually have a Ninebot/OpenClaw key; (2) prefer using an environment variable rather than storing the key in a plaintext config.json file in a shared folder; (3) review the base URL (https://cn-cbu-gateway.ninebot.com) and confirm it matches Ninebot's official API for your region; (4) be aware of a minor implementation bug: the script expects an API success code of 0 while the included API examples use 1, which may cause errors—consider reviewing the code if you encounter unexpected failures. If the skill asked for additional unrelated credentials, unknown download URLs, or network hosts other than the Ninebot gateway, treat it as suspicious.
功能分析
Type: OpenClaw Skill
Name: ninebot-device-skill
Version: 1.0.8
The skill is a legitimate tool for querying Ninebot vehicle information (status, location, battery) via the Ninebot API gateway (cn-cbu-gateway.ninebot.com). The Python script `scripts/ninebot_query.py` uses standard libraries to perform authenticated HTTP requests and contains no evidence of malicious execution, data exfiltration beyond the required API key, or obfuscation.
能力评估
Purpose & Capability
Name/description, required env var (NINEBOT_DEVICESERVICE_KEY), included script, and referenced API host (cn-cbu-gateway.ninebot.com) all align with a Ninebot vehicle-info query skill. There are no unrelated credentials, binaries, or services requested.
Instruction Scope
SKILL.md instructs the agent to prompt for an API key, read NINEBOT_DEVICESERVICE_KEY from env or config.json in the current working directory, and run scripts/ninebot_query.py. It also instructs editing references/api-spec.md and config.json to change mappings. These actions are within the stated scope but include saving the API key to a local plaintext config.json (a privacy/secret-storage concern). The instructions do not request other system files or unrelated data.
Install Mechanism
No install spec is provided (instruction-only with an included script). Nothing is downloaded or installed by the skill itself, so no high-risk install behavior is present.
Credentials
Only one credential is required: NINEBOT_DEVICESERVICE_KEY, which is the expected credential for this API. This is proportionate. Caveat: SKILL.md and the script recommend saving the API key in config.json (plaintext), which increases risk if that file is not protected.
Persistence & Privilege
always is false and the skill does not request persistent system privileges or modifications to other skills. It may write/expect a local config.json in the working directory (normal for this use case).
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install ninebot-device-skill - 安装完成后,直接呼叫该 Skill 的名称或使用
/ninebot-device-skill触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.8
Version 1.0.8 of ninebot-device-skill
v1.0.7
ninebot-device-skill 1.0.7 changelog:
- 增加错误码和消息处理,脚本返回401或智能服务费到期等错误时,明确给出固定回复文案和指引。
- 在查询流程中,细化了遇到错误时的用户提示与交互等待,提升用户体验。
- 修复人:叶汇龙。说明文档中补充了错误相关自动回复及处理流程说明,无功能变化。
v1.0.6
Version 1.0.6
- Added configuration sample (config.example.json), API documentation (references/api-spec.md), and query script (scripts/ninebot_query.py)
- Updated SKILL.md with setup instructions, environment variable requirements (NINEBOT_DEVICESERVICE_KEY), and detailed workflow for querying Ninebot vehicle information
- Removed redundant meta file (_meta.json)
- Improved clarity and documentation for first-time configuration and supported features
v1.0.5
- Updated the fixed response message to inform users that beta testing enrollment is underway and provide instructions for participation.
- Added _meta.json file.
v1.0.4
The skill now only provides a fixed message stating it will enter public beta on 2026.3.16.
v1.0.3
- Updated example output device name from "九号电动呢" to "九号电动E200P" and replaced the serial number in the JSON example with masked asterisks ("************").
- No functional or code changes detected; documentation only.
v1.0.2
- Version bumped to 1.0.2 with no code or documentation changes detected.
- No updates to functionality, APIs, workflow, or descriptive content.
v1.0.1
Version 1.0.1 of ninebot-device-skill
- No file changes detected.
- No updates or modifications in code or documentation.
v1.0.0
- Initial release of ninebot-device-skill: query Ninebot electric vehicle status via API.
- Supports user authentication, device listing, and fetching device status (battery, status, location).
- Provides a ready-to-run Python script for the complete workflow, including device selection.
- Configurable API mapping via JSON config or references/api-spec.md for easy adaptation to real endpoints.
- Outputs results as structured JSON for easy integration.
元数据
常见问题
ninebot-device-skill 是什么?
九号电动车(Ninebot)车辆信息查询,支持九号电动车、九号电动摩托车,提供车辆开关机状态、车辆充电状态、车辆位置、车辆剩余电量、车辆剩余里程、车辆剩余充电时间等数据的查询功能. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 896 次。
如何安装 ninebot-device-skill?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install ninebot-device-skill」即可一键安装,无需额外配置。
ninebot-device-skill 是免费的吗?
是的,ninebot-device-skill 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
ninebot-device-skill 支持哪些平台?
ninebot-device-skill 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 ninebot-device-skill?
由 ninebot-app(@ninebot-app)开发并维护,当前版本 v1.0.8。
推荐 Skills