Imou Open Device Config

IT 运维与安全需配置 API Key

imou / Imou / 乐橙 / lechange 设备安防配置技能。支持设备动检计划、动检灵敏度、隐私模式（close camera）开关。 Manages device channel security configuration: motion detection schedule, motion de...

服务器运维配置生成

581

下载量

安装量

收藏量

★ 5.0

综合评分ⓘ

概述

更多信息

Imou Device Config（乐橙设备配置）#

Manage device channel security configuration: motion detection plan, motion detection sensitivity, and privacy mode (close camera) enable/disable. Supports both PaaS devices (productId empty) and IoT thing-model devices (productId non-empty). For thing-model devices, the skill prioritizes reading the product thing model and completes all device-related configuration based on that model definition (Property get/set, Service invoke).

Search Aliases#

imou
Imou
乐橙
lechange
easy4ip
imou-device-config
乐橙设备配置
乐橙动检计划
乐橙隐私模式
乐橙物模型

Quick Start#

Install dependency:

bash

pip install requests

Set environment variables (required):

bash

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.

RegionData CenterBase URLMainland China—https://openapi.lechange.cnOverseasEast Asiahttps://openapi-sg.easy4ip.com:443OverseasCentral Europehttps://openapi-fk.easy4ip.com:443OverseasWestern Americahttps://openapi-or.easy4ip.com:443

Run (PaaS devices, productId empty):

bash

# Get motion detection plan for a channel
python3 {baseDir}/scripts/device_config.py plan get DEVICE_SERIAL CHANNEL_ID

# Set motion detection plan (rules: period, beginTime, endTime)
python3 {baseDir}/scripts/device_config.py plan set DEVICE_SERIAL CHANNEL_ID --rules '[...]'

# Set motion detection sensitivity (1-5, 1=lowest, 5=highest)
python3 {baseDir}/scripts/device_config.py sensitivity set DEVICE_SERIAL CHANNEL_ID 3

# Get privacy mode (closeCamera) status
python3 {baseDir}/scripts/device_config.py privacy get DEVICE_SERIAL CHANNEL_ID

# Set privacy mode on/off
python3 {baseDir}/scripts/device_config.py privacy set DEVICE_SERIAL CHANNEL_ID on
python3 {baseDir}/scripts/device_config.py privacy set DEVICE_SERIAL CHANNEL_ID off

IoT thing-model devices (productId not empty) – read product model first, then configure by model:

bash

# Step 1: Read product thing model (required; get Property/Service refs from model)
python3 {baseDir}/scripts/device_config.py iot model PRODUCT_ID [--verbose] [--json]

# Step 2: Property get/set and service invoke based on model definition
# Get Property values (refs from model)
python3 {baseDir}/scripts/device_config.py iot property-get PRODUCT_ID DEVICE_SERIAL '["3301","3302"]' [--json]

# Set Property values
python3 {baseDir}/scripts/device_config.py iot property-set PRODUCT_ID DEVICE_SERIAL '{"3301":1,"3302":2}'

# Invoke Service (event/command)
python3 {baseDir}/scripts/device_config.py iot service PRODUCT_ID DEVICE_SERIAL SERVICE_REF [--content '{}']

Capabilities#

Motion detection plan: Get or set alarm plan per channel (PaaS). Rules include period (Monday–Sunday), beginTime, endTime (HH:mm:ss).
Motion detection sensitivity: Set sensitivity level 1–5 for a channel (PaaS).
Privacy mode: Get or set closeCamera enable (privacy mode) per channel (PaaS).
IoT thing-model: For devices with productId: read product thing model first, then property query (get by refs from model), property set (set ref->value per model), event/command (invoke Service by ref from model, with input content per model). Configuration is driven by the thing model definition; refs and capabilities must be resolved from the model.

Device Types and Configuration Strategy#

productId empty (PaaS): Use enable APIs ( getDeviceCameraStatus / setDeviceCameraStatus), deviceAlarmPlan, modifyDeviceAlarmPlan, setDeviceAlarmSensitivity. Only devices with accessType=PaaS support these.
productId not empty (thing-model device): Prioritize reading the product thing model first ( iot model PRODUCT_ID). All device configuration (property query/set, event/command dispatch) is then performed based on the thing model definition: use Property refs and Service refs from the model for iot property-get, iot property-set, and iot service. Do not assume refs or capabilities; always resolve them from the product model.

Request Header#

All requests to Imou Open API must include the header Client-Type: OpenClaw for platform identification.

API References#

See references/imou-config-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.
Enable types: Privacy mode uses closeCamera (channel scope). Motion enable uses motionDetect (channel). See enable definition doc for full list.
Alarm plan rules: Each rule has period (e.g. "Monday" or "Monday,Wednesday,Friday"), beginTime, endTime (HH:mm:ss).
Thing-model first: For productId non-empty devices, always read the product thing model first ( iot model PRODUCT_ID); then use the model's Property/Service definitions (refs, dataTypes, inputData/outputData) for all get/set and service invoke. Do not hardcode refs across products.
IoT refs: Property and Service refs are strings (e.g. "3301") from the model. For bool properties use 0/1 in set. Service content is input params by ref per model; use {} when the service has no input.

Data Outflow#

DataSent toPurposeappId, appSecretImou Open APIObtain accessTokenaccessToken, deviceId, channelId, productId, etc.Imou Open APIGet/set plan, sensitivity, enable; IoT model, property get/set, service invoke

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