ClawHub

Duwi Smart Home

Data & APIs

迪惟智能家居技能，基于 Duwi 开放平台 API，支持设备控制、场景执行、状态查询等功能

Install

openclaw skills install duwi-smart-home

Duwi 迪惟智能家居技能

基于 Duwi 开放平台 API，支持设备控制、场景执行、状态查询等功能。

功能特性

房屋管理

  • 多房屋支持
  • 楼层管理
  • 房间管理

状态查询

  • 设备在线状态
  • 设备实时数值（温度、湿度、光照度、电压、电流等）
  • 传感器历史统计数据
  • 用电量统计数据

设备控制

  • 电源断路器控制：开关控制等
  • 灯光控制：开关、亮度调节 (0-100%)、色温调节 (2700-6200K)、颜色调整（HSV 格式）等
  • 窗帘控制：开/关/停、百分比 (0-100%)、角度调节等
  • 空调控制：开关、温度设置 (5-35℃)、模式设置、风速设置、风向设置等
  • 地暖控制：开关、温度设置 (10-30℃) 等
  • 新风控制：开关、湿度设置（0-100%）、风速设置、工作模式设置等
  • 热泵控制：开关、温度设置、模式设置等
  • 二联供控制：开关、模式设置、温度设置（5-35℃）、湿度设置（0-100%）、风速控制等

场景控制

  • 场景列表查询
  • 场景执行

快速开始

1. 配置应用凭证

配置前确认：

  • ✅ 你已从迪惟开放平台获取了 APPKEY 和 SECRET

方式 1：非交互模式（适合大模型）

python init_config.py --appkey <APPKEY> --secret <SECRET>

方式 2：交互模式

python init_config.py

按提示输入 APPKEY 和 SECRET（输入时 SECRET 会隐藏显示）。

2. 登录账户

方式 1：提供密码

python duwi_cli.py login <手机号> <密码>

方式 2：不输入密码（会提示输入，隐藏显示）

python duwi_cli.py login <手机号>

3. 选择房屋

方式 1：交互选择

python duwi_cli.py choose-house

按提示选择房屋。

方式 2：直接指定房屋编号（推荐，无需交互）

python duwi_cli.py choose-house --house_no <房屋编号>

4. 开始控制

python duwi_cli.py device-operate switch on --room 客厅 --device_name 顶灯

功能参考

账户管理

功能CLI 指令
登录python duwi_cli.py login <手机号> [密码]
退出python duwi_cli.py logout

💡 提示：登录成功后 token 会自动保存，下次使用无需重新登录。Token 过期时会自动刷新。

房屋管理

功能CLI 指令
房屋列表python duwi_cli.py houses
选择房屋python duwi_cli.py choose-house --house_no <编号>
楼层列表python duwi_cli.py floors
房间列表python duwi_cli.py rooms [--floor <楼层名>]

大模型提示： 通过楼层名称查找房间列表，未找到相应的楼层时，先查找楼层列表，匹配相似的楼层名称，再通过精准楼层名称查找房间列表。

设备查询

功能CLI 指令
设备列表python duwi_cli.py devices [--room <房间>] [--floor <楼层>] [--online]
设备详情python duwi_cli.py device-info <设备编号>
设备状态python duwi_cli.py device-value <设备编号>

大模型提示： 设备列表的查询支持 --floor（楼层）、--room（房间）、--online（是否在线）、--type（设备类型编号）参数来精确定位设备，参数可选，可同时传入多个参数。

设备控制

命令格式： python duwi_cli.py device-operate <动作> <值> [定位参数]

定位参数优先级： --device_no > --floor + --room + --device_name > --room + --device_name > --device_name

