メインコンテンツへスキップ

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 音声をレンダリングできます。
プロパティ値
プロバイダー IDgradium
認証GRADIUM_API_KEY または設定の apiKey
ベース URLhttps://api.gradium.ai（デフォルト）
デフォルト音声Emma（YTpq7expH9539ERJ）

​
セットアップ

Gradium API キーを作成し、環境変数または設定キーのどちらかで OpenClaw に公開します。 
export GRADIUM_API_KEY="gsk_..."
この Plugin は、解決済みの apiKey を最初に確認し、GRADIUM_API_KEY 環境変数にフォールバックします。

​
設定

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

​
音声

名前音声 ID
EmmaYTpq7expH9539ERJ
KentLFZvm12tW_z0xfGo
TiffanyEu9iL_CYe8N-Gkx_
Christina2H4HY2CBNyJHBCrP
SydneyjtEKaLYNn6iif5PR
JohnKWJiFWu2O9nMPYcR
Arthur3jUdJyOi9pgbxBTK
デフォルト音声: Emma。

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

有効な音声ポリシーが音声上書きを許可している場合、ディレクティブトークンを使ってインラインで音声を切り替えられます。これらはすべて同じ voiceId 上書きに解決されます。 
/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 が有効なプロバイダーを選択する方法については、テキスト読み上げを参照してください。

​
関連