openclaw-voice git:20260812.c83047bC

Immutable. This exact content never changes and is served at /api/v1/blob/ff7387a0f4be4122.

# OpenClaw Voice Skill

Browser-based voice chat for OpenClaw agents.

## What It Does

Adds voice chat capability to your OpenClaw agent. Users can speak to your agent via a web browser and hear responses in real-time.

## Stack

- **STT**: faster-whisper (local, no API costs)
- **TTS**: ElevenLabs (cloud, high quality) or Chatterbox (self-hosted)
- **Transport**: WebSocket
- **Backend**: OpenClaw gateway (chatCompletions endpoint)

## Quick Setup

### 1. Enable Gateway Endpoint

Add to your `openclaw.json`:

```json
{
  "gateway": {
    "http": {
      "endpoints": {
        "chatCompletions": {
          "enabled": true
        }
      }
    }
  }
}
```

### 2. Add Voice Agent

```json
{
  "agents": {
    "list": [
      {
        "id": "voice",
        "workspace": "/path/to/your/workspace",
        "model": "anthropic/claude-sonnet-4-5"
      }
    ]
  }
}
```

### 3. Run the Server

```bash
# Clone and setup
git clone https://github.com/Purple-Horizons/openclaw-voice.git
cd openclaw-voice
uv sync  # or pip install -r requirements.txt

# Configure
cp .env.example .env
# Edit .env with your OPENCLAW_GATEWAY_URL, OPENCLAW_GATEWAY_TOKEN, ELEVENLABS_API_KEY

# Run
PYTHONPATH=. python -m src.server.main
```

### 4. Access

Open `http://localhost:8765` in your browser.

For HTTPS (required for mobile mic), use Tailscale Funnel or your own SSL.

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `OPENCLAW_GATEWAY_URL` | Yes* | OpenClaw gateway URL (e.g., `http://localhost:18789`) |
| `OPENCLAW_GATEWAY_TOKEN` | Yes* | Gateway auth token |
| `ELEVENLABS_API_KEY` | Recommended | For high-quality TTS |
| `OPENAI_API_KEY` | Fallback | Used if gateway not configured |

*Required for full agent integration. Falls back to direct OpenAI if not set.

## Features

- **Push-to-talk**: Hold button to speak
- **Continuous mode**: Hands-free, auto-listens after responses
- **Keyboard shortcut**: Spacebar toggles recording
- **Mobile support**: Works on phones (requires HTTPS)

## API Key Auth (Optional)

For production, enable auth:

```bash
OPENCLAW_REQUIRE_AUTH=true
OPENCLAW_MASTER_KEY=your-secret-key
```

Then generate user keys via `POST /api/keys`.

## Files

- `src/server/main.py` - FastAPI server
- `src/server/stt.py` - Speech-to-text (Whisper)
- `src/server/tts.py` - Text-to-speech (ElevenLabs/Chatterbox)
- `src/server/backend.py` - AI backend (gateway or OpenAI)
- `src/client/index.html` - Browser UI

## License

MIT — Built by [Purple Horizons](https://purplehorizons.io)