Files
openclaw/docs/providers/gradium.md

65 lines
1.4 KiB
Markdown

---
summary: "Use Gradium text-to-speech in OpenClaw"
read_when:
- You want Gradium for text-to-speech
- You need Gradium API key or voice configuration
title: "Gradium"
---
Gradium is a bundled text-to-speech provider for OpenClaw. It can generate normal audio replies, voice-note-compatible Opus output, and 8 kHz u-law audio for telephony surfaces.
## Setup
Create a Gradium API key, then expose it to OpenClaw:
```bash
export GRADIUM_API_KEY="gsk_..."
```
You can also store the key in config under `messages.tts.providers.gradium.apiKey`.
## Config
```json5
{
messages: {
tts: {
auto: "always",
provider: "gradium",
providers: {
gradium: {
voiceId: "YTpq7expH9539ERJ",
// apiKey: "${GRADIUM_API_KEY}",
// baseUrl: "https://api.gradium.ai",
},
},
},
},
}
```
## Voices
| Name | Voice ID |
| --------- | ------------------ |
| Emma | `YTpq7expH9539ERJ` |
| Kent | `LFZvm12tW_z0xfGo` |
| Tiffany | `Eu9iL_CYe8N-Gkx_` |
| Christina | `2H4HY2CBNyJHBCrP` |
| Sydney | `jtEKaLYNn6iif5PR` |
| John | `KWJiFWu2O9nMPYcR` |
| Arthur | `3jUdJyOi9pgbxBTK` |
Default voice: Emma.
## Output
- Audio-file replies use WAV.
- Voice-note replies use Opus and are marked voice-compatible.
- Telephony synthesis uses `ulaw_8000` at 8 kHz.
## Related
- [Text-to-Speech](/tools/tts)
- [Media Overview](/tools/media-overview)