| # Reachy Mini Robot Body |
|
|
| Give your OpenClaw agent a physical presence with Reachy Mini robot. |
|
|
| ## Description |
|
|
| This skill enables OpenClaw to embody a Reachy Mini robot, allowing your AI assistant to: |
|
|
| - **See**: View the world through the robot's camera |
| - **Hear**: Listen to conversations via the robot's microphone |
| - **Speak**: Respond with natural voice through the robot's speaker |
| - **Move**: Express emotions and reactions through expressive head movements |
|
|
| Using OpenAI's Realtime API, the robot responds with sub-second latency for natural conversation flow. |
|
|
| ## Requirements |
|
|
| ### Hardware |
| - [Reachy Mini](https://www.hf.co/reachy-mini/) robot (Wireless or Lite version) |
| - The robot must be powered on and reachable on the network |
|
|
| ### Software |
| - Python 3.11+ |
| - OpenAI API key with Realtime API access |
| - OpenClaw gateway running (for extended capabilities) |
|
|
| ## Installation |
|
|
| ```bash |
| # Install the package |
| pip install reachy-mini-openclaw |
| |
| # Or from source |
| git clone https://github.com/yourusername/reachy_mini_openclaw.git |
| cd reachy_mini_openclaw |
| pip install -e . |
| ``` |
|
|
| ## Configuration |
|
|
| Create a `.env` file with your OpenAI API key: |
|
|
| ```bash |
| OPENAI_API_KEY=sk-your-key-here |
| OPENCLAW_GATEWAY_URL=http://localhost:18789 |
| ``` |
|
|
| ## Usage |
|
|
| ### Console Mode |
| ```bash |
| reachy-openclaw |
| ``` |
|
|
| ### Web UI Mode |
| ```bash |
| reachy-openclaw --gradio |
| ``` |
|
|
| ### As Reachy Mini App |
| Install from the robot's dashboard app store. |
|
|
| ## Features |
|
|
| ### Voice Conversation |
| Real-time voice interaction using OpenAI's Realtime API for natural, low-latency conversation. |
|
|
| ### Expressive Movements |
| The robot automatically: |
| - Nods and moves while speaking (audio-driven wobble) |
| - Looks toward speakers |
| - Expresses emotions through head movements |
| - Performs dances when appropriate |
|
|
| ### Vision |
| Ask the robot to describe what it sees: |
| > "What do you see in front of you?" |
|
|
| ### OpenClaw Integration |
| Full access to OpenClaw's tool ecosystem: |
| > "What's the weather like today?" |
| > "Add a reminder for tomorrow" |
| > "Turn on the living room lights" |
|
|
| ## Links |
|
|
| - [GitHub Repository](https://github.com/yourusername/reachy_mini_openclaw) |
| - [Reachy Mini SDK](https://github.com/pollen-robotics/reachy_mini) |
| - [OpenClaw Documentation](https://docs.openclaw.ai) |
|
|
| ## Author |
|
|
| Tom |
|
|
| ## License |
|
|
| Apache 2.0 |
|
|