设备类型(类型前缀)动作动作说明值说明示例
电源 (1-*)switch开关on/offswitch on --room 客厅 --device_name 断路器
灯光 (3-*)switch开关on/offswitch off --room 卧室 --device_name 顶灯
light调光亮度 (0-100)light 80 --room 客厅 --device_name 灯带
color_temp调色温色温 (2700-6200K)color_temp 4000 --room 书房 --device_name 台灯
color调色HSV 格式 (H:S:V)color 180:100:100 --room 卧室 --device_name 灯
窗帘 (4-*)control开关停open/close/stopcontrol open --room 客厅 --device_name 窗帘
control_percent设开合度百分比 (0-100)control_percent 50 --room 主卧 --device_name 窗帘
空调 (5-001)ac_switch开关on/offac_switch on --room 客厅 --device_name 空调
ac_set_temp设温度温度 (5-35℃)ac_set_temp 26 --room 客厅 --device_name 空调
ac_mode设模式auto/cold/hot/fan/wetac_mode cold --room 卧室 --device_name 空调
ac_wind_speed设风速auto/high/mid/lowac_wind_speed mid --room 客厅 --device_name 空调
ac_wind_direction设风向auto/stop/swing/up_down/left_rightac_wind_direction auto --room 客厅 --device_name 空调
ac_lock_mode设锁定模式lock/half_lock/unlockac_lock_mode lock --room 客厅 --device_name 空调
地暖 (5-002)fh_switch开关on/offfh_switch on --device_name 地暖
fh_set_temp设温度温度 (10-30℃)fh_set_temp 25 --device_name 地暖
fh_lock_mode设锁定模式lock/half_lock/unlockfh_lock_mode lock --device_name 地暖
新风 (5-003)fa_switch开关on/offfa_switch on --device_name 新风机
fa_work_mode设模式fresh/auto/manual/sleepfa_work_mode fresh --device_name 新风机
fa_wind_speed设风速auto/high/mid/lowfa_wind_speed mid --device_name 新风机
fa_set_humidity设湿度湿度 (0-100%)fa_set_humidity 60 --device_name 新风机
fa_clean_switch开关UV 杀菌on/offfa_clean_switch on --device_name 新风机
fa_fan_speed设排风风速auto/high/mid/lowfa_fan_speed mid --device_name 新风机
热泵 (5-004)hp_switch开关on/offhp_switch on --device_name 热泵
hp_set_temp设温度温度 (5-55℃)hp_set_temp 45 --device_name 热泵
hp_mode设模式cold/hothp_mode hot --device_name 热泵
温控 (5-005)tc_switch开关on/offtc_switch on --device_name 温控器
tc_set_temp设温度温度 (5-35℃)tc_set_temp 26 --device_name 温控器
tc_set_humidity设湿度湿度 (0-100%)tc_set_humidity 26 --device_name 温控器
tc_mode设模式auto/cold/hottc_mode cold --device_name 温控器
tc_wind_speed设风速auto/high/mid/lowtc_wind_speed auto --device_name 温控器
tc_lock_mode设锁定模式mix/lock/mode_wind/floorheattc_lock_mode lock --device_name 温控器

颜色 HSV 参考： 红色=0:100:100 | 绿色=120:100:100 | 蓝色=240:100:100 | 白色=0:0:100 | 黄色=60:100:100<br> 空调模式说明： auto (自动)、cold (制冷)、hot (制热)、fan (送风)、wet (除湿)、air (换气)<br> 空调风速说明： auto (自动)、super_strong (超强)、super_high (超高)、high (高)、mid (中)、low (低)、super_low (超低)、super_quiet (超静)<br> 空调风向说明： auto (自动)、stop (停止)、swing (摇摆)、up_down (上下)、left_right (左右)<br> 空调锁定模式说明： lock (全锁)、half_lock (半锁)、unlock (解锁)<br> 地暖锁定模式说明： lock (全锁)、half_lock (半锁)、unlock (解锁)<br> 新风风速和新风排风风速说明： auto (自动)、extreme_strong (极强)、super_high (超高)、high (高)、mid (中)、low (低)、super_low (超低)、super_quiet (超静)<br> 新风工作模式说明： fresh (新风)、wet (除湿)、auto (自动)、manual (手动)、indoor_loop (内循环)、sleep (睡眠)、pass (旁通)、common (普通)、smart (智能)、ventilate (通风)、outdoor_loop (外循环)、smart_auto (智慧自动)、eco_fresh (节能新风)、normal_air (普通换气)、cold_wet (制冷除湿)、hot_humidify (制热加湿)、cold_hot_auto (冷暖自动)、smart_humidify (智慧调湿)、timing (定时)、air (换气)、clean (净化)、program (编程)、exhaust (排风)、heat_exchange (热交换)、powerful (强力)、cold_room (冷房)、hot_room (暖房)、energy_recycle (能量回收)、night (夜间)、holiday (假日)<br> 热泵模式说明： cold (制冷)、hot (制热)<br> 温控模式说明： auto (自动)、cold (制冷)、hot (制热)、ventilate (通风)、floorheat (地暖)、mix (一体)、smart_floorheat (智能地暖)、cold_floorcold (制冷制热)<br> 温控风速说明： auto (自动)、super_strong (超强)、strong (强劲)、super_high (超高)、high (高)、mid (中)、low (低)、super_low (超低)、super_quiet (超静)<br> 温控锁定模式说明： mode (锁定模式)、mode_wind (锁定模式&风速)、mode_wind_temp (锁定模式&风速&温度)、unlock (解锁)、floorheat (地暖)、mix (一体)、lock (锁定)<br>

