Documentation Index
Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
Gradium 是 OpenClaw 內建的文字轉語音提供者。此 Plugin 可產生一般音訊回覆（WAV）、相容語音訊息的 Opus 輸出，以及用於電話介面的 8 kHz u-law 音訊。
| 屬性 | 值 |
|---|
| 提供者 ID | gradium |
| 驗證 | GRADIUM_API_KEY 或 config apiKey |
| 基底 URL | https://api.gradium.ai（預設） |
| 預設語音 | Emma (YTpq7expH9539ERJ) |
export GRADIUM_API_KEY="gsk_..."
{
messages: {
tts: {
auto: "always",
provider: "gradium",
providers: {
gradium: {
apiKey: "${GRADIUM_API_KEY}",
},
},
},
},
}
apiKey，再回退使用 GRADIUM_API_KEY 環境變數。
Config
{
messages: {
tts: {
auto: "always",
provider: "gradium",
providers: {
gradium: {
voiceId: "YTpq7expH9539ERJ",
// apiKey: "${GRADIUM_API_KEY}",
// baseUrl: "https://api.gradium.ai",
},
},
},
},
}
| 金鑰 | 類型 | 說明 |
|---|
messages.tts.providers.gradium.apiKey | string | 已解析的 API 金鑰。支援 ${ENV} 與 secret refs。 |
messages.tts.providers.gradium.baseUrl | string | 覆寫 API 來源。會移除結尾斜線。預設為 https://api.gradium.ai。 |
messages.tts.providers.gradium.voiceId | string | 沒有 directive 覆寫時使用的預設語音 ID。 |
openclaw.json 設定。請參閱下方的輸出。
| 名稱 | 語音 ID |
|---|
| Emma | YTpq7expH9539ERJ |
| Kent | LFZvm12tW_z0xfGo |
| Tiffany | Eu9iL_CYe8N-Gkx_ |
| Christina | 2H4HY2CBNyJHBCrP |
| Sydney | jtEKaLYNn6iif5PR |
| John | KWJiFWu2O9nMPYcR |
| Arthur | 3jUdJyOi9pgbxBTK |
每則訊息的語音覆寫
當使用中的語音政策允許語音覆寫時，你可以使用 directive token 在行內切換語音。以下全部都會解析為相同的 voiceId 覆寫：
/voice:LFZvm12tW_z0xfGo
/voice_id:LFZvm12tW_z0xfGo
/voiceid:LFZvm12tW_z0xfGo
/gradium_voice:LFZvm12tW_z0xfGo
/gradiumvoice:LFZvm12tW_z0xfGo
| 目標 | 格式 | 副檔名 | 取樣率 | 語音相容旗標 |
|---|
| 標準音訊 | wav | .wav | 提供者 | 否 |
| 語音訊息 | opus | .opus | 提供者 | 是 |
| 電話 | ulaw_8000 | n/a | 8 kHz | n/a |
自動選取順序
在已設定的 TTS 提供者中，Gradium 的自動選取順序為 30。若要了解在未固定 messages.tts.provider 時 OpenClaw 如何選擇使用中的提供者，請參閱文字轉語音。
