跳轉到主要內容
Gradium 是 OpenClaw 的文字轉語音提供者。它可產生標準音訊回覆 (WAV)、相容語音備忘的 Opus 輸出，以及供電話語音介面使用的 8 kHz u-law 音訊。
屬性值
提供者 IDgradium
驗證GRADIUM_API_KEY 或設定 apiKey
基礎 URLhttps://api.gradium.ai (預設)
預設語音Emma (YTpq7expH9539ERJ)

​
安裝外掛

Gradium 是官方外部外掛。安裝它，然後重新啟動閘道： 
openclaw plugins install @openclaw/gradium-speech
openclaw gateway restart

​
設定

建立 Gradium API 金鑰，然後透過環境變數或設定鍵公開它。設定會優先於環境變數。 
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.apiKeystring已解析的 API 金鑰。支援 ${ENV} 與秘密參照。
messages.tts.providers.gradium.baseUrlstringAPI 來源覆寫。會移除結尾斜線。預設為 https://api.gradium.ai。
messages.tts.providers.gradium.speakerVoiceIdstring沒有指令覆寫時使用的預設語音 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_8000n/a8 kHzn/a

​
自動選擇順序

在已設定的 TTS 提供者中，Gradium 的自動選擇順序是 30。若要了解在未固定 messages.tts.provider 時 OpenClaw 如何選擇作用中的提供者，請參閱文字轉語音。

​
相關