# Send Voice Assistant to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "openclaw-voice-assistant", "name": "Voice Assistant", "source": "tencent", "type": "skill", "category": "AI 智能", "sourceUrl": "https://clawhub.ai/kurtivy/openclaw-voice-assistant", "canonicalUrl": "https://clawhub.ai/kurtivy/openclaw-voice-assistant", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/openclaw-voice-assistant", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-voice-assistant", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "references/architecture.md", "references/troubleshooting.md", "scripts/generate_assets.py", "scripts/generate_chime_sounds.py", "scripts/generate_thinking_sounds.py", "scripts/requirements.txt" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "openclaw-voice-assistant", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-04T10:33:01.853Z", "expiresAt": "2026-05-11T10:33:01.853Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-voice-assistant", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-voice-assistant", "contentDisposition": "attachment; filename=\"openclaw-voice-assistant-1.0.4.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "openclaw-voice-assistant" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/openclaw-voice-assistant" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/openclaw-voice-assistant", "downloadUrl": "https://openagent3.xyz/downloads/openclaw-voice-assistant", "agentUrl": "https://openagent3.xyz/skills/openclaw-voice-assistant/agent", "manifestUrl": "https://openagent3.xyz/skills/openclaw-voice-assistant/agent.json", "briefUrl": "https://openagent3.xyz/skills/openclaw-voice-assistant/agent.md" } } ``` ## Documentation ### Voice Assistant for OpenClaw A Python companion app that gives OpenClaw a voice. Say a wake word (or press a hotkey), speak naturally, and hear the AI respond — then keep talking for multi-turn conversation. Mic → Porcupine wake word → faster-whisper STT → OpenClaw Gateway → ElevenLabs TTS → Speaker ### Quick Start # 1. Navigate to the skill scripts cd {baseDir}/scripts # 2. Create a virtual environment and install dependencies python -m venv venv venv\\Scripts\\pip install -r requirements.txt # 3. Copy .env.example to .env and fill in your keys copy .env.example .env # 4. Run the assistant venv\\Scripts\\python src\\assistant.py ### Requirements ServiceWhat you needCostOpenClaw gatewayRunning locally on ws://127.0.0.1:18789 with a gateway token—ElevenLabsAPI key + voice ID (free tier works with default voices)Free+PicovoiceAccess key from picovoice.ai (free tier works)FreePython3.10+ (tested on 3.14)—MicrophoneAny input device— ### Configuration (.env) # OpenClaw Gateway GATEWAY_URL=ws://127.0.0.1:18789 GATEWAY_TOKEN=your-gateway-token # ElevenLabs TTS ELEVENLABS_API_KEY=your-api-key ELEVENLABS_VOICE_ID=XrExE9yKIg1WjnnlVkGX # Matilda (free tier) — or MClEFoImJXBTgLwdLI5n for Ivy (paid) ELEVENLABS_MODEL_ID=eleven_v3 # Porcupine Wake Word PORCUPINE_ACCESS_KEY=your-access-key PORCUPINE_MODEL_PATH= # path to custom .ppn file (optional) # Whisper STT WHISPER_MODEL=base # tiny, base, small, medium, large # Tuning WAKE_SENSITIVITY=0.7 # 0.0–1.0 (higher = more sensitive) SILENCE_TIMEOUT=1.5 # seconds of silence to stop recording HOTKEY=ctrl+shift+k # global keyboard shortcut ### Custom Wake Word Go to Picovoice Console Create a custom wake word (e.g. "Hey Claudia", "Hey OpenClaw") Download the .ppn file for your platform Set PORCUPINE_MODEL_PATH in .env to the file path Without a custom model, falls back to built-in "hey google" ### Personalized Voice Sounds The assistant plays short audio clips when activated ("Yep!", "Hi!") and while thinking ("Hmm...", "Let me think..."). Generate these in your chosen ElevenLabs voice: cd {baseDir}/scripts venv\\Scripts\\python generate_chime_sounds.py venv\\Scripts\\python generate_thinking_sounds.py Re-run these after changing ELEVENLABS_VOICE_ID. ### Running in Background Use start.bat to launch without a console window (runs via pythonw.exe). The assistant appears as a system tray icon with Pause/Resume/Quit controls. For auto-start on Windows, create a shortcut to start.bat in shell:startup. ### How It Works Wake — Porcupine detects the wake word (or user presses hotkey) Chime — Plays a random activation sound ("Yep!", "Hi!") Record — Records speech until 1.5s of silence (2s grace period for initial silence) Thinking — Plays a filler sound ("Hmm...", "Let me think...") Transcribe — faster-whisper converts audio to text locally (CPU, int8) Gateway — Sends text to OpenClaw gateway via WebSocket, streams response Speak — ElevenLabs converts response to speech, plays through speakers Follow-up — Automatically listens for 5s after speaking for conversation continuity Idle — Returns to wake word listening after 5s of silence Mic suppression keeps the microphone muted during all speaker output to prevent feedback loops. ### Detailed Architecture See references/architecture.md for source file breakdown, WebSocket protocol details, and audio pipeline internals. ### Troubleshooting See references/troubleshooting.md for common issues with mic detection, gateway connection, TTS errors, and wake word tuning. ## Trust - Source: tencent - Verification: Indexed source record - Publisher: kurtivy - Version: 1.0.4 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-04T10:33:01.853Z - Expires at: 2026-05-11T10:33:01.853Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/openclaw-voice-assistant) - [Send to Agent page](https://openagent3.xyz/skills/openclaw-voice-assistant/agent) - [JSON manifest](https://openagent3.xyz/skills/openclaw-voice-assistant/agent.json) - [Markdown brief](https://openagent3.xyz/skills/openclaw-voice-assistant/agent.md) - [Download page](https://openagent3.xyz/downloads/openclaw-voice-assistant)