石头扫地机控制

技能简介

通过命令行工具连接并控制Roborock石头扫地机器人，支持启动清扫、暂停回充、查看实时状态、管理房间分区、监控耗材寿命及导出地图等功能。

业务背景

无需打开App，通过命令行即可远程操控石头扫地机器人，适合IT运维人员或智能家居爱好者快速集成到自动化工作流。支持实时查看清扫进度、管理多房间分区任务、监控耗材寿命，提升设备管理效率，减少人工巡检成本。

落地案例：某技术团队将扫地机控制接入内部运维系统：每日下班前自动执行 roborock command –device_id "xxx" start 启动全屋清扫；会议室预约系统联动指定房间ID，会后自动清洁；每周导出耗材寿命数据，滤网低于20%时触发采购提醒。所有操作无需人工登录App，实现设备管理的自动化闭环。

能做什么

• 查询设备在线状态与当前任务进度
• 全屋清扫或指定房间分区清洁
• 控制机器人暂停、继续、停止或返回充电座
• 查看滤网、主刷、边刷等耗材剩余寿命
• 获取家庭地图布局并保存为图片
• 调整音量、设置勿扰模式、开关童锁

使用说明

安装CLI工具

pipx install python-roborock

首次配置（四步）

1. 登录账号：roborock login，输入Roborock或米家App的邮箱密码
2. 查找设备ID：roborock list-devices，记录类似AbCdEf123456789XyZ的标识
3. 建议将设备ID写入TOOLS.md方便后续调用
4. 所有命令需附加--device_id "YOUR_DEVICE_ID"参数

常用命令示例

• 查状态：roborock status --device_id "xxx"
• 开始清扫：roborock command --device_id "xxx" start
• 回充：roborock command --device_id "xxx" home
• 查耗材：roborock consumables --device_id "xxx"
• 扫指定房间：先roborock rooms --device_id "xxx"获取房间ID，再roborock command --device_id "xxx" segment_clean --rooms 16,17

输入与输出

见下方输入与输出表格。

风险提示

• 需确保扫地机器人处于联网状态，离线时命令会失败
• 设备ID错误会导致”Device not found”，请通过list-devices核对
• 认证过期时需重新执行login登录
• 分区清扫前务必确认房间ID正确，避免误扫其他区域

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/dru-ca/robo-rock/SKILL.md
来源类型：GitHub仓库