#8849: feat(tts): Add Chatterbox and Piper as first-class TTS providers
stale
Cluster:
Voice Call and TTS Improvements
## Summary
Adds two local TTS providers: **Chatterbox** (CUDA-accelerated) and **Piper** (CPU-efficient).
## Providers
### Chatterbox TTS
- CUDA-accelerated for high-quality voice synthesis
- Local server, no API costs
- Supports voice messages on Matrix/Telegram/Discord
### Piper TTS
- Lightweight CPU-based TTS
- Multiple voice models
- Fast synthesis for lower-end hardware
## Configuration
**⚠️ Important:** Both providers require `enabled: true` to be explicitly set in the configuration, even when specified as the primary provider.
### Chatterbox:
```json
{
"messages": {
"tts": {
"provider": "chatterbox",
"chatterbox": {
"enabled": true,
"baseUrl": "http://localhost:8100",
"voice": "default"
}
}
}
}
```
### Piper:
```json
{
"messages": {
"tts": {
"provider": "piper",
"piper": {
"enabled": true,
"baseUrl": "http://localhost:8101",
"voice": "en_US-lessac-high"
}
}
}
}
```
## Auth Profiles
Like other first-class providers, Chatterbox and Piper require auth profile entries in `~/.openclaw/agents/main/agent/auth-profiles.json`, even for local services that don't require authentication:
```json
{
"profiles": {
"chatterbox:local": {
"type": "token",
"provider": "chatterbox",
"token": "not-needed"
},
"piper:local": {
"type": "token",
"provider": "piper",
"token": "not-needed"
}
}
}
```
Without these entries, TTS calls will silently fail with "No API key found" errors.
## Changes
- Added Chatterbox provider implementation
- Added Piper provider implementation
- Fixed Zod schema to include chatterbox validation
- Updated TypeScript types
## Testing
- Tested with local Chatterbox and Piper servers
- Verified voice message generation on Matrix
- Confirmed auth profile requirement
Most Similar PRs
#11704: feat(tts): OpenAI TTS baseUrl support for local servers (Chatterbox...
by mateusz-michalik · 2026-02-08
69.5%
#16569: feat(tts): add optional piper provider core support
by akalypse · 2026-02-14
69.3%
#8955: feat(tts): Add Kokoro-82M as first-class TTS provider
by emadomedher · 2026-02-04
66.3%
#8848: feat(stt): Add Whisper as first-class audio transcription provider
by emadomedher · 2026-02-04
65.6%
#7258: feat(tts): add Inworld AI TTS provider
by willsinghwilson · 2026-02-02
65.4%
#7965: feat(tts): add Speechify as TTS provider
by chaerla · 2026-02-03
63.6%
#9041: feat(tts): Add post-processing hook for voice modulation
by robottwo · 2026-02-04
63.3%
#10356: TTS: add Typecast provider (emotion presets, audio tuning, Asian la...
by hmmhmmhm · 2026-02-06
62.6%
#20794: feat(tts): add Fish Audio provider with full docs, tests & gateway ...
by twangodev · 2026-02-19
62.5%
#22086: fix(tts): honor explicit config provider and model/voice settings
by AIflow-Labs · 2026-02-20
62.2%