小米米家智能家居控制 (xiaomi-miot)#

🎯 功能#

• ✅ 获取用户所有米家设备列表
• ✅ 控制设备：开/关、调节亮度、温度等
• ✅ 触发场景（如"离家模式"、"睡眠模式"）
• ✅ 查询设备状态

🔧 必需的环境变量#

1. 小米 OAuth2 凭证#

bash

export XIAOMI_CLIENT_ID="2882303761517424859"        # 小米客户端 ID
export XIAOMI_CLIENT_SECRET="你的客户端密钥"           # 小米客户端密钥

2. 飞书应用凭证（用于发送登录卡片）#

bash

export FEISHU_APP_ID="你的飞书应用ID"
export FEISHU_APP_SECRET="你的飞书应用密钥"

⚠️ 重要：建议使用自己的飞书应用凭证，而非硬编码默认值。

📱 全平台兼容登录流程#

本 skill 采用 纯文字交互，支持所有平台：

• 飞书、企业微信、钉钉
• OpenClaw 网页端、终端 CLI

登录步骤#

text

用户: 帮我登录小米
  ↓
小蓝: 📱 请输入小米账号手机号：
  ↓
用户: 15393120163
  ↓
小蓝: 🔒 请输入密码：
  ↓
用户: ●●●●●●●●●●
  ↓
小蓝: 🔄 正在验证...
  ↓
如果需要验证码：
  小蓝: 📱 请输入验证码：fkqdx
  用户: fkqdx
  ↓
小蓝: ✅ 登录成功！找到 3 个设备：
       • 小米路由器4A 🟢
       • 小爱音箱 🔴
       • 小爱音箱play 🔴

💡 Token 有效期 30 天，之后自动提示重新登录

🔐 安全说明#

• Token 存储：macaroon token 缓存至 ~/.openclaw/skills/xiaomi-miot/data/token_cache.json
• 凭证管理：敏感信息通过环境变量传递，不硬编码在代码中
• 文件权限：确保 ~/.openclaw 目录权限安全（600 或 700）

⚠️ 注意事项#

1. 验证码是必须的 — 小米安全机制要求新设备验证
2. 设备离线时无法控制 — 需确保设备在线
3. 限流机制 — 频繁登录可能触发临时限制

🚀 安装#

bash

openclaw skills install xiaomi-miot-lan

安装后请配置上述环境变量。