SuperAPI AI 工具集

home-automation

通用与其它

查看项目

更新于 10-15 19:55

技能介绍

用途:该技能用于集成智能家居系统,让 AI 以编程方式控制 IoT 设备,适用于智能家居应用、语音助手集成和日常例程脚本(如睡前关灯)。

主要能力:通过 Home Assistant REST API 管理设备状态(状态端点 GET /api/states,动作端点 POST /api/services);用 HAP 协议接入 HomeKit(需 Bonjour 发现);用 Google Home API 控制兼容设备(OAuth 2.0,作用域如 https://www.googleapis.com/auth/homeautomation,设备端点 GET https://homegraph.googleapis.com/v1/devices);通过桥接 API 处理 Matter 设备(基于 IP 的配网)。

使用方式:先初始化并认证,如 skill.use('home-automation'),再 skill.connect(service, key)。CLI 示例:openclaw home-automation connect --service home-assistant --api-url http://localhost:8123 --key $HOME_ASSISTANT_API_KEY。配置为 JSON,如 {"service": "home-assistant", "api_url": "http://localhost:8123"};Matter 配置为 YAML,如 matter: { bridge_ip: '192.168.1.100', port: 5540 }。密钥用环境变量,如 $HOME_ASSISTANT_API_KEY、$GOOGLE_HOME_TOKEN。异步操作需用 promise 或回调处理。

限制与注意:HomeKit 设备需先在 Home app 中配对,自定义集成可用 HAP-NodeJS;Google Home 需完成 OAuth 流程;Matter 需兼容桥接设备。避免在单次调用中混用协议,跨服务切换建议使用包装器。需处理 HTTP 错误(如 401 未授权、429 限流),可用 try-catch 与指数退避重试,认证失败时刷新令牌。

资料未提供具体收费、价格、平台支持范围与效果数据。