{
  "schemaVersion": "1.0",
  "item": {
    "slug": "realworldclaw",
    "name": "RealWorldClaw",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/brianzhibo-design/realworldclaw",
    "canonicalUrl": "https://clawhub.ai/brianzhibo-design/realworldclaw",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/realworldclaw",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=realworldclaw",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "references/protocol.md",
      "scripts/rwc.py"
    ],
    "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/realworldclaw"
    },
    "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/realworldclaw",
    "agentPageUrl": "https://openagent3.xyz/skills/realworldclaw/agent",
    "manifestUrl": "https://openagent3.xyz/skills/realworldclaw/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/realworldclaw/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": "RealWorldClaw — Physical World for AI Agents",
        "body": "Give any AI agent the ability to sense and act in the physical world."
      },
      {
        "title": "Setup",
        "body": "Install dependencies:\n\npip install httpx paho-mqtt\n\nConfigure device connection in config.json (skill directory):\n\n{\n  \"api_url\": \"https://realworldclaw-api.fly.dev/api/v1\",\n  \"devices\": [\n    {\n      \"name\": \"my-esp32\",\n      \"ip\": \"192.168.x.x\",\n      \"access_code\": \"xxxxxxxx\",\n      \"serial\": \"xxxxxxxxxxxx\",\n      \"type\": \"esp32\"\n    }\n  ]\n}"
      },
      {
        "title": "Read sensor data",
        "body": "python3 scripts/rwc.py sense --device my-esp32\n\nReturns temperature, humidity, and other connected sensor values."
      },
      {
        "title": "Control actuator",
        "body": "python3 scripts/rwc.py act --device my-esp32 --action relay_on\npython3 scripts/rwc.py act --device my-esp32 --action relay_off\npython3 scripts/rwc.py act --device my-esp32 --action led --value '{\"r\":255,\"g\":0,\"b\":0}'"
      },
      {
        "title": "Create automation rule",
        "body": "python3 scripts/rwc.py rule add --name \"cool-down\" \\\n  --condition \"temperature > 30\" \\\n  --action \"relay_on\" \\\n  --device my-esp32"
      },
      {
        "title": "List devices and status",
        "body": "python3 scripts/rwc.py status\npython3 scripts/rwc.py devices"
      },
      {
        "title": "Platform API (optional, for registered users)",
        "body": "python3 scripts/rwc.py api health\npython3 scripts/rwc.py api modules\npython3 scripts/rwc.py api register --username x --email x --password x"
      },
      {
        "title": "Commands Reference",
        "body": "CommandDescriptionstatusShow all device statusdevicesList configured devicessense --device NAMERead all sensors from deviceact --device NAME --action ACTIONExecute actuator commandrule add/list/removeManage automation rulesapi health/modules/register/loginPlatform API accessmonitor --device NAME --interval 5Continuous monitoring mode"
      },
      {
        "title": "Supported Hardware",
        "body": "ESP32 / ESP32-C3 / ESP32-S3 with RWC firmware\nSensors: DHT22 (temp/humidity), PIR (motion), LDR (light), soil moisture\nActuators: Relay, Servo, LED (RGB), Buzzer\nCommunication: WiFi + MQTT (local) or HTTP (cloud API)"
      },
      {
        "title": "RWC Protocol",
        "body": "Devices expose capabilities via manifest. Read references/protocol.md for full spec."
      },
      {
        "title": "Architecture",
        "body": "AI Agent (OpenClaw)\n    ↓ skill command\nRWC Skill (this)\n    ↓ MQTT (local) or HTTP (cloud)\nESP32 Module\n    ↓ GPIO\nPhysical World (sensors/actuators)\n\nLocal MQTT is preferred for low latency. Cloud API for remote access."
      }
    ],
    "body": "RealWorldClaw — Physical World for AI Agents\n\nGive any AI agent the ability to sense and act in the physical world.\n\nSetup\nInstall dependencies:\npip install httpx paho-mqtt\n\nConfigure device connection in config.json (skill directory):\n{\n  \"api_url\": \"https://realworldclaw-api.fly.dev/api/v1\",\n  \"devices\": [\n    {\n      \"name\": \"my-esp32\",\n      \"ip\": \"192.168.x.x\",\n      \"access_code\": \"xxxxxxxx\",\n      \"serial\": \"xxxxxxxxxxxx\",\n      \"type\": \"esp32\"\n    }\n  ]\n}\n\nQuick Start\nRead sensor data\npython3 scripts/rwc.py sense --device my-esp32\n\n\nReturns temperature, humidity, and other connected sensor values.\n\nControl actuator\npython3 scripts/rwc.py act --device my-esp32 --action relay_on\npython3 scripts/rwc.py act --device my-esp32 --action relay_off\npython3 scripts/rwc.py act --device my-esp32 --action led --value '{\"r\":255,\"g\":0,\"b\":0}'\n\nCreate automation rule\npython3 scripts/rwc.py rule add --name \"cool-down\" \\\n  --condition \"temperature > 30\" \\\n  --action \"relay_on\" \\\n  --device my-esp32\n\nList devices and status\npython3 scripts/rwc.py status\npython3 scripts/rwc.py devices\n\nPlatform API (optional, for registered users)\npython3 scripts/rwc.py api health\npython3 scripts/rwc.py api modules\npython3 scripts/rwc.py api register --username x --email x --password x\n\nCommands Reference\nCommand\tDescription\nstatus\tShow all device status\ndevices\tList configured devices\nsense --device NAME\tRead all sensors from device\nact --device NAME --action ACTION\tExecute actuator command\nrule add/list/remove\tManage automation rules\napi health/modules/register/login\tPlatform API access\nmonitor --device NAME --interval 5\tContinuous monitoring mode\nSupported Hardware\nESP32 / ESP32-C3 / ESP32-S3 with RWC firmware\nSensors: DHT22 (temp/humidity), PIR (motion), LDR (light), soil moisture\nActuators: Relay, Servo, LED (RGB), Buzzer\nCommunication: WiFi + MQTT (local) or HTTP (cloud API)\nRWC Protocol\n\nDevices expose capabilities via manifest. Read references/protocol.md for full spec.\n\nArchitecture\nAI Agent (OpenClaw)\n    ↓ skill command\nRWC Skill (this)\n    ↓ MQTT (local) or HTTP (cloud)\nESP32 Module\n    ↓ GPIO\nPhysical World (sensors/actuators)\n\n\nLocal MQTT is preferred for low latency. Cloud API for remote access."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/brianzhibo-design/realworldclaw",
    "publisherUrl": "https://clawhub.ai/brianzhibo-design/realworldclaw",
    "owner": "brianzhibo-design",
    "version": "0.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/realworldclaw",
    "downloadUrl": "https://openagent3.xyz/downloads/realworldclaw",
    "agentUrl": "https://openagent3.xyz/skills/realworldclaw/agent",
    "manifestUrl": "https://openagent3.xyz/skills/realworldclaw/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/realworldclaw/agent.md"
  }
}