石头扫地机器人接入教程
石头（Roborock）扫地机器人可以通过 Home Assistant 的 Roborock 集成接入。本教程演示如何添加 Roborock 集成，使用 App 绑定的电子邮箱 + 验证码完成登录，将石头扫地机器人纳入 Home Assistant 管理。
在开始之前，请确认以下条件，并参考下方的版本信息表：
- 你的 Home Assistant 已经正常运行，并能正常访问后台。
- 你已经在石头（Roborock）App 中完成账号注册，并使用 电子邮箱 绑定了账号、添加了扫地机器人设备。
- 登录过程中需要接收邮箱验证码，请确保该邮箱可以正常收信。
| 名称 | OS | Core | Roborock |
|---|---|---|---|
| 版本 | 17.0 | 2026.2.2 | — |
第 1 步：添加 Roborock 集成
Section titled “第 1 步：添加 Roborock 集成”依次点击 设置 > 设备与服务 > 集成 > 添加集成，在搜索框中输入 roborock，点击搜索结果进行添加。
第 2 步：输入 App 绑定的电子邮箱
Section titled “第 2 步：输入 App 绑定的电子邮箱”在 App 中绑定邮箱后，于弹出的窗口中输入该 电子邮箱，然后点击 提交。
第 3 步：输入验证码并完成
Section titled “第 3 步：输入验证码并完成”输入收到的 验证码 并点击 提交，然后点击 完成，即可完成石头扫地机器人的接入。
| 问题 | 解决办法 |
|---|---|
| 搜不到 Roborock 集成 | 尝试刷新浏览器或重启一次 Home Assistant；确认搜索关键词为 roborock。 |
| 收不到验证码 | 确认填写的是石头 App 绑定的电子邮箱；检查邮箱垃圾箱，并确保邮箱能正常收信，稍后重试。 |
| 验证码提交失败 | 确认验证码输入正确且未过期，过期后重新获取验证码再提交。 |
| 登录成功但看不到设备 | 确认扫地机器人已在石头 App 中添加成功并在线。 |
石头扫地机器人接入的核心流程是：设置 → 设备与服务 → 添加集成 → 搜索 roborock → 输入 App 绑定邮箱 → 输入验证码 → 完成，完成后即可在 Home Assistant 中管理你的石头扫地机器人。