Gradium
Gradium 是 OpenClaw 的文本转语音提供商。它可生成标准音频回复(WAV)、兼容语音消息的 Opus 输出,以及用于电话界面的 8 kHz u-law 音频。
| 属性 | 值 |
|---|---|
| 提供商 ID | gradium |
| 认证 | GRADIUM_API_KEY 或配置 apiKey |
| 基础 URL | https://api.gradium.ai(默认) |
| 默认语音 | Emma(YTpq7expH9539ERJ) |
安装插件¶
Gradium 是官方外部插件。安装方式如下:
安装会自动应用到正在运行的 Gateway;否则将在下次启动时生效。参见应用更改并检查。
设置¶
创建一个 Gradium API 密钥,然后通过环境变量或配置键暴露它。配置的优先级高于环境变量。
配置¶
{
tts: {
auto: "always",
provider: "gradium",
providers: {
gradium: {
speakerVoiceId: "YTpq7expH9539ERJ",
// apiKey: "${GRADIUM_API_KEY}",
// baseUrl: "https://api.gradium.ai",
},
},
},
}
| 键 | 类型 | 描述 |
|---|---|---|
tts.providers.gradium.apiKey |
string | 解析后的 API 密钥。支持 ${ENV} 和 secret 引用。 |
tts.providers.gradium.baseUrl |
string | api.gradium.ai 上的 HTTPS Gradium API URL。会移除末尾斜杠。默认值为 https://api.gradium.ai。 |
tts.providers.gradium.speakerVoiceId |
string | 在没有指令覆盖时使用的默认语音 ID。 |
输出格式会根据目标界面自动选择(参见输出),并且无法在 openclaw.json 中配置。
语音¶
| 名称 | 语音 ID |
|---|---|
| Arthur | 3jUdJyOi9pgbxBTK |
| Christina | 2H4HY2CBNyJHBCrP |
| Emma (默认) | YTpq7expH9539ERJ |
| John | KWJiFWu2O9nMPYcR |
| Kent | LFZvm12tW_z0xfGo |
| Sydney | jtEKaLYNn6iif5PR |
| Tiffany | Eu9iL_CYe8N-Gkx_ |
按消息覆盖语音¶
当当前语音策略允许语音覆盖时,可以使用指令令牌在行内切换语音(以下任意一种均等效,且都接受提供商原生语音 ID):
/voice:LFZvm12tW_z0xfGo
/voice_id:LFZvm12tW_z0xfGo
/voiceid:LFZvm12tW_z0xfGo
/gradium_voice:LFZvm12tW_z0xfGo
/gradiumvoice:LFZvm12tW_z0xfGo
如果语音策略禁用了语音覆盖,该指令会被消费但忽略。
输出¶
输出格式由目标界面选择;提供商不会合成其他格式。
| 目标 | 格式 | 文件扩展名 | 采样率 | 语音兼容标志 |
|---|---|---|---|---|
| 标准音频 | wav |
.wav |
提供商 | 否 |
| 语音消息 | opus |
.opus |
提供商 | 是 |
| 电话 | ulaw_8000 |
不适用 | 8 kHz | 不适用 |
自动选择顺序¶
在已配置的 TTS 提供商中,Gradium 的自动选择顺序为 30。关于当 tts.provider 未固定时 OpenClaw 如何选择活动提供商,参见文本转语音。
相关¶
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw