Imou Open Device Manage

该 Skill 通过 Imou/乐橙开放 API 管理云端设备：分页列出账号下设备（序列号、型号、在线/离线、名称、通道信息），按序列号查询一个或多个设备详情，并可修改设备名称或指定通道的名称。

imou-openplatform

热度 79.93

最近更新 2026-05-11 17:33:20

分类：自动化依赖：代码执行 / 第三方 API应用场景：自动化脚本 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add imou-device-manage

Metadata

name: imou-device-manage
description: Imou/乐橙设备管理。支持查看账号设备列表、设备详情（序列号/型号/在离线/名称/通道）、按序列号查询、修改设备或通道名称。 Use for requests in any language (e.g. 中文/English) about listing or managing Imou/乐橙 cloud devices. Use when: 我有哪些乐橙设备、乐橙设备列表、设备详情、修改设备或通道名称、query Imou devices、list Imou devices、get device by serial、rename device or channel.
metadata: {"openclaw":{"emoji":"📋","requires":{"env":["IMOU_APP_ID","IMOU_APP_SECRET"],"pip":["requests"]},"primaryEnv":"IMOU_APP_ID","install":[{"id":"python-requests","kind":"pip","package":"requests","label":"Install requests"}]}}

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.

Region	Data Center	Base URL
Mainland China	—	`https://openapi.lechange.cn`
Overseas	East Asia	`https://openapi-sg.easy4ip.com:443`
Overseas	Central Europe	`https://openapi-fk.easy4ip.com:443`
Overseas	Western America	`https://openapi-or.easy4ip.com:443`

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

List account devices: Paginated list of devices under the account (serial, model, online/offline, device name, channel list with channel ID and channel name).
Get device by serial: Query one or more devices by serial number(s), returns full device and channel details.
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

API	Doc
Dev spec	https://open.imou.com/document/pages/c20750/
Get accessToken	https://open.imou.com/document/pages/fef620/
List devices by page	https://open.imou.com/document/pages/683248/
Get device by IDs	https://open.imou.com/document/pages/320fb7/
Modify device/channel name	https://open.imou.com/document/pages/8ffaa3/

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

Data	Sent to	Purpose
appId, appSecret	Imou Open API	Obtain accessToken
accessToken, deviceId, etc.	Imou Open API	List/get device, modify name

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