场景控制

功能CLI 指令
场景列表python duwi_cli.py scenes [--room <房间>] [--floor <楼层>]
执行场景python duwi_cli.py execute-scene --scene_no <编号> 或 --scene_name <名称>

统计数据

功能CLI 指令
传感器统计python duwi_cli.py sensor-stats <设备编号> --type <类型> --days <天数>
电量统计python duwi_cli.py elec-stats [--device_no <编号>] --days <天数>

传感器类型： 1=温度，2=湿度，3=光照度，4=甲醛，5=PM2.5，6=CO2，7=AQI，8=人体感应 <br>

缓存管理

功能CLI 指令
缓存统计python duwi_cli.py cache stats
清理缓存python duwi_cli.py cache clean
清空缓存python duwi_cli.py cache clear

大模型集成指南

意图识别 → CLI 命令映射

用户说法识别要素生成的 CLI 命令
"打开客厅的灯"房间=客厅，设备=灯，动作=开python duwi_cli.py device-operate switch on --room 客厅 --device_name 灯
"关闭一楼卧室的空调"楼层=一楼，房间=卧室，设备=空调python duwi_cli.py device-operate ac_switch off --floor 一楼 --room 卧室 --device_name 空调
"把主卧窗帘开到 50%"房间=主卧，设备=窗帘，值=50python duwi_cli.py device-operate control_percent 50 --room 主卧 --device_name 窗帘
"客厅空调 26 度制冷"房间=客厅，温度=26，模式=制冷python duwi_cli.py device-operate ac_set_temp 26 --room 客厅 --device_name 空调
"把灯调成红色"设备=灯，颜色=红色python duwi_cli.py device-operate color 0:100:100 --device_name 灯

房屋结构

房屋 → 楼层 → 房间 → 设备/场景

房屋 (House)
├── 一楼 (Floor)
│   ├── 客厅 (Room)
│   │   ├── 顶灯 (Device)
│   │   ├── 会客模式 (Scene)
│   │   └── 客厅群组 (Group)
│   └── 厨房 (Room)
└── 二楼 (Floor)
    └── 次卧 (Room)
层级说明示例
房屋最高层级北京的家
楼层房屋的楼层一楼、二楼
房间楼层下的房间客厅、卧室
设备智能设备灯、窗帘、空调
场景预设场景会客模式、睡眠模式

注意事项

  1. Token 管理： 登录后自动缓存，过期自动刷新
  2. 房屋选择： 首次使用需选择房屋，配置保存到 config.json
  3. 设备在线： 控制前请确认设备在线
  4. 参数范围： 亮度 0-100%，色温 2700-6200K，空调温度 5-35℃，地暖温度 10-30℃
  5. 缓存刷新： 设备控制后自动刷新缓存，如需手动刷新执行 cache clear
  6. 安全： 配置文件仅本地保存，不要分享或提交到 Git
  7. 控制反馈：如果控制失败，请反馈给用户相关控制失败原因
  8. 设备缓存：设备列表会自动缓存 5 分钟，如需刷新请等待或调用 cache clear
  9. 用户反馈处理：如果提出设备状态和实际设备状态不一致，请及时调用 cache clear

错误码

返回码说明
10000操作成功
10001请求参数不正确
10002accessToken 异常或过期
10003暂无访问权限
11000账户名或者密码错误
99001appKey 异常
99002签名错误
99003时间戳请求超时
19999系统错误

依赖

pip install requests
More in Data & APIs