Niu Vehicle

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?'.

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

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