← Back to Skills Marketplace
jru001

VacuumControl

by jru001 · GitHub ↗ · v1.3.0 · MIT-0
cross-platform ✓ Security Clean
345
Downloads
1
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install roborock-2014
Description
教 OpenClaw 如何安装、配置和使用 roborock-cli(石头扫地机 CLI 控制工具)。 涵盖:uv 安装、认证流程、15 个 CLI 命令的使用、设备控制、错误诊断与恢复。 当用户提到"扫地机"、"roborock"、"扫地"、"拖地"、"清洁机器人"、"回充"、"集尘"、 "洗拖布"、"勿扰模式...
Usage Guidance
This skill appears to be what it claims: instructions for installing and using roborock-cli. Before installing or running commands, verify the install scripts and binaries it tells you to execute — the guide uses curl | sh and PowerShell 'irm | iex' to install 'uv' (and then uv installs roborock-cli), which will fetch and run code from remote servers. If you prefer safer steps: manually inspect the installer URL, install uv and roborock-cli yourself from their official project pages, or run the install commands in a controlled environment. Note that authentication is interactive and stores credentials in ~/.cache/roborock-cli/user_data.json — treat that file as sensitive. If you do not want the agent to run shell installs or perform interactive auth, do not invoke this skill with autonomous shell access.
Capability Analysis
Type: OpenClaw Skill Name: roborock-2014 Version: 1.3.0 The skill bundle provides instructions for managing Roborock vacuum cleaners using the `roborock-cli` tool. It includes standard installation procedures via the `uv` package manager, authentication guidance, and comprehensive command references for device control and status monitoring. No malicious behaviors, data exfiltration, or harmful prompt injections were detected; the use of `curl | sh` in `SKILL.md` is the standard installation method for the `uv` tool and aligns with the stated purpose.
Capability Assessment
Purpose & Capability
Name and description match the content: SKILL.md and references/commands.md focus on installing, authenticating, querying, controlling, and scripting roborock-cli. No unrelated credentials, binaries, or config paths are requested.
Instruction Scope
Instructions stay within the stated purpose (install, auth, commands, troubleshooting). They reference only roborock-cli cache files (~/.cache/roborock-cli/*) and describe interactive auth behavior. Notably, auth is explicitly interactive (requires TTY) so the agent must not attempt automated non-interactive auth runs.
Install Mechanism
Although the skill itself has no install spec, the runtime instructions tell the agent to run remote installers: curl -LsSf https://astral.sh/uv/install.sh | sh and PowerShell irm https://astral.sh/uv/install.ps1 | iex, followed by uv tool install roborock-cli. Download-and-execute from remote URLs carries elevated risk and should be verified (source authenticity, integrity) before executing.
Credentials
The skill requests no environment variables or credentials. It documents two cache-related env vars (ROBOROCK_AUTH_CACHE, ROBOROCK_DEVICE_CACHE) which are reasonable for configuring where auth and device caches live.
Persistence & Privilege
always is false and the skill does not request elevated platform privileges or modify other skill configs. Autonomous invocation is allowed (default), but the SKILL.md limits interactive auth to a TTY, which constrains some autonomous actions.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install roborock-2014
  3. After installation, invoke the skill by name or use /roborock-2014
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.3.0
认证流程补充:提示用户账号邮箱可在 Roborock APP 中查看、设置和修改
v1.2.0
移除§5.5命令执行缓慢章节(属于SDK内部行为,不应暴露给用户)
v1.1.0
优化认证流程:防止 OpenClaw 重复运行 roborock-cli auth 导致验证码过期,改为等待用户输入验证码后再决定是否重新发送
v1.0.0
Initial release of VacuumControl skill for Roborock CLI: - Guides users through installation, configuration, and usage of roborock-cli using uv, including authentication and updates. - Provides step-by-step instructions for 15 CLI commands covering device queries, control actions (such as cleaning, docking, dust collection, mop washing, Do Not Disturb mode), and error handling. - Includes detailed troubleshooting for common issues and platform-specific errors (e.g. Windows os error 4551, API rate limits, slow command execution). - Offers practical guidance for automation script integration and parsing formatted JSON outputs using jq. - Skill triggers automatically for user queries involving Roborock devices or cleaning robots.
Metadata
Slug roborock-2014
Version 1.3.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 4
Frequently Asked Questions

What is VacuumControl?

教 OpenClaw 如何安装、配置和使用 roborock-cli(石头扫地机 CLI 控制工具)。 涵盖:uv 安装、认证流程、15 个 CLI 命令的使用、设备控制、错误诊断与恢复。 当用户提到"扫地机"、"roborock"、"扫地"、"拖地"、"清洁机器人"、"回充"、"集尘"、 "洗拖布"、"勿扰模式... It is an AI Agent Skill for Claude Code / OpenClaw, with 345 downloads so far.

How do I install VacuumControl?

Run "/install roborock-2014" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is VacuumControl free?

Yes, VacuumControl is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does VacuumControl support?

VacuumControl is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created VacuumControl?

It is built and maintained by jru001 (@jru001); the current version is v1.3.0.

💬 Comments