{
  "schemaVersion": "1.0",
  "item": {
    "slug": "robo-rock",
    "name": "Roborock Vacuum Control",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/dru-ca/robo-rock",
    "canonicalUrl": "https://clawhub.ai/dru-ca/robo-rock",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/robo-rock",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=robo-rock",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/robo-rock"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/robo-rock",
    "agentPageUrl": "https://openagent3.xyz/skills/robo-rock/agent",
    "manifestUrl": "https://openagent3.xyz/skills/robo-rock/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/robo-rock/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Roborock Vacuum Control",
        "body": "Control Roborock robot vacuums via the roborock CLI."
      },
      {
        "title": "1. Install CLI",
        "body": "pipx install python-roborock"
      },
      {
        "title": "2. Login to Roborock Account",
        "body": "roborock login\n\nEnter your Roborock/Xiaomi Home app email and password."
      },
      {
        "title": "3. Find Your Device ID",
        "body": "roborock list-devices\n\nNote your device ID (looks like AbCdEf123456789XyZ)."
      },
      {
        "title": "4. Store Device ID (Optional)",
        "body": "Add to your TOOLS.md for easy reference:\n\n## Roborock Vacuum\n- **Device ID:** your-device-id-here\n- **Model:** Roborock S7 Max Ultra (or your model)"
      },
      {
        "title": "Quick Commands",
        "body": "All commands need --device_id \"YOUR_DEVICE_ID\" — replace with your actual device ID."
      },
      {
        "title": "Check Status",
        "body": "roborock status --device_id \"YOUR_DEVICE_ID\""
      },
      {
        "title": "Start Cleaning",
        "body": "roborock command --device_id \"YOUR_DEVICE_ID\" start"
      },
      {
        "title": "Stop/Pause",
        "body": "roborock command --device_id \"YOUR_DEVICE_ID\" stop\nroborock command --device_id \"YOUR_DEVICE_ID\" pause"
      },
      {
        "title": "Return to Dock",
        "body": "roborock command --device_id \"YOUR_DEVICE_ID\" home"
      },
      {
        "title": "Clean Specific Room",
        "body": "First get room IDs:\n\nroborock rooms --device_id \"YOUR_DEVICE_ID\"\n\nThen clean specific rooms:\n\nroborock command --device_id \"YOUR_DEVICE_ID\" segment_clean --rooms 16,17"
      },
      {
        "title": "Check Consumables",
        "body": "roborock consumables --device_id \"YOUR_DEVICE_ID\"\n\nShows filter, brush, sensor lifespans."
      },
      {
        "title": "Reset Consumable",
        "body": "roborock reset-consumable filter --device_id \"YOUR_DEVICE_ID\"\nroborock reset-consumable main_brush --device_id \"YOUR_DEVICE_ID\"\nroborock reset-consumable side_brush --device_id \"YOUR_DEVICE_ID\""
      },
      {
        "title": "Last Clean Record",
        "body": "roborock clean-record --device_id \"YOUR_DEVICE_ID\""
      },
      {
        "title": "Clean Summary (All Time)",
        "body": "roborock clean-summary --device_id \"YOUR_DEVICE_ID\""
      },
      {
        "title": "Get Maps",
        "body": "roborock maps --device_id \"YOUR_DEVICE_ID\""
      },
      {
        "title": "Cache Home Layout",
        "body": "roborock home"
      },
      {
        "title": "Save Map Image",
        "body": "roborock map-image --device_id \"YOUR_DEVICE_ID\" --output /tmp/vacuum-map.png"
      },
      {
        "title": "Room Features",
        "body": "roborock features --device_id \"YOUR_DEVICE_ID\""
      },
      {
        "title": "Volume",
        "body": "roborock volume --device_id \"YOUR_DEVICE_ID\"\nroborock set-volume 50 --device_id \"YOUR_DEVICE_ID\""
      },
      {
        "title": "Do Not Disturb",
        "body": "roborock dnd --device_id \"YOUR_DEVICE_ID\""
      },
      {
        "title": "LED Status",
        "body": "roborock led-status --device_id \"YOUR_DEVICE_ID\""
      },
      {
        "title": "Child Lock",
        "body": "roborock child-lock --device_id \"YOUR_DEVICE_ID\""
      },
      {
        "title": "Interactive Session",
        "body": "For multiple commands without repeating device ID:\n\nroborock session --device_id \"YOUR_DEVICE_ID\""
      },
      {
        "title": "Troubleshooting",
        "body": "Commands fail silently:\n\nCheck login: roborock login\nUse debug mode: roborock -d status --device_id \"YOUR_DEVICE_ID\"\nEnsure vacuum is online and connected to WiFi\n\n\"Device not found\":\n\nRun roborock list-devices to verify device ID\nMake sure you're logged into the correct Roborock account\n\n\"Authentication failed\":\n\nRe-run roborock login\nCheck you're using the same account as your Xiaomi Home / Roborock app"
      },
      {
        "title": "Common Tasks",
        "body": "\"Vacuum the house\":\n\nroborock command --device_id \"YOUR_DEVICE_ID\" start\n\n\"Vacuum the kitchen\":\n\nroborock rooms --device_id \"YOUR_DEVICE_ID\"  # find kitchen room ID\nroborock command --device_id \"YOUR_DEVICE_ID\" segment_clean --rooms <kitchen_id>\n\n\"Is the vacuum done?\":\n\nroborock status --device_id \"YOUR_DEVICE_ID\"\n\n\"Send vacuum home\":\n\nroborock command --device_id \"YOUR_DEVICE_ID\" home\n\n\"When did it last clean?\":\n\nroborock clean-record --device_id \"YOUR_DEVICE_ID\"\n\n\"Check brush/filter life\":\n\nroborock consumables --device_id \"YOUR_DEVICE_ID\""
      },
      {
        "title": "Supported Models",
        "body": "Works with most Roborock vacuums including:\n\nRoborock S series (S4, S5, S6, S7, S8)\nRoborock Q series (Q5, Q7, Q8)\nRoborock E series\nXiaomi Mi Robot Vacuum (Roborock-based)"
      },
      {
        "title": "Credits",
        "body": "Uses the python-roborock library."
      }
    ],
    "body": "Roborock Vacuum Control\n\nControl Roborock robot vacuums via the roborock CLI.\n\nFirst-Time Setup\n1. Install CLI\npipx install python-roborock\n\n2. Login to Roborock Account\nroborock login\n\n\nEnter your Roborock/Xiaomi Home app email and password.\n\n3. Find Your Device ID\nroborock list-devices\n\n\nNote your device ID (looks like AbCdEf123456789XyZ).\n\n4. Store Device ID (Optional)\n\nAdd to your TOOLS.md for easy reference:\n\n## Roborock Vacuum\n- **Device ID:** your-device-id-here\n- **Model:** Roborock S7 Max Ultra (or your model)\n\nQuick Commands\n\nAll commands need --device_id \"YOUR_DEVICE_ID\" — replace with your actual device ID.\n\nCheck Status\nroborock status --device_id \"YOUR_DEVICE_ID\"\n\nStart Cleaning\nroborock command --device_id \"YOUR_DEVICE_ID\" start\n\nStop/Pause\nroborock command --device_id \"YOUR_DEVICE_ID\" stop\nroborock command --device_id \"YOUR_DEVICE_ID\" pause\n\nReturn to Dock\nroborock command --device_id \"YOUR_DEVICE_ID\" home\n\nClean Specific Room\n\nFirst get room IDs:\n\nroborock rooms --device_id \"YOUR_DEVICE_ID\"\n\n\nThen clean specific rooms:\n\nroborock command --device_id \"YOUR_DEVICE_ID\" segment_clean --rooms 16,17\n\nMaintenance Commands\nCheck Consumables\nroborock consumables --device_id \"YOUR_DEVICE_ID\"\n\n\nShows filter, brush, sensor lifespans.\n\nReset Consumable\nroborock reset-consumable filter --device_id \"YOUR_DEVICE_ID\"\nroborock reset-consumable main_brush --device_id \"YOUR_DEVICE_ID\"\nroborock reset-consumable side_brush --device_id \"YOUR_DEVICE_ID\"\n\nLast Clean Record\nroborock clean-record --device_id \"YOUR_DEVICE_ID\"\n\nClean Summary (All Time)\nroborock clean-summary --device_id \"YOUR_DEVICE_ID\"\n\nMaps & Rooms\nGet Maps\nroborock maps --device_id \"YOUR_DEVICE_ID\"\n\nCache Home Layout\nroborock home\n\nSave Map Image\nroborock map-image --device_id \"YOUR_DEVICE_ID\" --output /tmp/vacuum-map.png\n\nRoom Features\nroborock features --device_id \"YOUR_DEVICE_ID\"\n\nSettings\nVolume\nroborock volume --device_id \"YOUR_DEVICE_ID\"\nroborock set-volume 50 --device_id \"YOUR_DEVICE_ID\"\n\nDo Not Disturb\nroborock dnd --device_id \"YOUR_DEVICE_ID\"\n\nLED Status\nroborock led-status --device_id \"YOUR_DEVICE_ID\"\n\nChild Lock\nroborock child-lock --device_id \"YOUR_DEVICE_ID\"\n\nInteractive Session\n\nFor multiple commands without repeating device ID:\n\nroborock session --device_id \"YOUR_DEVICE_ID\"\n\nTroubleshooting\n\nCommands fail silently:\n\nCheck login: roborock login\nUse debug mode: roborock -d status --device_id \"YOUR_DEVICE_ID\"\nEnsure vacuum is online and connected to WiFi\n\n\"Device not found\":\n\nRun roborock list-devices to verify device ID\nMake sure you're logged into the correct Roborock account\n\n\"Authentication failed\":\n\nRe-run roborock login\nCheck you're using the same account as your Xiaomi Home / Roborock app\nCommon Tasks\n\n\"Vacuum the house\":\n\nroborock command --device_id \"YOUR_DEVICE_ID\" start\n\n\n\"Vacuum the kitchen\":\n\nroborock rooms --device_id \"YOUR_DEVICE_ID\"  # find kitchen room ID\nroborock command --device_id \"YOUR_DEVICE_ID\" segment_clean --rooms <kitchen_id>\n\n\n\"Is the vacuum done?\":\n\nroborock status --device_id \"YOUR_DEVICE_ID\"\n\n\n\"Send vacuum home\":\n\nroborock command --device_id \"YOUR_DEVICE_ID\" home\n\n\n\"When did it last clean?\":\n\nroborock clean-record --device_id \"YOUR_DEVICE_ID\"\n\n\n\"Check brush/filter life\":\n\nroborock consumables --device_id \"YOUR_DEVICE_ID\"\n\nSupported Models\n\nWorks with most Roborock vacuums including:\n\nRoborock S series (S4, S5, S6, S7, S8)\nRoborock Q series (Q5, Q7, Q8)\nRoborock E series\nXiaomi Mi Robot Vacuum (Roborock-based)\nCredits\n\nUses the python-roborock library."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/dru-ca/robo-rock",
    "publisherUrl": "https://clawhub.ai/dru-ca/robo-rock",
    "owner": "dru-ca",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/robo-rock",
    "downloadUrl": "https://openagent3.xyz/downloads/robo-rock",
    "agentUrl": "https://openagent3.xyz/skills/robo-rock/agent",
    "manifestUrl": "https://openagent3.xyz/skills/robo-rock/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/robo-rock/agent.md"
  }
}