Wyoming-Clawdbot

Wyoming Protocol server that bridges Home Assistant Assist to Clawdbot — enabling voice control of your AI assistant.

Features

• 🎤 Voice commands through Home Assistant Assist
• 🤖 Powered by Clawdbot AI (Claude, GPT, etc.)
• 🏠 Full Home Assistant integration
• 🌍 Multilingual support (English, Russian, German, French, and more)
• 💬 Persistent conversation context

How It Works

Voice → Home Assistant → STT → Wyoming-Clawdbot → Clawdbot → Response → TTS → Speaker

1. You speak to your Home Assistant voice satellite (ESPHome, etc.)
2. Speech-to-Text converts your voice to text
3. Wyoming-Clawdbot sends the text to Clawdbot
4. Clawdbot processes and returns a response
5. Text-to-Speech speaks the response

Requirements

• Clawdbot installed and running
• Home Assistant with Wyoming integration
• Python 3.11+ (or Docker)

Installation

Docker Compose (recommended)

git clone https://github.com/vglafirov/wyoming-clawdbot.git
cd wyoming-clawdbot
docker-compose up -d

Manual

# Clone the repository
git clone https://github.com/vglafirov/wyoming-clawdbot.git
cd wyoming-clawdbot

# Create virtual environment
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

Usage

Basic

python wyoming_clawdbot.py --port 10600

With persistent session (recommended)

python wyoming_clawdbot.py --port 10600 --session-id voice-assistant

Options

Systemd Service

Create /etc/systemd/system/wyoming-clawdbot.service:

[Unit]
Description=Wyoming Clawdbot Bridge
After=network.target

[Service]
Type=simple
User=your-user
WorkingDirectory=/path/to/wyoming-clawdbot
Environment="PATH=/usr/local/bin:/usr/bin:/bin"
ExecStart=/path/to/wyoming-clawdbot/venv/bin/python wyoming_clawdbot.py --port 10600 --session-id voice-assistant
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

Then:

sudo systemctl daemon-reload
sudo systemctl enable wyoming-clawdbot
sudo systemctl start wyoming-clawdbot

Home Assistant Configuration

1. Go to Settings → Devices & Services → Add Integration
2. Search for Wyoming Protocol
3. Enter the host and port (e.g., 192.168.1.100:10600)
4. The "clawdbot" conversation agent will appear
5. Configure your Voice Assistant pipeline to use "clawdbot" as the Conversation Agent

License

MIT License - see LICENSE for details.

Credits

• Clawdbot - AI assistant platform
• Wyoming Protocol - Voice assistant protocol
• Home Assistant - Home automation platform