Providers

Gradium

Gradium 是 OpenClaw 的文字轉語音供應商。它可產生標準音訊回覆（WAV）、與語音訊息相容的 Opus 輸出，以及用於電話介面的 8 kHz u-law 音訊。

屬性	值
供應商 ID	`gradium`
驗證	`GRADIUM_API_KEY` 或設定 `apiKey`
基礎 URL	`https://api.gradium.ai`（預設）
預設語音	`Emma`（`YTpq7expH9539ERJ`）

安裝外掛

Gradium 是官方外部外掛。安裝後重新啟動閘道：

bash

openclaw plugins install @openclaw/gradium-speechopenclaw gateway restart

設定

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

環境變數

bash

export GRADIUM_API_KEY="gsk_..."

設定鍵

json5

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

設定

json5

{  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）：

text

/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 如何挑選使用中的供應商，請參閱文字轉語音。

Gradium

安裝外掛

設定

環境變數

設定鍵

設定

語音

每則訊息的語音覆寫

輸出

自動選擇順序

相關內容

On this page

Molty