AI Newsletter Digest improvements: fixed QP soft line break decoding, URL extraction, and content cleaning

archive/inactive-skills/wyoming-clawdbot/README.md

@@ -0,0 +1,128 @@
+# Wyoming-Clawdbot
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Wyoming Protocol server that bridges [Home Assistant Assist](https://www.home-assistant.io/voice_control/) to [Clawdbot](https://clawd.bot) — 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](https://clawd.bot) installed and running
+- Home Assistant with Wyoming integration
+- Python 3.11+ (or Docker)
+
+## Installation
+
+### Docker Compose (recommended)
+
+```bash
+git clone https://github.com/vglafirov/wyoming-clawdbot.git
+cd wyoming-clawdbot
+docker-compose up -d
+```
+
+### Manual
+
+```bash
+# 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
+
+```bash
+python wyoming_clawdbot.py --port 10600
+```
+
+### With persistent session (recommended)
+
+```bash
+python wyoming_clawdbot.py --port 10600 --session-id voice-assistant
+```
+
+### Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--host` | Host to bind to | `0.0.0.0` |
+| `--port` | Port to listen on | `10400` |
+| `--session-id` | Clawdbot session ID for context persistence | random |
+| `--agent` | Clawdbot agent ID | default |
+| `--debug` | Enable debug logging | false |
+
+## Systemd Service
+
+Create `/etc/systemd/system/wyoming-clawdbot.service`:
+
+```ini
+[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:
+
+```bash
+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](LICENSE) for details.
+
+## Credits
+
+- [Clawdbot](https://clawd.bot) - AI assistant platform
+- [Wyoming Protocol](https://github.com/rhasspy/wyoming) - Voice assistant protocol
+- [Home Assistant](https://www.home-assistant.io/) - Home automation platform