wyoming-clawdbot

What This Skill Does

The wyoming-clawdbot skill acts as a robust bridge between the Home Assistant ecosystem and the Clawdbot AI agent infrastructure. By leveraging the open-source Wyoming Protocol, this skill allows users to extend their smart home voice capabilities. It intercepts natural language voice commands captured by Home Assistant Assist, forwards them directly to the Clawdbot backend for processing, and retrieves the AI-generated responses to be spoken back through Home Assistant's Text-to-Speech (TTS) engines. This integration effectively transforms your standard Home Assistant voice assistant into a more powerful, AI-driven entity capable of complex reasoning and task execution through the OpenClaw framework.

Installation

To begin, ensure you have Docker installed on your host system as it is the recommended deployment method. Clone the source repository from GitHub by running git clone https://github.com/vglafirov/wyoming-clawdbot.git, navigate into the folder, and start the service using docker compose up -d. Once the container is active, open your Home Assistant dashboard. Navigate to Settings > Devices & Services, select 'Add Integration', and search for 'Wyoming Protocol'. Enter the host IP and the default port 10600. Finally, configure your preferred Voice Assistant pipeline in Home Assistant to select 'clawdbot' as the designated conversation agent.

Use Cases

This skill is ideal for users who want to move beyond simple smart home control toward conversational AI assistance. Use cases include advanced home automation status reporting, complex query resolution where the AI must reason about the environment, or simply providing a more conversational interface for your connected devices. It bridges the gap for users who wish to keep their LLM processing local or private while utilizing existing smart home hardware.

Example Prompts

1. "Clawdbot, can you summarize the status of all the lights in my house and suggest if I should turn any off to save energy?"
2. "Explain the current security status of the front door and tell me when it was last opened."
3. "If the temperature in the living room exceeds 75 degrees, what automation should I set to keep it cool?"

Tips & Limitations

To ensure optimal performance, keep your Clawdbot server on a wired network connection to minimize latency during voice processing. Note that response times are heavily dependent on your hardware's compute power for the underlying LLM. Limitations include a dependency on the stability of the Wyoming Protocol integration and the requirement that Clawdbot must be reachable within your local network. Always monitor your container logs if the assistant fails to respond to troubleshoot connection timeouts.