---
read_when:
    - テキスト読み上げには Gradium を使用する場合
    - Gradium API キー、音声、またはディレクティブトークンの設定が必要です
summary: OpenClaw で Gradium のテキスト読み上げを使用する
title: Gradium
x-i18n:
    generated_at: "2026-07-26T10:28:30Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: 5536426eb6d3c8f24c04643b033ebb519a1f2f9df9d97c917ced1c7e23ad180d
    source_path: providers/gradium.md
    workflow: 16
---

[Gradium](https://gradium.ai) は 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-speech
openclaw gateway restart
```

## セットアップ

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

<Tabs>
  <Tab title="環境変数">
    ```bash
    export GRADIUM_API_KEY="gsk_..."
    ```
  </Tab>

  <Tab title="設定キー">
    ```json5
    {
      tts: {
        auto: "always",
        provider: "gradium",
        providers: {
          gradium: {
            apiKey: "${GRADIUM_API_KEY}",
          },
        },
      },
    }
    ```
  </Tab>
</Tabs>

## 設定

```json5
{
  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。                                            |

出力形式は対象のサーフェスに応じて自動的に選択され（[出力](#output)を参照）、`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` です。`tts.provider` が固定されていない場合に OpenClaw が有効なプロバイダーを選択する方法については、[テキスト読み上げ](/ja-JP/tools/tts)を参照してください。

## 関連項目

- [テキスト読み上げ](/ja-JP/tools/tts)
- [メディアの概要](/ja-JP/tools/media-overview)