By name: add-voice-reply description: Add ElevenLabs voice replies so the bot responds to voice notes with voice notes.
Add Voice Replies (ElevenLabs)
When someone sends a voice note, the bot replies with a voice note instead of text. Uses ElevenLabs TTS.
Setup
1. ElevenLabs API key
Ask the user to:
- Sign up at elevenlabs.io
- Go to Settings > API Keys
- Copy the API key
Add to .env:
ELEVENLABS_API_KEY=<key>
2. Pick a voice
Ask: "Which voice should the bot use? You can browse voices at elevenlabs.io/voice-library, or use a custom/cloned voice."
If they have a specific voice, get the voice ID from the ElevenLabs dashboard. If not, suggest they browse the library and pick one that fits.
Add to .env:
ELEVENLABS_VOICE_ID=<voice_id>
If they skip this, the default voice will be used.
3. Rebuild and restart
npm run build
launchctl kickstart -k gui/$(id -u)/com.ghostclaw # macOS
# systemctl --user restart ghostclaw # Linux
4. Test
Tell the user to send a voice note to the bot. It should reply with a voice note using the selected voice. Text messages still get text replies.
How it works
The bot detects when an incoming message is a voice note (tagged [Voice: ...] after transcription). When replying to a voice message, it converts the text response to audio via ElevenLabs TTS and sends it as a voice note. Text messages always get text replies.
Disabling
Remove ELEVENLABS_API_KEY from .env and restart. The bot will fall back to text replies for everything.