Imou Open Device Operate

v1.0.3

imou / Imou / 乐橙 / lechange 设备操控技能。支持 PTZ 云台控制、snapshot 抓图与下载。 Imou/Lechange device operation for PTZ control, snapshot capture, and image download. Use when...

⭐ 0· 198·0 current·0 all-time

by@imou-openplatform

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for imou-openplatform/imou-device-operate.

Previewing Install & Setup.

Prompt PreviewInstall & Setup

Install the skill "Imou Open Device Operate" (imou-openplatform/imou-device-operate) from ClawHub.
Skill page: https://clawhub.ai/imou-openplatform/imou-device-operate
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Required env vars: IMOU_APP_ID, IMOU_APP_SECRET, IMOU_BASE_URL
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.

Command Line

CLI Commands

Use the direct CLI path if you want to install manually and keep every step visible.

OpenClaw CLI

Bare skill slug

openclaw skills install imou-device-operate

ClawHub CLI

Package manager switcher

npx clawhub@latest install imou-device-operate

Security Scan

VirusTotal

Benign

View report →

OpenClaw

Benign

high confidence

✓

Purpose & Capability

Name/description (PTZ, snapshot, download) match the code and SKILL.md. Required env vars (IMOU_APP_ID, IMOU_APP_SECRET, IMOU_BASE_URL) are exactly what the Imou Open API needs.

✓

Instruction Scope

SKILL.md and the Python scripts only call the Imou Open API endpoints, fetch tokens, request snapshots and PTZ control, and optionally download returned snapshot URLs. No instructions to read unrelated files or to contact other external endpoints.

✓

Install Mechanism

No installer that downloads arbitrary code; dependencies are limited to the 'requests' Python package (declared in requirements.txt and SKILL.md). This is proportionate to the functionality.

✓

Credentials

The skill requires only three env vars that map directly to the Imou API credentials and base URL. No unrelated secrets, config paths, or extra credentials are requested.

✓

Persistence & Privilege

always:false and no modifications to other skills or system-wide settings. The skill does not request persistent system presence beyond normal runtime use.

Assessment

This skill appears coherent and implements the Imou Open API as described. Before installing, ensure you: (1) only provide IMOU_APP_ID and IMOU_APP_SECRET for a trusted Imou developer account; (2) set IMOU_BASE_URL to the official Imou/OpenAPI domain for your region (do not point it to untrusted hosts); (3) treat appSecret as a sensitive credential and avoid exposing it in shared environments; and (4) be aware that the skill can perform PTZ actions on devices (move/stop), so grant it access only if you intend the agent to control cameras. If you need extra assurance, review the included Python files locally to confirm the endpoints and behavior before running.

Like a lobster shell, security has layers — review code before you run it.

Runtime requirements

🎮 Clawdis

EnvIMOU_APP_ID, IMOU_APP_SECRET, IMOU_BASE_URL

Primary envIMOU_APP_ID

latestvk97en4zhkz0a0r4ybb3rdxx3w183qzzd

198downloads

0stars

4versions

Updated 1mo ago

v1.0.3

MIT-0

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.

Comments

Loading comments...