名称： roborock
描述： 控制 Roborock 扫地机器人（状态、清扫、地图、耗材）。适用于用户要求清扫、检查状态、控制机器人或管理清扫计划时。触发关键词：vacuum, roborock, clean floor, hoover, robot cleaner。
元数据： {"clawdbot":{"emoji":"🧹","requires":{"bins":["roborock"]},"install":[{"id":"pipx","kind":"pipx","package":"python-roborock","bins":["roborock"],"label":"安装 roborock CLI (pipx)"}]}}

Roborock 扫地机器人控制

通过 roborock 命令行工具控制 Roborock 扫地机器人。

首次设置

1. 安装 CLI

pipx install python-roborock

2. 登录 Roborock 账户

roborock login

输入您在 Roborock/Xiaomi Home 应用中使用的邮箱和密码。

3. 查找设备 ID

roborock list-devices

记下您的设备 ID（格式类似 AbCdEf123456789XyZ）。

4. 保存设备 ID（可选）

添加到您的 TOOLS.md 文件中以便后续使用：

## Roborock 扫地机器人
- **设备 ID:** 您的设备 ID
- **型号:** Roborock S7 Max Ultra（或您的实际型号）

常用命令

所有命令都需要 --device_id "您的设备ID" 参数，请替换为您的实际设备 ID。

检查状态

roborock status --device_id "您的设备ID"

开始清扫

roborock command --device_id "您的设备ID" start

停止/暂停

roborock command --device_id "您的设备ID" stop
roborock command --device_id "您的设备ID" pause

返回充电座

roborock command --device_id "您的设备ID" home

清扫特定房间

首先获取房间 ID：

roborock rooms --device_id "您的设备ID"

然后清扫指定房间：

roborock command --device_id "您的设备ID" segment_clean --rooms 16,17

维护命令

检查耗材状态

roborock consumables --device_id "您的设备ID"

显示滤网、主刷、边刷和传感器的剩余寿命。

重置耗材计时

roborock reset-consumable filter --device_id "您的设备ID"
roborock reset-consumable main_brush --device_id "您的设备ID"
roborock reset-consumable side_brush --device_id "您的设备ID"

最近一次清扫记录

roborock clean-record --device_id "您的设备ID"

清扫历史汇总

roborock clean-summary --device_id "您的设备ID"

地图与房间

获取地图

roborock maps --device_id "您的设备ID"

缓存家庭布局

roborock home

保存地图图片

roborock map-image --device_id "您的设备ID" --output /tmp/vacuum-map.png

房间功能

roborock features --device_id "您的设备ID"

设置

音量

roborock volume --device_id "您的设备ID"
roborock set-volume 50 --device_id "您的设备ID"

勿扰模式

roborock dnd --device_id "您的设备ID"

LED 状态

roborock led-status --device_id "您的设备ID"

童锁

roborock child-lock --device_id "您的设备ID"

交互式会话

无需重复输入设备 ID 即可执行多个命令：

roborock session --device_id "您的设备ID"

故障排除

命令执行失败但无提示：
1. 检查登录状态：roborock login
2. 使用调试模式：roborock -d status --device_id "您的设备ID"
3. 确保扫地机器人已在线并连接到 WiFi

“未找到设备”：
- 运行 roborock list-devices 验证设备 ID
- 确保您登录的是正确的 Roborock 账户

“认证失败”：
- 重新运行 roborock login
- 检查是否使用了与小米 Home / Roborock 应用相同的账户

常见任务

“清扫整个房子”：

roborock command --device_id "您的设备ID" start

“清扫厨房”：

roborock rooms --device_id "您的设备ID"  # 查找厨房的房间 ID
roborock command --device_id "您的设备ID" segment_clean --rooms <厨房ID>

“扫地机器人清扫完了吗？”：

roborock status --device_id "您的设备ID"

“让扫地机器人回充”：

roborock command --device_id "您的设备ID" home

“上次是什么时候清扫的？”：

roborock clean-record --device_id "您的设备ID"

“检查刷子/滤网寿命”：

roborock consumables --device_id "您的设备ID"

支持的型号

兼容大多数 Roborock 扫地机器人，包括：
- Roborock S 系列（S4, S5, S6, S7, S8）
- Roborock Q 系列（Q5, Q7, Q8）
- Roborock E 系列
- 小米米家扫地机器人（基于 Roborock）

致谢

基于 python-roborock 库开发。