Smart Home Unified - 智能家居统一控制
⚠️ 重要说明
本技能已实现真实 API 集成,需要用户自行配置设备 API 密钥。
🔧 配置指南
1. 安装依赖
# 安装技能
clawhub install smart-home-unified
# 安装平台特定依赖(根据需要选择)
npm install -g miio # 小米米家设备
npm install -g hap-nodejs # Apple HomeKit 设备
2. 获取设备 Token
小米米家设备
# 安装 miio 工具
npm install -g miio
# 提取设备 token
miio extract --token <token>
# 发现设备
miio discover
Apple HomeKit 设备
- 在 Apple Home App 中配对设备
- 获取配件 PIN 码(通常在设备底部或说明书上)
3. 配置凭证
在 TOOLS.md 中添加配置:
### Smart Home - 智能家居配置
#### 小米米家
- xiaomi:
- username: "你的小米账号"
- password: "你的小米密码"
- device_token: "设备 token(通过 miio extract 获取)"
#### Apple HomeKit
- homekit:
- pin_code: "配件 PIN 码(8 位数字,格式:XXX-XX-XXX)"
- username: "Apple ID(可选,用于 iCloud 同步)"
- password: "Apple 密码(可选)"
🚀 使用示例
发现设备
smart-home discover --platform xiaomi
smart-home discover --platform homekit
控制设备
# 打开灯
smart-home control --device "客厅主灯" --action turnOn
# 调节亮度
smart-home control --device "卧室灯" --action setBrightness --level 80
# 设置空调温度
smart-home control --device "客厅空调" --action setTemperature --temp 26
查看状态
smart-home status --all
smart-home status --device "客厅主灯"
⚠️ 注意事项
- 本地网络要求:设备必须在同一局域网内
- Token 有效期:小米设备 token 可能定期更换
- 防火墙设置:确保 UDP 端口 54321 开放(小米设备)
- HomeKit 配对:需要先通过 Home App 配对设备
📞 技术支持
- 文档:https://github.com/your-repo/smart-home-unified
- 问题反馈:https://github.com/your-repo/smart-home-unified/issues
- 邮件:support@smarthomeunified.com
💰 定价
$99-299/月 - 包含所有平台无限次使用
- 基础版 $99/月:支持 10 个设备
- 专业版 $199/月:支持 50 个设备 + 场景联动
- 企业版 $299/月:无限设备 + 定制集成
⚠️ 安全提示:本技能需要访问你的智能家居设备,请确保:
- 只在可信环境中使用
- 定期更换设备 token/密码
- 不要分享配置文件