← Back to Skills Marketplace
ninebot-device-skill
by
ninebot-app
· GitHub ↗
· v1.0.8
· MIT-0
896
Downloads
5
Stars
2
Active Installs
9
Versions
Install in OpenClaw
/install ninebot-device-skill
Description
九号电动车(Ninebot)车辆信息查询，支持九号电动车、九号电动摩托车，提供车辆开关机状态、车辆充电状态、车辆位置、车辆剩余电量、车辆剩余里程、车辆剩余充电时间等数据的查询功能
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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).
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install ninebot-device-skill - After installation, invoke the skill by name or use
/ninebot-device-skill - Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Frequently Asked Questions
What is ninebot-device-skill?
九号电动车(Ninebot)车辆信息查询，支持九号电动车、九号电动摩托车，提供车辆开关机状态、车辆充电状态、车辆位置、车辆剩余电量、车辆剩余里程、车辆剩余充电时间等数据的查询功能. It is an AI Agent Skill for Claude Code / OpenClaw, with 896 downloads so far.
How do I install ninebot-device-skill?
Run "/install ninebot-device-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is ninebot-device-skill free?
Yes, ninebot-device-skill is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does ninebot-device-skill support?
ninebot-device-skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created ninebot-device-skill?
It is built and maintained by ninebot-app (@ninebot-app); the current version is v1.0.8.
More Skills