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
openclaw gateway restart

​

設定

建立 Gradium API 金鑰，然後透過環境變數或設定鍵提供。設定的優先順序高於環境變數。

環境變數

export GRADIUM_API_KEY="gsk_..."

設定鍵

{
  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	字串	解析後的 API 金鑰。支援 ${ENV} 和祕密參照。
tts.providers.gradium.baseUrl	字串	api.gradium.ai 上的 HTTPS Gradium API URL。會移除結尾斜線。預設為 https://api.gradium.ai。
tts.providers.gradium.speakerVoiceId	字串	未提供指令覆寫時使用的預設語音 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 如何挑選使用中的供應商，請參閱文字轉語音。

​

相關內容

• 文字轉語音
• 媒體概覽