- name
- xiaomi-miot
- description
- 小米米家智能家居控制技能。通过小爱音箱、米家设备控制灯光、空调、扫地机器人等小米IoT设备。当用户说"开灯"、"关空调"、"让扫地机器人扫地"等智能家居控制指令时使用。
小米米家智能家居控制 (xiaomi-miot)
🎯 功能
- ✅ 获取用户所有米家设备列表
- ✅ 控制设备：开/关、调节亮度、温度等
- ✅ 触发场景（如"离家模式"、"睡眠模式"）
- ✅ 查询设备状态
🔧 必需的环境变量
1. 小米 OAuth2 凭证
export XIAOMI_CLIENT_ID="2882303761517424859" # 小米客户端 ID
export XIAOMI_CLIENT_SECRET="你的客户端密钥" # 小米客户端密钥2. 飞书应用凭证（用于发送登录卡片）
export FEISHU_APP_ID="你的飞书应用ID"
export FEISHU_APP_SECRET="你的飞书应用密钥"⚠️ 重要：建议使用自己的飞书应用凭证，而非硬编码默认值。
📱 全平台兼容登录流程
本 skill 采用纯文字交互，支持所有平台：
- 飞书、企业微信、钉钉
- OpenClaw 网页端、终端 CLI
登录步骤
用户: 帮我登录小米
↓
小蓝: 📱 请输入小米账号手机号：
↓
用户: 15393120163
↓
小蓝: 🔒 请输入密码：
↓
用户: ●●●●●●●●●●
↓
小蓝: 🔄 正在验证...
↓
如果需要验证码：
小蓝: 📱 请输入验证码：fkqdx
用户: fkqdx
↓
小蓝: ✅ 登录成功！找到 3 个设备：
• 小米路由器4A 🟢
• 小爱音箱 🔴
• 小爱音箱play 🔴💡 Token 有效期 30 天，之后自动提示重新登录
🔐 安全说明
- Token 存储：macaroon token 缓存至
~/.openclaw/skills/xiaomi-miot/data/token_cache.json - 凭证管理：敏感信息通过环境变量传递，不硬编码在代码中
- 文件权限：确保
~/.openclaw目录权限安全（600 或 700）
⚠️ 注意事项
- 验证码是必须的 — 小米安全机制要求新设备验证
- 设备离线时无法控制 — 需确保设备在线
- 限流机制 — 频繁登录可能触发临时限制
🚀 安装
openclaw skills install xiaomi-miot-lan安装后请配置上述环境变量。