Troubleshooting
Common issues and how to fix them.
Not speaking
- VoxClaw running? (check menu bar)
- Listener active?
curl http://localhost:4140/status
- Volume up?
- API key valid? (if using OpenAI/ElevenLabs)
Agent not triggering speech
- Restart your session after installing the plugin
- Check for
voxclaw in ~/.claude/settings.json or ~/.codex/config.toml
Peer not appearing
- Same Wi-Fi?
- VoxClaw running on both?
- Wait a few seconds for Bonjour
Logs
log stream --predicate 'subsystem == "com.malpern.voxclaw"' --level debug
Open an issue on GitHub