SkillHub

niu-vehicle

v0.1.0

Connect to NIU smart electric vehicles to retrieve real-time status - battery level, charging status, remaining charge time, location, and total mileage. Also answer questions like 'how much battery left?', 'is charging?', 'where is my scooter?', 'total km ridden?'.

Sourced from ClawHub, Authored by 蹬

Installation

Please help me install the skill `niu-vehicle` from SkillHub official store. npx skills add qdsang/niu-vehicle

NIU Scooter Status

Query your NIU electric scooter status - battery, charging, location, and mileage.

API Endpoint

curl -s "https://ai-mcp.niu.com/claw/scooter_info?key=$NIU_API_KEY"

Token Resolution

Ensure NIU_API_KEY is available. If empty, it will be read from config in order:

  1. Environment variable: $NIU_API_KEY
  2. Config file: ~/.openclaw/openclaw.json
  3. Config file: /data/.clawdbot/openclaw.json
export NIU_API_KEY=$(cat ~/.openclaw/openclaw.json 2>/dev/null | jq -r '.skills.entries["niu-vehicle"].apiKey // empty')

Response Fields

Field Type Description
batteryLevel number Battery percentage (0-100)
estimatedRange string Estimated remaining range (km)
isCharging boolean Whether currently charging
chargingRemainingTime number Remaining charge time (minutes)
location string Current scooter location address
totalMileage number Total distance ridden (km)
lastUpdate string Last update timestamp

Example Response

{
  "status": 0,
  "data": {
    "batteryLevel": 62,
    "estimatedRange": "55",
    "isCharging": true,
    "chargingRemainingTime": 216,
    "location": "XX市 XX楼",
    "totalMileage": 172,
    "lastUpdate": "2026-03-12 17:37:53"
  }
}

Error Handling

Error Description
HTTP 401/403 Authentication failed. Check your API key in the OpenClaw dashboard or config file.
HTTP 404 API endpoint not found. Check the API URL.
Timeout Request timed out. Try again later.

Get API Key

  1. Visit niu.com and log in
  2. Go to「My」→「API-Key Management」
  3. Create or copy your API key

Can Answer

  • 当前电量是多少？
  • 电动车还能跑多远？
  • 车在充电吗？还要充多久？
  • 车子现在在哪里？
  • 总共骑了多少公里？
  • 电池什么时候能充满？