Skip to main content
Gradium 是 OpenClaw 的捆绑式文本转语音提供商。该插件可以渲染普通音频回复（WAV）、适用于语音笔记的 Opus 输出，以及用于电话场景的 8 kHz u-law 音频。
PropertyValue
Provider idgradium
AuthGRADIUM_API_KEY 或配置 apiKey
Base URLhttps://api.gradium.ai（默认）
Default voiceEmma (YTpq7expH9539ERJ)

​
设置

创建一个 Gradium API 密钥，然后通过环境变量或配置键将其提供给 OpenClaw。 
export GRADIUM_API_KEY="gsk_..."
该插件会先检查解析后的 apiKey，然后回退到 GRADIUM_API_KEY 环境变量。

​
配置

{
  messages: {
    tts: {
      auto: "always",
      provider: "gradium",
      providers: {
        gradium: {
          speakerVoiceId: "YTpq7expH9539ERJ",
          // apiKey: "${GRADIUM_API_KEY}",
          // baseUrl: "https://api.gradium.ai",
        },
      },
    },
  },
}
KeyTypeDescription
messages.tts.providers.gradium.apiKeystring解析后的 API 密钥。支持 ${ENV} 和 secret 引用。
messages.tts.providers.gradium.baseUrlstring覆盖 API 源地址。会移除末尾斜杠。默认值为 https://api.gradium.ai。
messages.tts.providers.gradium.speakerVoiceIdstring当没有指令覆盖时使用的默认语音 ID。
输出音频格式会由运行时根据目标场景自动选择，不能通过 openclaw.json 配置。参见下方的 输出。

​
语音

名称语音 ID
EmmaYTpq7expH9539ERJ
KentLFZvm12tW_z0xfGo
TiffanyEu9iL_CYe8N-Gkx_
Christina2H4HY2CBNyJHBCrP
SydneyjtEKaLYNn6iif5PR
JohnKWJiFWu2O9nMPYcR
Arthur3jUdJyOi9pgbxBTK
默认语音：Emma。

​
每条消息的语音覆盖

当当前语音策略允许语音覆盖时，你可以使用指令令牌在行内切换语音。对于提供商原生语音 ID，请使用 speakerVoiceId。 
/voice:LFZvm12tW_z0xfGo
/voice_id:LFZvm12tW_z0xfGo
/voiceid:LFZvm12tW_z0xfGo
/gradium_voice:LFZvm12tW_z0xfGo
/gradiumvoice:LFZvm12tW_z0xfGo
如果语音策略禁用了语音覆盖，则该指令会被消费但忽略。

​
输出

运行时会根据目标场景选择输出格式。当前提供商不会生成其他格式。
TargetFormatFile extSample rateVoice-compatible flag
Standard audiowav.wavproviderno
Voice noteopus.opusprovideryes
Telephonyulaw_8000n/a8 kHzn/a

​
自动选择顺序

在已配置的 TTS 提供商中，Gradium 的自动选择顺序为 30。关于当 messages.tts.provider 未固定时 OpenClaw 如何选择当前提供商，请参见 文本转语音。

​
相关内容