Roborock 扫地机器人控制

通过roborock命令行界面控制 Roborock 扫地机器人。

首次设置

1. 安装 CLI

pipx install python-roborock

2. 登录 Roborock 账户

roborock login

输入您在 Roborock/小米米家应用中的邮箱和密码。

3. 查找您的设备 ID

roborock list-devices

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

4. 存储设备 ID（可选）

可将其添加到您的 TOOLS.md 文件中以便于参考：

## Roborock Vacuum
- **Device ID:** your-device-id-here
- **Model:** Roborock S7 Max Ultra (or your model)

快速命令

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

检查状态

roborock status --device_id "YOUR_DEVICE_ID"

开始清洁

roborock command --device_id "YOUR_DEVICE_ID" start

停止/暂停

roborock command --device_id "YOUR_DEVICE_ID" stop
roborock command --device_id "YOUR_DEVICE_ID" pause

返回基座

roborock command --device_id "YOUR_DEVICE_ID" home

清洁特定房间

首先获取房间ID：

roborock rooms --device_id "YOUR_DEVICE_ID"

然后清扫特定房间：

roborock command --device_id "YOUR_DEVICE_ID" segment_clean --rooms 16,17

维护命令

检查耗材

roborock consumables --device_id "YOUR_DEVICE_ID"

显示过滤器、滚刷、传感器的剩余寿命。

重置耗材

roborock reset-consumable filter --device_id "YOUR_DEVICE_ID"
roborock reset-consumable main_brush --device_id "YOUR_DEVICE_ID"
roborock reset-consumable side_brush --device_id "YOUR_DEVICE_ID"

上次清扫记录

roborock clean-record --device_id "YOUR_DEVICE_ID"

清扫摘要（总计）

roborock clean-summary --device_id "YOUR_DEVICE_ID"

地图与房间

获取地图

roborock maps --device_id "YOUR_DEVICE_ID"

缓存家庭布局

roborock home

保存地图图像

roborock map-image --device_id "YOUR_DEVICE_ID" --output /tmp/vacuum-map.png

房间功能

roborock features --device_id "YOUR_DEVICE_ID"

设置

音量

roborock volume --device_id "YOUR_DEVICE_ID"
roborock set-volume 50 --device_id "YOUR_DEVICE_ID"

勿扰模式

roborock dnd --device_id "YOUR_DEVICE_ID"

LED状态

roborock led-status --device_id "YOUR_DEVICE_ID"

童锁

roborock child-lock --device_id "YOUR_DEVICE_ID"

交互式会话

用于无需重复设备ID的多个命令：

roborock session --device_id "YOUR_DEVICE_ID"

故障排除

命令执行失败无提示：

1. 检查登录状态：roborock login
2. 使用调试模式：roborock -d status --device_id "你的设备ID"
3. 确保扫地机器人已在线并连接到WiFi

“未找到设备”：

• 运行roborock list-devices以验证设备ID
• 确保你已登录正确的Roborock账户

“认证失败”：

• 重新运行roborock login
• 检查你是否在使用与小米家/ Roborock应用相同的账户

常见任务

“打扫房子”：

roborock command --device_id "YOUR_DEVICE_ID" start

“打扫厨房”：

roborock rooms --device_id "YOUR_DEVICE_ID"  # find kitchen room ID
roborock command --device_id "YOUR_DEVICE_ID" segment_clean --rooms <kitchen_id>

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

roborock status --device_id "YOUR_DEVICE_ID"

“让扫地机器人回充”：

roborock command --device_id "YOUR_DEVICE_ID" home

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

roborock clean-record --device_id "YOUR_DEVICE_ID"

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

roborock consumables --device_id "YOUR_DEVICE_ID"

支持的型号

兼容大多数Roborock扫地机器人，包括：

• Roborock S系列（S4、S5、S6、S7、S8）
• 石头Q系列（Q5、Q7、Q8）
• 石头E系列
• 小米米家扫地机器人（基于石头技术）

致谢

使用python-roborock库。