Gradium 是 OpenClaw 内置的文字转语音（TTS）提供商，支持 WAV、Opus（语音消息）和 8 kHz u-law（电话）输出。
| 属性 | 值 |
|---|---|
| Provider ID | gradium |
| 认证 | GRADIUM_API_KEY 或配置 apiKey |
| Base URL | https://api.gradium.ai（默认） |
| 默认语音 | Emma（YTpq7expH9539ERJ） |
快速开始
export GRADIUM_API_KEY="gsk_..."{
messages: {
tts: {
auto: "always",
provider: "gradium",
providers: {
gradium: {
voiceId: "YTpq7expH9539ERJ",
},
},
},
},
}可用语音
| 名称 | Voice ID |
|---|---|
| Emma（默认） | YTpq7expH9539ERJ |
| Kent | LFZvm12tW_z0xfGo |
| Tiffany | Eu9iL_CYe8N-Gkx_ |
| Christina | 2H4HY2CBNyJHBCrP |
| Sydney | jtEKaLYNn6iif5PR |
| John | KWJiFWu2O9nMPYcR |
| Arthur | 3jUdJyOi9pgbxBTK |
消息内语音切换
在允许语音覆盖的策略下，可使用指令 token 切换语音：
/voice:LFZvm12tW_z0xfGo
/voice_id:LFZvm12tW_z0xfGo
/gradium_voice:LFZvm12tW_z0xfGo
输出格式
| 目标 | 格式 | 文件扩展名 |
|---|---|---|
| 标准音频 | wav | .wav |
| 语音消息 | opus | .opus |
| 电话 | ulaw_8000 | n/a |
输出格式由运行时根据目标信道自动选择，不可在配置中手动指定。
自动选择顺序（auto-select order）：30。
相关链接
- provider-inworld — 另一个 TTS 提供商
- provider-elevenlabs — ElevenLabs TTS/STT
- providers — 所有 provider 总览