Imou Device Manage

List and manage Imou cloud devices: view device serial, model, online/offline status, device name, and channel info (channel ID, channel name); get details by device ID; rename device or channel.

Quick Start

Install dependency:

pip install requests

Set environment variables (required):

export IMOU_APP_ID="your_app_id"
export IMOU_APP_SECRET="your_app_secret"
export IMOU_BASE_URL="your_base_url"

API Base URL (IMOU_BASE_URL) (required; no default—must be set explicitly):

• Mainland China: Register a developer account at open.imou.com and use the base URL below. Get appId and appSecret from App Information.
• Overseas: Register a developer account at open.imoulife.com and use the base URL for your data center (view in Console - Basic Information - My Information). Get appId and appSecret from App Information. See Development Specification.

Run:

# List all devices (paginated)
python3 {baseDir}/scripts/device_manage.py list

# List with page size and page number
python3 {baseDir}/scripts/device_manage.py list --page-size 20 --page 1

# Get details for specific device(s) by serial
python3 {baseDir}/scripts/device_manage.py get DEVICE_SERIAL1 [DEVICE_SERIAL2 ...]

# Rename device or channel
python3 {baseDir}/scripts/device_manage.py rename DEVICE_SERIAL "New Name" [--channel-id CHANNEL_ID]

Capabilities

1. List account devices: Paginated list of devices under the account (serial, model, online/offline, device name, channel list with channel ID and channel name).
2. Get device by serial: Query one or more devices by serial number(s), returns full device and channel details.
3. Rename device or channel: Set custom device name (or channel name when --channel-id is provided).

Request Header

All requests to Imou Open API include the header Client-Type: OpenClaw for platform identification.

API References

See references/imou-device-api.md for request/response formats.

Tips

• Token: Fetched automatically per run; valid 3 days. Do not cache across runs unless you implement expiry handling.
• Pagination: Use --page-size (1–50) and --page (from 1) for list.
• Rename: Omit --channel-id to set device name; for single-channel IPC, device name and channel name may be updated together per API behavior.

Data Outflow

All requests go to the configured IMOU_BASE_URL (Imou official API). No other third parties.