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:

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

2. Add Voice Agent

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

3. Run the Server

# 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:

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