← 返回 Skills 市场

Imou Open Device Manage

Name: Imou Open Device Manage
Author: imou-openplatform

作者 Imou-OpenPlatform · GitHub ↗ · v1.0.1 · MIT-0

cross-platform ✓ 安全检测通过

169

总下载

当前安装

版本数

在 OpenClaw 中安装

/install imou-device-manage

功能描述

Imou/乐橙设备管理。支持查看账号设备列表、设备详情（序列号/型号/在离线/名称/通道）、按序列号查询、修改设备或通道名称。 Use for requests in any language (e.g. 中文/English) about listing or managing Imou/乐橙 cloud de...

使用说明 (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 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.

安全使用建议

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.

功能分析

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.

能力评估

✓ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install imou-device-manage
安装完成后，直接呼叫该 Skill 的名称或使用 /imou-device-manage 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

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.

元数据

Slug imou-device-manage

版本 1.0.1

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 2

常见问题