技能简介
通过Sensibo REST API远程控制智能空调设备,支持开关机、温度调节、模式切换、风速设置,以及查看室内温湿度和配置自动化规则。
能做什么
- 远程开启或关闭空调
- 调节目标温度与制冷/制热模式
- 设置低/中/高/自动风速
- 读取房间实时温度与湿度数据
- 创建定时开关计划
- 配置温度阈值自动触发规则(Climate React)
- 批量操作多台设备
使用说明
首次安装配置:
- 从 Sensibo官网 获取API密钥
- 查询设备列表获取ID:
curl --compressed "https://home.sensibo.com/api/v2/users/me/pods?fields=id,room&apiKey={API_KEY}" - 将API密钥和设备ID记录到TOOLS.md备用
常用操作示例:
开机并设为制冷22度:curl --compressed -X POST "https://home.sensibo.com/api/v2/pods/{device_id}/acStates?apiKey={key}" -H "Content-Type: application/json" -d '{"acState":{"on":true,"mode":"cool","targetTemperature":22}}'
查询当前温湿度:curl --compressed "https://home.sensibo.com/api/v2/pods/{device_id}?fields=measurements&apiKey={key}"
创建每晚22点自动关机计划:curl --compressed -X POST "https://home.sensibo.com/api/v1/pods/{device_id}/schedules/?apiKey={key}" -H "Content-Type: application/json" -d '{"targetTimeLocal":"22:00","timezone":"Asia/Shanghai","acState":{"on":false},"recurOnDaysOfWeek":["monday","tuesday","wednesday","thursday","friday","saturday","sunday"]}'
关键提示:所有请求需加--compressed参数以获得更高频率限制;用户提及”客厅””卧室”等房间名时,需在TOOLS.md中查找对应device_id。
输入与输出
见下方输入与输出表格。
| 项目 | 内容 |
|---|---|
| 输入 | API密钥、设备ID、温度设定值(整数)、运行模式(cool/heat/fan/auto/dry)、风速档位、定时规则JSON、温度阈值配置 |
| 输出 | 操作状态反馈、实时温度(℃)、实时湿度(%)、历史测量数据、设备连接状态、已创建的计划任务清单 |
| 适用人群 | Sensibo设备持有者、智能家居爱好者、需要远程控温的上班族、租房智能化改造用户 |
| 不包含 | 其他品牌空调协议支持、硬件级故障检测、用电量统计、跨品牌设备联动 |
风险提示
- API密钥泄露可能导致他人控制您的空调设备
- 温度设置超出空调硬件支持范围将返回错误
- 定时任务依赖Sensibo云服务,网络中断时可能失效
- 批量操作建议添加延迟,避免触发速率限制
- 传感器数据存在数分钟更新延迟,不宜用于精密温控场景
来源信息
原始链接:https://github.com/openclaw/skills/tree/main/skills/omere2/sensibo/SKILL.md
来源类型:GitHub仓库
