← Back to Skills Marketplace
284
Downloads
1
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install niu-vehicle
Description
Connect to NIU smart electric vehicles to retrieve real-time status - battery level, charging status, remaining charge time, location, and total mileage. Als...
Usage Guidance
This skill appears to do what it says (call NIU's scooter-status API using an API key), but the runtime instructions ask the agent to read local OpenClaw config files to fetch the key and use jq (not listed in metadata). Before installing: 1) Confirm the API endpoint host (ai-mcp.niu.com) is legitimate and that your NIU API key is intended for that endpoint. 2) If you don't want the agent reading ~/.openclaw/openclaw.json or /data/.clawdbot/openclaw.json, remove those files or ensure they don't contain other secrets, or supply NIU_API_KEY directly in the agent config. 3) Ensure jq is available or update the skill metadata to list it. 4) Limit the API key's scope and rotate it if you later remove the skill. If you need higher assurance, ask the publisher to declare the config paths and binaries explicitly or provide a version that only uses an explicitly supplied environment variable (no automatic file reads).
Capability Analysis
Type: OpenClaw Skill
Name: niu-vehicle
Version: 0.1.0
The skill is designed to retrieve NIU electric vehicle status (battery, location, mileage) from an official-looking API endpoint (ai-mcp.niu.com). It follows standard OpenClaw patterns for API key management and provides clear instructions for the agent to handle user queries without any evidence of malicious behavior or data exfiltration.
Capability Assessment
Purpose & Capability
The skill's purpose (fetching NIU scooter status) aligns with requiring an NIU_API_KEY and using curl to call an NIU endpoint. However, the SKILL.md instructs the agent to read local OpenClaw config files (~/.openclaw/openclaw.json and /data/.clawdbot/openclaw.json) to resolve the key even though 'required config paths' is declared as none. Also the example token-resolution command uses jq but jq is not listed in required binaries. These omissions are inconsistent with the declared metadata.
Instruction Scope
Instructions explicitly tell the agent to read local configuration files to obtain the API key and provide a shell pipeline that cats a JSON config and pipes it to jq. Reading user config files is beyond a minimal description of contacting the NIU API and is not declared up front. The only external network target is ai-mcp.niu.com (expected), but the file-read step increases the scope of data the agent touches.
Install Mechanism
This is an instruction-only skill with no install steps or code downloads, which is lowest-risk for on-disk persistence or arbitrary code execution.
Credentials
The skill declares a single primary credential (NIU_API_KEY), which is proportionate. However, the token-resolution command accesses user config files that may contain other credentials; even though the example extracts only the niu-vehicle entry via jq, the skill did not declare those config paths and did not list jq as a required binary. Reading agent config files is a higher-privilege action and should be explicitly declared.
Persistence & Privilege
The skill does not request always:true and is user-invocable; autonomous invocation is allowed (default) which is normal. Because the instructions include reading local config files, autonomous execution would let the skill access those paths without interactive confirmation — consider this when allowing autonomous invocation.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install niu-vehicle - After installation, invoke the skill by name or use
/niu-vehicle - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release of NIU smart electric vehicle status integration.
- Connects to NIU scooters to retrieve real-time status: battery level, charging, remaining charge time, location, and total mileage.
- Answers common user questions about scooter battery, charging, location, and mileage.
- Uses environment variable or config file to securely store and resolve NIU API keys.
- Provides clear instructions for setup, error handling, and example responses.
v1.0.0
- Initial release of the NIU Scooter Skill for checking NIU scooter status.
- Supports real-time queries for battery level, charging info, location, remaining and total mileage.
- Details how to obtain an API key and provides sample API usage and responses.
- Lists supported question types, such as battery status, range, charging state, location, and mileage.
Metadata
Frequently Asked Questions
What is Niu Vehicle?
Connect to NIU smart electric vehicles to retrieve real-time status - battery level, charging status, remaining charge time, location, and total mileage. Als... It is an AI Agent Skill for Claude Code / OpenClaw, with 284 downloads so far.
How do I install Niu Vehicle?
Run "/install niu-vehicle" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Niu Vehicle free?
Yes, Niu Vehicle is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Niu Vehicle support?
Niu Vehicle is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Niu Vehicle?
It is built and maintained by 蹬 (@qdsang); the current version is v0.1.0.
More Skills