Imou Open Device Operate

该技能通过脚本调用 Imou/乐橙开放平台 HTTP API，对指定设备执行 PTZ 云台移动控制与 setDeviceSnapEnhanced 抓图，返回有效期 2 小时的快照 URL，可选下载保存到本地；需先配置 appId、appSecret 与 API 基础地址等环境变量。

imou-openplatform

热度 53.00

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

分类：自动化依赖：代码执行 / 第三方 API / 读写文件应用场景：自动化脚本 / API 集成

安装技能

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

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

Metadata

name: imou-device-operate
description: imou / Imou / 乐橙 / lechange 设备操控技能。支持 PTZ 云台控制、snapshot 抓图与下载。 Imou/Lechange device operation for PTZ control, snapshot capture, and image download. Use when: imou ptz control, Imou device operate, lechange device operate, 乐橙设备操控, 乐橙云台控制, 乐橙抓图下载.
metadata: {"openclaw":{"emoji":"🎮","requires":{"env":["IMOU_APP_ID","IMOU_APP_SECRET","IMOU_BASE_URL"],"pip":["requests"]},"primaryEnv":"IMOU_APP_ID","install":[{"id":"python-requests","kind":"pip","package":"requests","label":"Install requests"}]}}

Imou Device Operate（乐橙设备操控）

Control Imou cloud devices: PTZ (pan-tilt-zoom) movement, device snapshot capture, and download snapshot image by URL.

Search Aliases

imou
Imou
乐橙
lechange
easy4ip
imou-device-operate
乐橙设备
乐橙云台
乐橙抓图
乐橙摄像头

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:

# Device snapshot (returns downloadable URL; optional save to file)
python3 {baseDir}/scripts/device_operate.py snapshot DEVICE_SERIAL CHANNEL_ID [--save PATH]

# PTZ move (operation: 0-10, duration in ms)
python3 {baseDir}/scripts/device_operate.py ptz DEVICE_SERIAL CHANNEL_ID OPERATION DURATION_MS

Capabilities

Device snapshot: Call setDeviceSnapEnhanced to get a snapshot URL (valid 2 hours). Optionally download to a local file with --save.
PTZ control: controlMovePTZ with operation (0=up, 1=down, 2=left, 3=right, 4=up-left, 5=down-left, 6=up-right, 7=down-right, 8=zoom in, 9=zoom out, 10=stop) and duration in milliseconds. Device must support PT/PTZ.

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/
Device snapshot (enhanced)	https://open.imou.com/document/pages/09fe83/
PTZ move control	https://open.imou.com/document/pages/66c489/

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

Tips

Token: Fetched automatically per run; valid 3 days.
Snapshot: Request interval should be ≥1s per device; snapshot URL expires in 2 hours.
PTZ: Use operation 10 (stop) to stop movement; duration is in milliseconds.

Data Outflow

Data	Sent to	Purpose
appId, appSecret	Imou Open API	Obtain accessToken
accessToken, deviceId, channelId, etc.	Imou Open API	Snapshot, PTZ control

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