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 を再起動します。

openclaw plugins install @openclaw/gradium-speech
openclaw gateway restart

セットアップ

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

環境変数
設定キー

export GRADIUM_API_KEY="gsk_..."

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

設定

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

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

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

Overview

Concepts and configuration

Providers

Plugin のインストール

セットアップ

設定

音声

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

出力

自動選択順序

関連項目

​Plugin のインストール

​セットアップ

​設定

​音声

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

​出力

​自動選択順序

​関連項目

Plugin のインストール

セットアップ

設定

音声

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

出力

自動選択順序

関連項目