跳转至

Gradium

Gradium 是 OpenClaw 的文本转语音提供商。它可渲染标准音频回复（WAV）、兼容语音笔记的 Opus 输出，以及用于电话场景的 8 kHz u-law 音频。

属性 值
提供商 ID gradium
认证 GRADIUM_API_KEY 或配置 apiKey
基础 URL https://api.gradium.ai（默认）
默认语音 Emma（YTpq7expH9539ERJ）

安装插件

Gradium 是一个官方外部插件。安装它：

openclaw plugins install @openclaw/gradium-speech

安装会自动应用到正在运行的 Gateway；否则将在下次启动时生效。参见应用更改并检查。

设置

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

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

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

配置

{
  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} 和密钥引用。
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