メインコンテンツへスキップ
Gradium は OpenClaw のテキスト読み上げプロバイダーです。標準の音声応答（WAV）、音声メモ互換の Opus 出力、電話サーフェス向けの 8 kHz u-law 音声をレンダリングします。
プロパティ値
プロバイダー IDgradium
認証GRADIUM_API_KEY または config apiKey
ベース URLhttps://api.gradium.ai（デフォルト）
デフォルト音声Emma (YTpq7expH9539ERJ)

​
Plugin をインストール

Gradium は公式の外部 Plugin です。インストールしてから Gateway を再起動します。 
openclaw plugins install @openclaw/gradium-speech
openclaw gateway restart

​
セットアップ

Gradium API キーを作成し、環境変数または config キーで公開します。config は環境変数より優先されます。 
export GRADIUM_API_KEY="gsk_..."

​
Config

{
  messages: {
    tts: {
      auto: "always",
      provider: "gradium",
      providers: {
        gradium: {
          speakerVoiceId: "YTpq7expH9539ERJ",
          // apiKey: "${GRADIUM_API_KEY}",
          // baseUrl: "https://api.gradium.ai",
        },
      },
    },
  },
}
キー型説明
messages.tts.providers.gradium.apiKeystring解決済みの API キー。${ENV} と secret refs をサポートします。
messages.tts.providers.gradium.baseUrlstringAPI オリジンの上書き。末尾のスラッシュは削除されます。デフォルトは https://api.gradium.ai。
messages.tts.providers.gradium.speakerVoiceIdstringディレクティブによる上書きがない場合に使われるデフォルト音声 ID。
出力形式はターゲットサーフェスによって自動的に選択され（出力 を参照）、openclaw.json では設定できません。

​
音声

名前音声 ID
Arthur3jUdJyOi9pgbxBTK
Christina2H4HY2CBNyJHBCrP
Emma （デフォルト）YTpq7expH9539ERJ
JohnKWJiFWu2O9nMPYcR
KentLFZvm12tW_z0xfGo
SydneyjtEKaLYNn6iif5PR
TiffanyEu9iL_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_8000n/a8 kHzn/a

​
自動選択順

設定済みの TTS プロバイダーの中で、Gradium の自動選択順は 30 です。messages.tts.provider が固定されていない場合に OpenClaw が有効なプロバイダーを選択する方法については、テキスト読み上げ を参照してください。

​
関連