Gradium

Gradium 是 OpenClaw 的内置文本转语音提供商。该插件可以渲染常规音频回复（WAV）、语音便签兼容的 Opus 输出，以及用于电话表面的 8 kHz u-law 音频。

属性	值
提供者 ID	`gradium`
身份验证	`GRADIUM_API_KEY` 或配置 `apiKey`
基础 URL	`https://api.gradium.ai` （默认）
默认语音	`Emma` (`YTpq7expH9539ERJ`)

设置

创建 Gradium API 密钥，然后使用环境变量或配置密钥将其暴露给 OpenClaw OpenClaw。

export GRADIUM_API_KEY="gsk_..."

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

该插件首先检查已解析的 apiKey，然后回退到 GRADIUM_API_KEY 环境变量。

配置

{
  messages: {
    tts: {
      auto: "always",
      provider: "gradium",
      providers: {
        gradium: {
          voiceId: "YTpq7expH9539ERJ",
          // apiKey: "${GRADIUM_API_KEY}",
          // baseUrl: "https://api.gradium.ai",
        },
      },
    },
  },
}

密钥	类型	描述
`messages.tts.providers.gradium.apiKey`	字符串	解析后的 API 密钥。支持 `${ENV}` 和 secret 引用。
`messages.tts.providers.gradium.baseUrl`	字符串	覆盖 API 源。移除尾部斜杠。默认为 `https://api.gradium.ai`。
`messages.tts.providers.gradium.voiceId`	string	当不存在指令覆盖时使用的默认语音 ID。

输出音频格式由运行时根据目标表面自动选择，无法通过 openclaw.json 进行配置。请参阅下面的 Output。

语音

名称	语音 ID
Emma	`YTpq7expH9539ERJ`
Kent	`LFZvm12tW_z0xfGo`
蒂芙尼	`Eu9iL_CYe8N-Gkx_`
Christina	`2H4HY2CBNyJHBCrP`
悉尼	`jtEKaLYNn6iif5PR`
John	`KWJiFWu2O9nMPYcR`
Arthur	`3jUdJyOi9pgbxBTK`

默认语音：Emma。

每条消息的声音覆盖

当启用的语音策略允许语音覆盖时，您可以使用指令令牌在行内切换语音。所有这些都会解析为相同的 voiceId 覆盖：

/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。请参阅文本转语音以了解当 OpenClawmessages.tts.provider 未固定时，OpenClaw 如何选择活动提供商。

Gradium

设置

配置

语音

每条消息的声音覆盖

输出

自动选择顺序

相关