Imou Open Device Operate

核心功能为远程操控乐橙（Imou）云设备，包括云台（上下左右移动、变焦）控制、抓拍设备画面并获取下载URL或保存到本地。典型场景：远程调整摄像头视角、临时抓拍监控画面。需提前配置APP ID、密钥、对应区域的API地址等环境变量，通过命令行传递设备序列号、通道ID等参数调用脚本，输出云台执行结果、快照URL或本地图片文件。

imou-openplatform

热度 53.17

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

分类：自动化依赖：代码执行 / 第三方 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.