Imou Open Device Video

imou / Imou / 乐橙 / lechange 设备视频与录像技能。支持实时预览 live HLS、本地/云录像片段查询、录像回放 HLS。 Imou/Lechange device video skill for live HLS, local/cloud record clips, and playb...

Security Scan

The skill's code, runtime instructions, and requested environment variables are consistent with a client for the Imou/Lechange Open API; it only needs Imou developer credentials and the API base URL to operate.

Purpose & Capability

Name/description (Imou device live HLS, record/query/playback) match the code and SKILL.md. Requested env vars (IMOU_APP_ID, IMOU_APP_SECRET, IMOU_BASE_URL) are exactly those required to call the Imou Open API. No unrelated binaries, services, or credentials are requested.

Instruction Scope

SKILL.md and the Python scripts only instruct the agent to obtain an access token and call Imou Open API endpoints (bindDeviceLive, liveList, queryLocalRecords, queryCloudRecords, createDeviceRecordHls). The scripts read only the declared environment variables and do not reference other system files, keys, or external endpoints beyond the configured IMOU_BASE_URL (defaulting to openapi.lechange.cn).

Install Mechanism

No risky install steps; dependency is requests (pip). The SKILL.md suggests pip install requests and the metadata lists a pip install of requests — proportional and expected for a Python HTTP client. No downloads from arbitrary URLs or archives are present.

Credentials

The skill requires only appId, appSecret, and base URL for the Imou API. Those are necessary to obtain tokens and sign requests; the number and type of environment variables are proportionate to the skill's stated functionality. The primary credential (IMOU_APP_ID) is appropriate. The code does not request unrelated secrets.

Persistence & Privilege

always:false and the skill does not write persistent configuration or modify other skills. Tokens are fetched per run and not stored persistently by the skill. Autonomous invocation is allowed by default on the platform but is not combined with other concerning privileges here.

Assessment

This skill is coherent with its description: it calls the Imou / Lechange Open API and needs your Imou developer appId and appSecret plus the correct IMOU_BASE_URL. Before installing, ensure you: (1) only provide app credentials that you obtained from Imou (and revoke them if you suspect misuse), (2) run the skill in an environment with appropriate network controls if you require isolation, and (3) review the included scripts if you want to confirm there are no additional logging or telemetry paths. The skill will send your appId/appSecret and device identifiers to the configured IMOU_BASE_URL (the default is openapi.lechange.cn); it does not contact other third parties according to the code and documentation.

Imou Device Video（乐橙设备视频）

Get device live HLS URL, local/cloud record clips, and record playback HLS URL by device channel. For OpenClaw download, play, and record.

Search Aliases

• imou
• Imou
• 乐橙
• lechange
• easy4ip
• imou-device-video
• 乐橙直播
• 乐橙回放
• 乐橙云录像
• 乐橙本地录像

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:

# Get live HLS URL for a device channel (creates live if needed; if LV1001, fetches from live list)
python3 {baseDir}/scripts/device_video.py live DEVICE_ID CHANNEL_ID [--stream-id 0|1]

# Get local or cloud record clips in a time range
python3 {baseDir}/scripts/device_video.py record-clips DEVICE_ID CHANNEL_ID --begin "yyyy-MM-dd HH:mm:ss" --end "yyyy-MM-dd HH:mm:ss" [--local|--cloud] [--count 100] [--query-range 1-100]

# Get record playback HLS URL for a time range (local or cloud)
python3 {baseDir}/scripts/device_video.py playback-hls DEVICE_ID CHANNEL_ID --begin "yyyy-MM-dd HH:mm:ss" --end "yyyy-MM-dd HH:mm:ss" --record-type localRecord|cloudRecord [--stream-id 0|1]

Capabilities

1. Live HLS: Select device + channel, get real-time preview HLS URL. Supports OpenClaw download, play, record. If bind returns LV1001 (live already exists), the skill queries live list to return the existing HLS URL.
2. Record clips: Select device + channel, get local or cloud record clip list in a time range (begin/end).
3. Playback HLS: Select device + channel, get HLS URL for a given time range for local or cloud record; supports OpenClaw download, play, record. Playback URL has limited validity—use soon after obtaining.

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/
Create device live (bindDeviceLive)	https://open.imou.com/document/pages/1bc396/
Create device record HLS	https://open.imou.com/document/pages/185646/
Get live list (liveList)	https://open.imou.com/document/pages/b0e047/
Query local records	https://open.imou.com/document/pages/396dce/
Query cloud records	https://open.imou.com/document/pages/8e0e35/

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

Tips

• Token: Fetched automatically per run; valid 3 days.
• Live: Use --stream-id 0 (main stream) or 1 (sub stream). If API returns LV1001, the script falls back to liveList to find the existing HLS for the same device/channel/streamId.
• Record clips: --local uses queryLocalRecords (param count, max 100; some devices limit to 32). --cloud uses queryCloudRecords (param queryRange e.g. 1-100). Paginate by using the last clip’s endTime as next beginTime.
• Playback HLS: Time format yyyy-MM-dd HH:mm:ss; no cross-day range. Record type localRecord or cloudRecord. Use the URL promptly; it expires.

Data Outflow

Data	Sent to	Purpose
appId, appSecret	Imou Open API	Obtain accessToken
accessToken, deviceId, channelId, etc.	Imou Open API	Live, record clips, playback HLS

All requests go to the configured IMOU_BASE_URL. No other third parties.