（7918期）VacuumControl – 智能家居扫地机远程控制台

智能家居扫地机远程控制台 基于 roborock-cli 官方工具的石头扫地机全功能控制方案，支持 uv 快速安装、15+ CLI 指令集、房间级清洁调度与自动化脚本集成，实现 IoT 设备的 Agent 化智能管理。 使用说明 核心用法 VacuumControl 是一款面向石头扫地机（Roborock）的智能控制 Skill，通过封装 roborock-cli 命令行工具，为 Agent 提供完整的设备管理能力。核心工作流分为四阶段： 1. 环境准备：通过 uv 包管理器快速安装 roborock-cli，支持 macOS/Linux/Windows 跨平台。安装后执行 roborock-cli auth 完成 Roborock 账号认证，认证信息持久化存储于 ~/.cache/roborock-cli/user_data.json。 2. 设备发现与查询：使用 devices 命令获取设备列表，status 获取实时状态（含电量、清洁模式、房间地图 segment_id），routines 读取智能场景，map 导出可视化地图。所有输出为标准 JSON，可直接用 jq 解析供下游流程调用。 3. 精准控制：支持全屋/单房间/多遍清洁调度（start-clean -s -r 参数），实时暂停/恢复/停止，基座集尘与拖布清洗，音量调节与勿扰时段设置。-d 参数支持设备名模糊匹配，简化多设备场景操作。 4. 自动化集成：提供退出码驱动的脚本错误处理机制（0-5, 130），环境变量自定义缓存路径，API 频率限制诊断与缓存重建方案。适合集成至 cron 定时任务、Home Assistant 或自定义智能家居中枢。 显著优点 官方工具背书：基于 roborock-cli 官方 Python 实现，非逆向工程，协议兼容性与稳定性有保障 零依赖快速部署：uv 单工具管理 Python 运行时与包安装，避免系统 Python 污染，5 分钟内完成环境搭建 结构化数据流：全命令 JSON 输出 + jq 解析链路，天然适配 Agent 自动化决策与多系统对接 精细化房间控制：通过 segment_id 实现房间级清洁策略，支持清洁次数、吸力档位等参数组合 完整错误体系：6 级退出码 + 结构化错误 JSON，支持程序化的异常捕获与自愈（如认证过期自动重登、缓存损坏自动重建） 潜在缺点与局限性 V1 协议门槛：除 auth/devices 外所有控制命令要求设备支持 V1 协议，部分老旧机型可能不兼容（近年新机普遍支持） API 频率限制：gethomedata 调用受限 5 次/小时、40 次/天，高频轮询场景需依赖本地缓存机制 TTY 交互依赖：认证流程必须在交互式终端执行，无法完全无人值守自动化，需人工介入验证码输入 网络稳定性敏感：设备指令经 Roborock 云服务中转，非局域网直连，断网或云服务故障时将失效 Windows 兼容性瑕疵：特定 Windows 安全策略下可能出现 os error 4551，需手动清理 uv 缓存或指定 Python 版本修复 适合的目标群体 智能家居自动化爱好者：希望将扫地机纳入 Home Assistant、Node-RED 等中枢统一调度 开发者与运维人员：需编写定时清洁脚本、基于设备状态触发其他 IoT 联动的技术用户 多设备家庭用户：管理 2 台及以上 Roborock 设备，需快速切换控制的场景 精细化清洁需求者：希望对不同房间设定差异化清洁策略（厨房重油污区 2 遍、卧室静音模式等） 常规使用风险 认证状态漂移：Roborock Token 存在有效期，长期运行的自动化脚本可能因 exit_code=2 中断，需设计重认证逻辑 缓存一致性问题：设备缓存（device_cache.pkl）可能因 API 限流或写入失败变为 0 字节，导致后续命令异常，建议定期监控缓存文件大小 并发控制缺失：Skill 本身不实现设备状态锁，多脚本同时下发冲突指令可能导致行为未定义（如清洁中触发回充） 验证码轰炸风险：错误实现认证重试逻辑可能触发频繁邮件验证码，影响用户体验甚至触发账号风控 隐私数据本地存储：认证凭证与设备地图缓存以明文/ pickle 形式落盘，共享环境或容器化部署时需注意权限隔离 原始说明 教 OpenClaw 如何安装、配置和使用 roborock-cli（石头扫地机 CLI 控制工具）。 涵盖：uv 安装、认证流程、15 个 CLI 命令的使用、设备控制、错误诊断与恢复。 当用户提到"扫地机"、"roborock"、"扫地"、"拖地"、"清洁机器人"、"回充"、"集尘"、 "洗拖布"、"勿扰模式...