Providers

Gradium

Gradium は OpenClaw にバンドルされているテキスト読み上げプロバイダーです。この Plugin は通常の音声返信(WAV)、音声メモ互換の Opus 出力、電話サーフェス向けの 8 kHz u-law 音声をレンダリングできます。

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

セットアップ

Gradium API キーを作成し、環境変数または設定キーのどちらかで OpenClaw に公開します。

環境変数

bash
export GRADIUM_API_KEY="gsk_..."

設定キー

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

この Plugin は、解決済みの apiKey を最初に確認し、GRADIUM_API_KEY 環境変数にフォールバックします。

設定

json5
{  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} とシークレット参照をサポートします。
messages.tts.providers.gradium.baseUrl string API オリジンを上書きします。末尾のスラッシュは削除されます。デフォルトは https://api.gradium.ai です。
messages.tts.providers.gradium.voiceId string ディレクティブによる上書きがない場合に使用されるデフォルトの音声 ID。

出力音声形式は、対象サーフェスに基づいてランタイムが自動的に選択し、openclaw.json からは設定できません。下の出力を参照してください。

音声

名前 音声 ID
Emma YTpq7expH9539ERJ
Kent LFZvm12tW_z0xfGo
Tiffany Eu9iL_CYe8N-Gkx_
Christina 2H4HY2CBNyJHBCrP
Sydney jtEKaLYNn6iif5PR
John KWJiFWu2O9nMPYcR
Arthur 3jUdJyOi9pgbxBTK

デフォルト音声: Emma。

メッセージごとの音声上書き

有効な音声ポリシーが音声上書きを許可している場合、ディレクティブトークンを使ってインラインで音声を切り替えられます。これらはすべて同じ voiceId 上書きに解決されます。

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

関連

Was this useful?