← Back to Skills Marketplace
Imou Open Device Manage
by
Imou-OpenPlatform
· GitHub ↗
· v1.0.1
· MIT-0
169
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install imou-device-manage
Description
Imou/乐橙设备管理。支持查看账号设备列表、设备详情（序列号/型号/在离线/名称/通道）、按序列号查询、修改设备或通道名称。 Use for requests in any language (e.g. 中文/English) about listing or managing Imou/乐橙 cloud de...
README (SKILL.md)
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
appIdandappSecretfrom 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
appIdandappSecretfrom 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-idis 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) forlist. - Rename: Omit
--channel-idto 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.
Usage Guidance
This skill appears coherent and implements exactly what it claims: it exchanges your IMOU_APP_ID and IMOU_APP_SECRET for an Imou access token and calls Imou endpoints to list/get/rename devices. Before installing: (1) ensure you trust the skill source — it will transmit your appId/appSecret to whatever IMOU_BASE_URL is configured; (2) prefer using a limited or test developer app credential rather than reusing high-privilege credentials; (3) confirm or set IMOU_BASE_URL to the official Imou API endpoint (the code defaults to https://openapi.lechange.cn); (4) note the small manifest inconsistencies (IMOU_BASE_URL is used but not declared in registry env list, and SKILL.md lists a pip install even though registry shows no install spec) — these are implementation/metadata issues rather than security red flags. If you need higher assurance, review the included Python files locally to verify there are no modifications to endpoints or hidden network calls before providing credentials.
Capability Analysis
Type: OpenClaw Skill
Name: imou-device-manage
Version: 1.0.1
The skill is a legitimate implementation of a client for the Imou/Lechange Open API, allowing users to list and manage cloud IoT devices. It correctly handles authentication by generating access tokens using the required APP_ID and APP_SECRET via environment variables and implements standard API signing logic (MD5). All network activity is directed to the official Imou API endpoints (e.g., openapi.lechange.cn) or a user-defined base URL, with no evidence of data exfiltration to unauthorized third parties or malicious execution patterns in scripts/device_manage.py or scripts/imou_client.py.
Capability Assessment
Purpose & Capability
Name/description describe Imou device listing and rename operations and the package only requires IMOU_APP_ID and IMOU_APP_SECRET (credentials appropriate for Imou Open API). Requested capabilities (list/get/rename) map to the code and referenced Imou endpoints.
Instruction Scope
SKILL.md and scripts specify only the actions necessary to obtain a token and call Imou APIs. The instructions do not direct reading unrelated files or sending data to third parties. One minor scope note: SKILL.md treats IMOU_BASE_URL as required (and the code reads it), but the registry's top-level required env list omitted IMOU_BASE_URL.
Install Mechanism
No external binary downloads or risky installers; dependencies are a simple Python requests requirement. The registry summary said 'No install spec', but SKILL.md metadata includes a pip install for requests and there is a requirements.txt — this is a low-risk inconsistency but not a security problem.
Credentials
Only IMOU_APP_ID and IMOU_APP_SECRET are required (appropriate). The code also uses IMOU_BASE_URL if set (or a sensible default); IMOU_BASE_URL is used only to contact the Imou API. Registry metadata omitted IMOU_BASE_URL even though SKILL.md and the code treat it as required/configurable.
Persistence & Privilege
The skill is instruction-only with no elevated platform privileges (always:false). It does not modify other skills or system-wide config and does not request persistent presence.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install imou-device-manage - After installation, invoke the skill by name or use
/imou-device-manage - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- IMOU_BASE_URL is now required and must be set explicitly; there is no longer a default.
- Updated documentation to clarify how to select and configure the base URL for different regions (Mainland China and Overseas), including a region-to-URL table.
- Added region-specific registration and documentation links for developers.
- No functional changes to code; documentation improvements only.
v1.0.0
First release. Manage and view Imou (乐橙) cloud devices from your account.
- List all Imou devices under your account with serial, model, status, and channel details.
- Get detailed device info by serial number(s).
- Rename device or channel names.
- Uses official Imou Open API; requires your appId and appSecret.
- Includes usage instructions, quick start, and API references.
Metadata
Frequently Asked Questions
What is Imou Open Device Manage?
Imou/乐橙设备管理。支持查看账号设备列表、设备详情（序列号/型号/在离线/名称/通道）、按序列号查询、修改设备或通道名称。 Use for requests in any language (e.g. 中文/English) about listing or managing Imou/乐橙 cloud de... It is an AI Agent Skill for Claude Code / OpenClaw, with 169 downloads so far.
How do I install Imou Open Device Manage?
Run "/install imou-device-manage" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Imou Open Device Manage free?
Yes, Imou Open Device Manage is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Imou Open Device Manage support?
Imou Open Device Manage is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Imou Open Device Manage?
It is built and maintained by Imou-OpenPlatform (@imou-openplatform); the current version is v1.0.1.
More Skills