Add prominent simulator support documentation

- No robot required! ClawBody works with MuJoCo simulator
- Updated README with simulator quick start guide
- Updated landing page with simulator callout section
- Updated SKILL.md with simulator instructions
- Added simulation/mujoco tags for discoverability

This makes ClawBody accessible to everyone, even without
physical Reachy Mini hardware.

README.md

@@ -23,6 +23,8 @@ tags:
  - multimodal
  - vision
  - expressive-robot
+ - simulation
+ - mujoco
 ---
 
 # 🦞🤖 ClawBody
@@ -34,6 +36,29 @@ ClawBody combines OpenClaw's AI intelligence with Reachy Mini's expressive robot
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
 [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
 
+---
+
+## 🎮 No Robot? No Problem!
+
+**You don't need a physical Reachy Mini robot to use ClawBody!**
+
+ClawBody works with the [Reachy Mini Simulator](https://huggingface.co/docs/reachy_mini/platforms/simulation/get_started), a MuJoCo-based physics simulation that runs on your computer. Watch Clawson move and express emotions on screen while you talk to your OpenClaw agent.
+
+```bash
+# Install simulator support
+pip install "reachy-mini[mujoco]"
+
+# Start the simulator (opens a 3D window)
+reachy-mini-daemon --sim
+
+# In another terminal, run ClawBody
+clawbody --gradio
+```
+
+> 🍎 **Mac Users**: Use `mjpython -m reachy_mini.daemon.app.main --sim` instead.
+
+---
+
 ## ✨ Features
 
 - **🎤 Real-time Voice Conversation**: OpenAI Realtime API for sub-second response latency
@@ -41,6 +66,7 @@ ClawBody combines OpenClaw's AI intelligence with Reachy Mini's expressive robot
 - **👀 Vision**: See through the robot's camera and describe the environment
 - **💃 Expressive Movements**: Natural head movements, emotions, dances, and audio-driven wobble
 - **🦞 Clawson Embodied**: Your friendly space lobster AI assistant, now with a body!
+- **🖥️ Simulator Support**: Works with or without physical hardware
 
 ## 🏗️ Architecture
 
@@ -51,7 +77,7 @@ ClawBody combines OpenClaw's AI intelligence with Reachy Mini's expressive robot
                               │
                               ▼
 ┌─────────────────────────────────────────────────────────────────┐
-│                    Reachy Mini Robot                             │
+│              Reachy Mini Robot (or Simulator)                    │
 │  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────┐  │
 │  │ Microphone  │  │   Camera    │  │   Movement System       │  │
 │  │  (input)    │  │  (vision)   │  │ (head, antennas, body)  │  │
@@ -86,10 +112,15 @@ ClawBody combines OpenClaw's AI intelligence with Reachy Mini's expressive robot
 
 ## 📋 Prerequisites
 
-### Hardware
+### Option A: With Physical Robot
 - [Reachy Mini](https://www.pollen-robotics.com/reachy-mini/) robot (Wireless or Lite)
 
-### Software
+### Option B: With Simulator (No Hardware Required!)
+- Any computer with Python 3.11+
+- Install: `pip install "reachy-mini[mujoco]"`
+- [Simulation Setup Guide](https://huggingface.co/docs/reachy_mini/platforms/simulation/get_started)
+
+### Software (Both Options)
 - Python 3.11+
 - [Reachy Mini SDK](https://github.com/pollen-robotics/reachy_mini) installed
 - [OpenClaw](https://github.com/openclaw/openclaw) gateway running
@@ -97,33 +128,44 @@ ClawBody combines OpenClaw's AI intelligence with Reachy Mini's expressive robot
 
 ## 🚀 Installation
 
-### On the Reachy Mini Robot
+### Quick Start with Simulator
 
 ```bash
-# SSH into the robot
-ssh pollen@reachy-mini.local
-
-# Clone the repository
-git clone https://github.com/yourusername/clawbody.git
+# Clone ClawBody
+git clone https://github.com/tomrikert/clawbody
 cd clawbody
 
-# Install in the apps virtual environment
-/venvs/apps_venv/bin/pip install -e .
+# Create virtual environment
+python -m venv .venv
+source .venv/bin/activate
+
+# Install ClawBody + simulator support
+pip install -e .
+pip install "reachy-mini[mujoco]"
+
+# Configure (see Configuration section)
+cp .env.example .env
+# Edit .env with your keys
+
+# Terminal 1: Start the simulator
+reachy-mini-daemon --sim
+
+# Terminal 2: Run ClawBody
+clawbody --gradio
 ```
 
-### Using pip (Development)
+### On a Physical Reachy Mini Robot
 
 ```bash
+# SSH into the robot
+ssh pollen@reachy-mini.local
+
 # Clone the repository
-git clone https://github.com/yourusername/clawbody.git
+git clone https://github.com/tomrikert/clawbody
 cd clawbody
 
-# Create virtual environment
-python -m venv .venv
-source .venv/bin/activate
-
-# Install
-pip install -e .
+# Install in the apps virtual environment
+/venvs/apps_venv/bin/pip install -e .
 ```
 
 ## ⚙️ Configuration
@@ -141,7 +183,7 @@ cp .env.example .env
 OPENAI_API_KEY=sk-...your-key...
 
 # OpenClaw Gateway (required for AI responses)
-OPENCLAW_GATEWAY_URL=http://your-host-ip:18790
+OPENCLAW_GATEWAY_URL=http://localhost:18789  # or your host IP
 OPENCLAW_TOKEN=your-gateway-token
 OPENCLAW_AGENT_ID=main
 
@@ -151,7 +193,19 @@ OPENAI_VOICE=cedar
 
 ## 🎮 Usage
 
-### Console Mode
+### With Simulator
+
+```bash
+# Terminal 1: Start simulator
+reachy-mini-daemon --sim
+
+# Terminal 2: Run ClawBody with web UI (recommended for simulator)
+clawbody --gradio
+```
+
+The simulator opens a 3D window where you can watch the robot move. The Gradio web UI at http://localhost:7860 lets you interact via your browser's microphone.
+
+### With Physical Robot
 
 ```bash
 # Basic usage
@@ -164,19 +218,6 @@ clawbody --debug
 clawbody --robot-name my-reachy
 ```
 
-### Web UI Mode
-
-```bash
-# Launch Gradio interface
-clawbody --gradio
-```
-
-Then open http://localhost:7860 in your browser.
-
-### As a Reachy Mini App
-
-ClawBody registers as a Reachy Mini App, so you can launch it from the robot's dashboard after installation.
-
 ### CLI Options
 
 | Option | Description |
@@ -201,6 +242,20 @@ ClawBody gives Clawson these physical abilities:
 | **Speak** | Voice output through the robot's speaker |
 | **Listen** | Hear through the robot's microphone |
 
+## 🖥️ Simulator Features
+
+When running with the simulator:
+
+- **3D Visualization**: Watch Clawson's movements in real-time
+- **Scene Options**: Use `--scene minimal` to add objects (apple, duck, croissant)
+- **Full SDK Compatibility**: The simulator behaves exactly like a real robot
+- **Dashboard Access**: Visit http://localhost:8000 to see the robot dashboard
+
+```bash
+# Start simulator with objects on a table
+reachy-mini-daemon --sim --scene minimal
+```
+
 ## 📄 License
 
 This project is licensed under the Apache 2.0 License - see the [LICENSE](LICENSE) file for details.
@@ -209,15 +264,16 @@ This project is licensed under the Apache 2.0 License - see the [LICENSE](LICENS
 
 ClawBody builds on:
 
-- [Pollen Robotics](https://www.pollen-robotics.com/) - Reachy Mini robot and SDK
+- [Pollen Robotics](https://www.pollen-robotics.com/) - Reachy Mini robot, SDK, and simulator
 - [OpenClaw](https://github.com/openclaw/openclaw) - AI assistant framework (Clawson!)
 - [OpenAI](https://openai.com/) - Realtime API for voice I/O
+- [MuJoCo](https://mujoco.org/) - Physics simulation engine
 - [pollen-robotics/reachy_mini_conversation_app](https://huggingface.co/spaces/pollen-robotics/reachy_mini_conversation_app) - Movement and audio systems
 
 ## 🤝 Contributing
 
 Contributions are welcome! Please feel free to submit a Pull Request.
 
-- **This project**: [GitHub Issues](https://github.com/yourusername/clawbody/issues)
+- **This project**: [GitHub Issues](https://github.com/tomrikert/clawbody/issues)
 - **OpenClaw Skills**: Submit ClawBody as a skill to [ClawHub](https://docs.openclaw.ai/tools/clawhub)
 - **Reachy Mini Apps**: Submit to [Pollen Robotics](https://github.com/pollen-robotics)

index.html

@@ -30,14 +30,14 @@
                 intelligent responses from OpenClaw, and expressive robot movements.
             </p>
             <div class="hero-actions">
-                <a href="#features" class="btn primary">Explore features</a>
-                <a href="#how-it-works" class="btn ghost">See how it works</a>
+                <a href="#simulator" class="btn primary">🖥️ Try with Simulator</a>
+                <a href="#features" class="btn ghost">See features</a>
             </div>
             <div class="hero-badges">
                 <span>🎙️ OpenAI Realtime</span>
                 <span>🦞 OpenClaw Gateway</span>
                 <span>💃 Expressive movement</span>
-                <span>👀 Vision</span>
+                <span>🖥️ No robot required!</span>
             </div>
         </div>
         <div class="hero-visual">
@@ -45,6 +45,7 @@
                 <div class="architecture-preview">
 <pre>
   You speak → Reachy Mini 🎤
+          (or Simulator 🖥️)
                   ↓
          OpenAI Realtime API
       (speech recognition + TTS)
@@ -55,12 +56,40 @@
      Robot speaks & moves 🤖💃
 </pre>
                 </div>
-                <p class="caption">Hybrid architecture: OpenAI for voice I/O, OpenClaw for intelligence.</p>
+                <p class="caption">Works with physical robot OR MuJoCo simulator!</p>
             </div>
         </div>
     </div>
 </section>
 
+<section class="section simulator-callout" id="simulator">
+    <div class="story-card highlight">
+        <h2>🖥️ No Robot? No Problem!</h2>
+        <p class="story-text" style="font-size: 1.1rem;">
+            <strong>You don't need a physical Reachy Mini robot to use ClawBody!</strong><br><br>
+            ClawBody works with the Reachy Mini Simulator, a MuJoCo-based physics simulation 
+            that runs on your computer. Watch Clawson move and express emotions on screen 
+            while you talk to your OpenClaw agent.
+        </p>
+        <div class="architecture-preview" style="margin: 1.5rem 0;">
+<pre>
+# Install simulator support
+pip install "reachy-mini[mujoco]"
+
+# Start the simulator (opens 3D window)
+reachy-mini-daemon --sim
+
+# In another terminal, run ClawBody
+clawbody --gradio
+</pre>
+        </div>
+        <p class="caption">🍎 Mac Users: Use <code>mjpython -m reachy_mini.daemon.app.main --sim</code> instead</p>
+        <a href="https://huggingface.co/docs/reachy_mini/platforms/simulation/get_started" class="btn primary" style="margin-top: 1rem;" target="_blank">
+            📚 Simulator Setup Guide
+        </a>
+    </div>
+</section>
+
 <section class="section" id="features">
     <div class="section-header">
         <h2>What's inside</h2>
@@ -90,9 +119,9 @@
             <p>Audio-driven head wobble, emotions, dances, and natural movements while speaking.</p>
         </div>
         <div class="feature-card">
-            <div class="icon">🎭</div>
-            <h3>Clawson embodied</h3>
-            <p>Your friendly space lobster AI assistant, now with a physical presence in the world.</p>
+            <div class="icon">🖥️</div>
+            <h3>Simulator support</h3>
+            <p>No robot? Run with MuJoCo simulator and watch Clawson move in a 3D window.</p>
         </div>
         <div class="feature-card">
             <div class="icon">⚡</div>
@@ -108,26 +137,25 @@
             <h3>How it works</h3>
             <p class="story-text">From speech to response in under a second</p>
             <ol class="story-list">
-                <li><span>🎤</span> Robot microphone captures your voice continuously.</li>
-                <li><span>🔇</span> Voice Activity Detection identifies when you stop speaking.</li>
-                <li><span>📝</span> OpenAI Realtime transcribes your speech instantly.</li>
-                <li><span>🦞</span> OpenClaw processes your message with full AI capabilities.</li>
-                <li><span>🔊</span> OpenAI Realtime speaks the response naturally.</li>
-                <li><span>🤖</span> Robot moves expressively while speaking.</li>
+                <li><span>🎤</span> Robot (or simulator) captures your voice</li>
+                <li><span>🔇</span> Voice Activity Detection identifies when you stop speaking</li>
+                <li><span>📝</span> OpenAI Realtime transcribes your speech instantly</li>
+                <li><span>🦞</span> OpenClaw processes your message with full AI capabilities</li>
+                <li><span>🔊</span> OpenAI Realtime speaks the response naturally</li>
+                <li><span>🤖</span> Robot moves expressively while speaking</li>
             </ol>
         </div>
         <div class="story-card secondary">
             <h3>Prerequisites</h3>
-            <p class="story-text">What you need to get started</p>
+            <p class="story-text">Choose your setup:</p>
             <div class="chips">
                 <span class="chip">🦞 OpenClaw Gateway</span>
                 <span class="chip">🔑 OpenAI API Key</span>
-                <span class="chip">🤖 Reachy Mini</span>
                 <span class="chip">🐍 Python 3.11+</span>
             </div>
             <p class="story-text" style="margin-top: 1rem;">
-                This app requires a running OpenClaw gateway on your network, 
-                an OpenAI API key with Realtime access, and a Reachy Mini robot.
+                <strong>Option A:</strong> 🤖 Physical Reachy Mini robot<br>
+                <strong>Option B:</strong> 🖥️ MuJoCo Simulator (free, no hardware!)
             </p>
             <a href="https://huggingface.co/spaces/tomrikert/clawbody/blob/main/README.md" class="btn ghost wide" style="margin-top: 1rem;">
                 View installation guide
@@ -139,25 +167,32 @@
 <section class="section">
     <div class="section-header">
         <h2>Quick start</h2>
-        <p class="intro">Get ClawBody running on your Reachy Mini</p>
+        <p class="intro">Get ClawBody running with the simulator</p>
     </div>
     <div class="story-card">
         <div class="architecture-preview">
 <pre>
-# SSH into your Reachy Mini
-ssh pollen@reachy-mini.local
-
-# Clone and install
-git clone https://huggingface.co/spaces/tomrikert/clawbody
+# Clone ClawBody
+git clone https://github.com/tomrikert/clawbody
 cd clawbody
+
+# Create virtual environment
+python -m venv .venv
+source .venv/bin/activate
+
+# Install ClawBody + simulator
 pip install -e .
+pip install "reachy-mini[mujoco]"
 
-# Configure (edit with your OpenClaw gateway URL and OpenAI key)
+# Configure (edit with your OpenClaw URL and OpenAI key)
 cp .env.example .env
 nano .env
 
-# Run ClawBody
-clawbody
+# Terminal 1: Start simulator
+reachy-mini-daemon --sim
+
+# Terminal 2: Run ClawBody
+clawbody --gradio
 </pre>
         </div>
     </div>
@@ -166,8 +201,10 @@ clawbody
 <footer class="footer">
     <p>
         ClawBody — giving OpenClaw a physical presence with Reachy Mini.<br>
-        Learn more about <a href="https://github.com/openclaw/openclaw">OpenClaw</a> and 
-        <a href="https://github.com/pollen-robotics/reachy_mini">Reachy Mini</a>.
+        <strong>Works with physical robot OR simulator!</strong><br><br>
+        Learn more about <a href="https://github.com/openclaw/openclaw">OpenClaw</a>, 
+        <a href="https://github.com/pollen-robotics/reachy_mini">Reachy Mini</a>, and
+        <a href="https://huggingface.co/docs/reachy_mini/platforms/simulation/get_started">the Simulator</a>.
     </p>
 </footer>
 

openclaw-skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: clawbody
-description: Give your OpenClaw AI agent a physical robot body with Reachy Mini. Voice conversation via OpenAI Realtime API, vision through camera, and expressive movements.
+description: Give your OpenClaw AI agent a physical robot body with Reachy Mini. Works with physical robot OR simulator! Voice conversation via OpenAI Realtime API, vision, and expressive movements.
 ---
 
 # ClawBody - Robot Body for OpenClaw
@@ -34,10 +34,15 @@ You speak → Reachy Mini 🎤
 
 ## Requirements
 
-### Hardware
+### Option A: Physical Robot
 - [Reachy Mini](https://github.com/pollen-robotics/reachy_mini) robot (Wireless or Lite)
 
-### Software
+### Option B: Simulator (No Hardware Required!)
+- Any computer with Python 3.11+
+- Install: `pip install "reachy-mini[mujoco]"`
+- [Simulator Setup Guide](https://huggingface.co/docs/reachy_mini/platforms/simulation/get_started)
+
+### Software (Both Options)
 - Python 3.11+
 - OpenAI API key with Realtime API access
 - OpenClaw gateway running on your network
@@ -68,6 +73,18 @@ OPENCLAW_TOKEN=your-gateway-token
 
 ## Usage
 
+### With Simulator (No Robot Required)
+
+```bash
+# Terminal 1: Start simulator
+reachy-mini-daemon --sim
+
+# Terminal 2: Run ClawBody
+clawbody --gradio
+```
+
+### With Physical Robot
+
 ```bash
 # Run ClawBody
 clawbody

style.css

@@ -317,6 +317,23 @@ a {
     background: linear-gradient(145deg, rgba(155, 89, 182, 0.1), rgba(255, 107, 107, 0.08));
 }
 
+.story-card.highlight {
+    background: linear-gradient(145deg, rgba(46, 204, 113, 0.15), rgba(52, 152, 219, 0.1));
+    border-color: rgba(46, 204, 113, 0.3);
+}
+
+.simulator-callout {
+    padding-top: 0;
+}
+
+.simulator-callout code {
+    background: rgba(0, 0, 0, 0.3);
+    padding: 0.2rem 0.5rem;
+    border-radius: 4px;
+    font-family: "SF Mono", "Fira Code", monospace;
+    font-size: 0.85rem;
+}
+
 .story-card h3 {
     margin-bottom: 0.8rem;
 }