| name | homeclaw-bridge |
| version | 1.0.0 |
| description | Bridge between the Wyoming Protocol (local voice stack on the Raspberry Pi) and the OpenClaw Gateway. Connects to wyoming-satellite as a TCP client on port 10700, receives ASR transcripts, forwards them as user messages to the HomeClaw agent on the 'voice' channel, strips Markdown from agent responses, and sends synthesize events back for Piper TTS playback.
|
| author | HomeClaw Contributors |
| license | MIT |
| entry_point | bridge.py |
| runtime | python3.11 |
| permissions | [{"network.connect":"127.0.0.1:10700"},{"network.connect":"127.0.0.1:18789"},{"agent.send":"HomeClaw"},{"agent.receive":"HomeClaw"}] |
| config | {"satellite_uri":{"type":"string","default":"tcp://127.0.0.1:10700","description":"Wyoming satellite endpoint"},"tts_voice":{"type":"string","default":"it_IT-paola-medium","description":"Piper voice model name (see wyoming-piper --list-voices)"},"agent_name":{"type":"string","default":"HomeClaw","description":"OpenClaw agent this bridge drives"},"response_timeout_seconds":{"type":"float","default":8,"description":"Max wait for an agent response before giving up"},"silent_ok_marker":{"type":"string","default":"[SILENT_OK]","description":"If the agent's response is exactly this marker, the bridge will NOT send a TTS synthesize event. The LED feedback (green pulse) acts as the only confirmation. Used for trivial commands like 'timer 5 minuti' or 'accendi la luce' where speaking the confirmation would be noise.\n"}} |
HomeClaw Bridge
When a transcript arrives from the satellite, forward it as a user message
to the HomeClaw agent on the voice channel. When the agent responds:
- Strip Markdown (asterisks, backticks, link syntax, bullet dashes, etc.)
because the TTS engine reads them literally otherwise
- If the cleaned response equals
[SILENT_OK], do not synthesize audio;
the LED feedback is the only confirmation
- Otherwise send a Wyoming
synthesize event to the satellite so Piper
can generate speech and play it back
If the agent does not respond within response_timeout_seconds, send a
short synthesize event saying "non riesco a raggiungere il mio cervello,
riprova tra un momento" so the user knows something is wrong.
Each satellite (Tier C multi-room setup) opens a TCP connection with a
distinct peer name (e.g. homeclaw-cucina, homeclaw-camera). The bridge
passes this peer name along to the agent so that room-aware responses
become possible.
