Providers

Gradium

Gradium は、OpenClaw 向けのテキスト読み上げプロバイダーです。標準の音声応答（WAV）、ボイスメモ互換の Opus 出力、および電話通信向けサーフェス用の 8 kHz u-law 音声を生成します。

プロパティ	値
プロバイダー ID	`gradium`
認証	`GRADIUM_API_KEY` または設定の `apiKey`
ベース URL	`https://api.gradium.ai`（デフォルト）
デフォルト音声	`Emma`（`YTpq7expH9539ERJ`）

Plugin のインストール

Gradium は公式の外部 Plugin です。インストールしてから Gateway を再起動します。

bash

openclaw plugins install @openclaw/gradium-speechopenclaw gateway restart

セットアップ

Gradium API キーを作成し、環境変数または設定キーで指定します。設定は環境変数より優先されます。

環境変数

bash

export GRADIUM_API_KEY="gsk_..."

設定キー

json5

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

設定

json5

{  messages: {    tts: {      auto: "always",      provider: "gradium",      providers: {        gradium: {          speakerVoiceId: "YTpq7expH9539ERJ",          // apiKey: "${GRADIUM_API_KEY}",          // baseUrl: "https://api.gradium.ai",        },      },    },  },}

キー	型	説明
`messages.tts.providers.gradium.apiKey`	string	解決済みの API キー。`${ENV}` とシークレット参照に対応します。
`messages.tts.providers.gradium.baseUrl`	string	`api.gradium.ai` 上の HTTPS Gradium API URL。末尾のスラッシュは削除されます。デフォルトは `https://api.gradium.ai` です。
`messages.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 を受け取ります）。

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 です。messages.tts.provider が固定されていない場合に OpenClaw が有効なプロバイダーを選択する方法については、テキスト読み上げを参照してください。