本页内容

本页内容

供应商

Gradium

Gradium 是 OpenClaw 的文本转语音提供商。它可生成标准音频回复(WAV)、兼容语音备注的 Opus 输出,以及用于电话场景的 8 kHz u-law 音频。

属性 值
提供方 id gradium
认证 GRADIUM_API_KEY 或配置 apiKey
基础 URL https://api.gradium.ai(默认)
默认语音 Emma (YTpq7expH9539ERJ)

安装插件

Gradium 是官方的外部插件。安装它:

bash
openclaw plugins install @openclaw/gradium-speech

安装自动应用于正在运行的网关;否则下次启动时生效。请参阅 应用更改并检查 。

设置

创建一个 Gradium API 密钥,然后通过环境变量或配置键将其暴露。配置优先于环境变量。

环境变量

bash
export GRADIUM_API_KEY="<your-gradium-api-key>"

配置键

json5
{  tts: {    auto: "always",    provider: "gradium",    providers: {      gradium: {        apiKey: "${GRADIUM_API_KEY}",      },    },  },}

配置

json5
{  tts: {    auto: "always",    provider: "gradium",    providers: {      gradium: {        speakerVoiceId: "YTpq7expH9539ERJ",        // apiKey: "${GRADIUM_API_KEY}",        // baseUrl: "https://api.gradium.ai",      },    },  },}
键 类型 描述
tts.providers.gradium.apiKey 字符串 已解决 API 密钥。支持 ${ENV} 和秘密引用。
tts.providers.gradium.baseUrl 字符串 HTTPS Gradium API URL 在 api.gradium.ai 上。尾部斜杠被删除。默认https://api.gradium.ai。
tts.providers.gradium.speakerVoiceId 字符串 当不存在指令覆盖时使用默认语音 ID。

输出格式会根据目标平台自动选择(见 输出),并且不能在 openclaw.json 中配置。

语音

名称 语音 ID
亚瑟 3jUdJyOi9pgbxBTK
克里斯蒂娜 2H4HY2CBNyJHBCrP
Emma (默认) YTpq7expH9539ERJ
约翰 KWJiFWu2O9nMPYcR
肯特 LFZvm12tW_z0xfGo
Sydney jtEKaLYNn6iif5PR
蒂芙尼 Eu9iL_CYe8N-Gkx_

每条消息的语音覆盖

当活动语音策略允许语音覆盖时,使用指令令牌内联切换语音(其中任何一个都是等效的,都采用提供商本机语音 ID):

text
/voice:LFZvm12tW_z0xfGo/voice_id:LFZvm12tW_z0xfGo/voiceid:LFZvm12tW_z0xfGo/gradium_voice:LFZvm12tW_z0xfGo/gradiumvoice:LFZvm12tW_z0xfGo

如果语音策略禁用了语音覆盖,则该指令会被消费但忽略。

输出

输出格式由目标端选择;提供方不会合成其他格式。

目标 格式 文件扩展名 采样率 语音兼容标志
标准音频 wav .wav 提供方 no
语音笔记 opus .opus 提供方 是
电话通信 ulaw_8000 n/a 8千赫 n/a

自动选择顺序

在配置的TTS提供商中,Gradium的自动选择顺序是30。请参阅 Text-to-Speech,了解 tts.provider 未固定时 OpenClaw 如何选择活动提供者。

相关内容

本页有帮助吗?