Skip to main content
Gradium 是 OpenClaw 的文本转语音提供商。它会渲染标准音频回复（WAV）、兼容语音便笺的 Opus 输出，以及用于电话通信界面的 8 kHz u-law 音频。
属性值
提供商 idgradium
凭证GRADIUM_API_KEY 或配置 apiKey
基础 URLhttps://api.gradium.ai（默认）
默认语音Emma（YTpq7expH9539ERJ）

​
安装插件

Gradium 是一个官方外部插件。安装它，然后重启 Gateway 网关： 
openclaw plugins install @openclaw/gradium-speech
openclaw gateway restart

​
设置

创建一个 Gradium API key，然后通过环境变量或配置键公开它。配置优先于环境变量。 
export GRADIUM_API_KEY="gsk_..."

​
配置

{
  messages: {
    tts: {
      auto: "always",
      provider: "gradium",
      providers: {
        gradium: {
          speakerVoiceId: "YTpq7expH9539ERJ",
          // apiKey: "${GRADIUM_API_KEY}",
          // baseUrl: "https://api.gradium.ai",
        },
      },
    },
  },
}
键类型描述
messages.tts.providers.gradium.apiKey字符串已解析的 API key。支持 ${ENV} 和 secret refs。
messages.tts.providers.gradium.baseUrl字符串API 源覆盖。会去除尾随斜杠。默认值为 https://api.gradium.ai。
messages.tts.providers.gradium.speakerVoiceId字符串未提供指令覆盖时使用的默认语音 id。
输出格式会由目标界面自动选择（参见输出），不能在 openclaw.json 中配置。

​
语音

名称语音 ID
Arthur3jUdJyOi9pgbxBTK
Christina2H4HY2CBNyJHBCrP
Emma （默认）YTpq7expH9539ERJ
JohnKWJiFWu2O9nMPYcR
KentLFZvm12tW_z0xfGo
SydneyjtEKaLYNn6iif5PR
TiffanyEu9iL_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。当未固定 messages.tts.provider 时，请参见文本转语音，了解 OpenClaw 如何选择当前提供商。

​
相关内容