How do I install the Realworldclaw skill?

Run npx skillmds@latest add johnalbertini14-glitch/realworldclaw in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Realworldclaw safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Realworldclaw?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Realworldclaw free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Realworldclaw?

johnalbertini14-glitch (@johnalbertini14-glitch) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Realworldclaw by johnalbertini14-glitch

Name: Realworldclaw
Rating: 4.2 (5 reviews)
Author: johnalbertini14-glitch

Realworldclaw

Give your AI agent physical world capabilities via RealWorldClaw — control ESP32 modules, read sensors (temperature, humidity, motion), actuate relays/servos/LEDs, and create automation rules. Use when: (1) controlling IoT/ESP32 hardware, (2) reading sensor data, (3) automating physical actions based on conditions, (4) managing RWC-compatible devices, (5) 3D printing related device control. NOT for: pure software tasks, cloud-only APIs unrelated to physical devices.

File contents

RealWorldClaw — Physical World for AI Agents

Give any AI agent the ability to sense and act in the physical world.

Setup

Install dependencies:

pip install httpx paho-mqtt

Configure device connection in config.json (skill directory):

{
  "api_url": "https://realworldclaw-api.fly.dev/api/v1",
  "devices": [
    {
      "name": "my-esp32",
      "ip": "192.168.x.x",
      "access_code": "xxxxxxxx",
      "serial": "xxxxxxxxxxxx",
      "type": "esp32"
    }
  ]
}

Quick Start

Read sensor data

python3 scripts/rwc.py sense --device my-esp32

Returns temperature, humidity, and other connected sensor values.

Control actuator

python3 scripts/rwc.py act --device my-esp32 --action relay_on
python3 scripts/rwc.py act --device my-esp32 --action relay_off
python3 scripts/rwc.py act --device my-esp32 --action led --value '{"r":255,"g":0,"b":0}'

Create automation rule

python3 scripts/rwc.py rule add --name "cool-down" \
  --condition "temperature > 30" \
  --action "relay_on" \
  --device my-esp32

List devices and status

python3 scripts/rwc.py status
python3 scripts/rwc.py devices

Platform API (optional, for registered users)

python3 scripts/rwc.py api health
python3 scripts/rwc.py api modules
python3 scripts/rwc.py api register --username x --email x --password x

Commands Reference

Command	Description
`status`	Show all device status
`devices`	List configured devices
`sense --device NAME`	Read all sensors from device
`act --device NAME --action ACTION`	Execute actuator command
`rule add/list/remove`	Manage automation rules
`api health/modules/register/login`	Platform API access
`monitor --device NAME --interval 5`	Continuous monitoring mode

Supported Hardware

ESP32 / ESP32-C3 / ESP32-S3 with RWC firmware
Sensors: DHT22 (temp/humidity), PIR (motion), LDR (light), soil moisture
Actuators: Relay, Servo, LED (RGB), Buzzer
Communication: WiFi + MQTT (local) or HTTP (cloud API)

RWC Protocol

Devices expose capabilities via manifest. Read references/protocol.md for full spec.

Architecture

AI Agent (OpenClaw)
    ↓ skill command
RWC Skill (this)
    ↓ MQTT (local) or HTTP (cloud)
ESP32 Module
    ↓ GPIO
Physical World (sensors/actuators)

Local MQTT is preferred for low latency. Cloud API for remote access.

---name: realworldclawdescription: Give your AI agent physical world capabilities via RealWorldClaw — control ESP32 modules, read sensors (temperature, humidity, motion), actuate relays/servos/LEDs, and create automation rules. Use when: (1) controlling IoT/ESP32 hardware, (2) reading sensor data, (3) automating physical actions based on conditions, (4) managing RWC-compatible devices, (5) 3D printing related device control. NOT for: pure software tasks, cloud-only APIs unrelated to physical devices.---# RealWorldClaw — Physical World for AI AgentsGive any AI agent the ability to sense and act in the physical world.## Setup1. Install dependencies:```bashpip install httpx paho-mqtt```2. Configure device connection in `config.json` (skill directory):```json{ "api_url": "https://realworldclaw-api.fly.dev/api/v1", "devices": [ { "name": "my-esp32", "ip": "192.168.x.x", "access_code": "xxxxxxxx", "serial": "xxxxxxxxxxxx", "type": "esp32" } ]}```## Quick Start### Read sensor data```bashpython3 scripts/rwc.py sense --device my-esp32```Returns temperature, humidity, and other connected sensor values.### Control actuator```bashpython3 scripts/rwc.py act --device my-esp32 --action relay_onpython3 scripts/rwc.py act --device my-esp32 --action relay_offpython3 scripts/rwc.py act --device my-esp32 --action led --value '{"r":255,"g":0,"b":0}'```### Create automation rule```bashpython3 scripts/rwc.py rule add --name "cool-down" \ --condition "temperature > 30" \ --action "relay_on" \ --device my-esp32```### List devices and status```bashpython3 scripts/rwc.py statuspython3 scripts/rwc.py devices```### Platform API (optional, for registered users)```bashpython3 scripts/rwc.py api healthpython3 scripts/rwc.py api modulespython3 scripts/rwc.py api register --username x --email x --password x```## Commands Reference| Command | Description ||---------|-------------|| `status` | Show all device status || `devices` | List configured devices || `sense --device NAME` | Read all sensors from device || `act --device NAME --action ACTION` | Execute actuator command || `rule add/list/remove` | Manage automation rules || `api health/modules/register/login` | Platform API access || `monitor --device NAME --interval 5` | Continuous monitoring mode |## Supported Hardware- ESP32 / ESP32-C3 / ESP32-S3 with RWC firmware- Sensors: DHT22 (temp/humidity), PIR (motion), LDR (light), soil moisture- Actuators: Relay, Servo, LED (RGB), Buzzer- Communication: WiFi + MQTT (local) or HTTP (cloud API)## RWC ProtocolDevices expose capabilities via manifest. Read `references/protocol.md` for full spec.## Architecture```AI Agent (OpenClaw) ↓ skill commandRWC Skill (this) ↓ MQTT (local) or HTTP (cloud)ESP32 Module ↓ GPIOPhysical World (sensors/actuators)```Local MQTT is preferred for low latency. Cloud API for remote access.

Frequently asked questions