小米Miot 接入教程
小米Miot（Xiaomi Miot）集成通过登录小米账号，把账号下的米家智能设备接入 Home Assistant。它支持在导入时按需过滤设备（排除或仅包含指定设备），方便你只把需要的设备同步到 HA 中。本文演示在冬瓜 HAOS 上接入「小米Miot」集成的完整流程。
| 名称 | OS | Core | Xiaomi miot |
|---|---|---|---|
| 版本 | 17.0 | 2025.2.1 | 1.1.2 |
在开始之前，请确认：
- 冬瓜 HAOS 默认已安装相关组件，如需更新需操作 HACS - 极速版。
- 已在「米家 / 小米」App 内把智能设备接入你的小米账号。
- HA 盒子、电脑和设备处于同一个局域网内（详细配置可参考「智能设备网络设置」文档）。
- 准备好你的小米账号和密码（用于登录）。
第 1 步：添加集成并搜索
Section titled “第 1 步：添加集成并搜索”进入 Home Assistant 的 设置 → 集成与服务 → 添加集成，在搜索框中搜索 xiaomi miot。
第 2 步：选择「账号集成」
Section titled “第 2 步：选择「账号集成」”在弹出的窗口中默认选择「账号集成」选项，点击 提交。
第 3 步：输入小米账号和密码
Section titled “第 3 步：输入小米账号和密码”输入你的小米账户和密码，点击 提交。系统会提示你打开验证网页。
第 4 步：发送验证码
Section titled “第 4 步：发送验证码”在验证网页中点击 发送验证码，系统会向你的邮箱或手机发送验证信息。
第 5 步：在 HA 页面输入验证码
Section titled “第 5 步：在 HA 页面输入验证码”回到 Home Assistant 页面，在「邮箱 / 手机验证码」栏位中输入收到的验证码，点击 提交。
注意：验证码要输入到 HA 的页面 中，而不是网页端。
第 6 步：选择设备过滤方式
Section titled “第 6 步：选择设备过滤方式”进入设备过滤阶段，可选择 Exclude（排除） 或 Include（包含）：
- 选 Exclude（排除）：勾选的设备不会导入到 HA 中。
- 选 Include（包含）：仅勾选的设备会导入到 HA 中。
- 如无特殊需求，可保持默认直接 提交。
第 7 步：完成添加
Section titled “第 7 步：完成添加”确认设置无误后完成添加，接入完成。
| 问题 | 解决办法 |
|---|---|
| 搜索不到 xiaomi miot 集成 | 确认冬瓜 HAOS 组件已安装，可通过 HACS - 极速版更新后重试，或重启一次 Home Assistant 再搜索。 |
| 验证码填了没反应 / 验证失败 | 注意验证码要输入到 HA 的页面 中而不是网页端；确认验证码正确且未过期，必要时重新点「发送验证码」。 |
| 收不到验证码 | 检查发送目标（邮箱 / 手机）是否正确，稍等片刻或重新发送。 |
| 设备导入太多 / 想只导入部分设备 | 在第 6 步选择 Include（包含） 仅导入勾选设备，或选 Exclude（排除） 把不想要的设备排除。 |
接入小米Miot 的核心流程是：添加集成 → 搜索 xiaomi miot → 选择账号集成 → 输入账号密码 → 网页发送验证码 → 在 HA 页面填入验证码 → 选择设备过滤方式 → 完成。完成后即可在 Home Assistant 中管理已导入的米家设备。