テキスト読み上げ

{
  messages: {
    tts: {
      auto: "always",
      provider: "elevenlabs",
    },
  },
}

{
  messages: {
    tts: {
      auto: "always",
      provider: "openai",
      summaryModel: "openai/gpt-4.1-mini",
      modelOverrides: {
        enabled: true,
      },
      openai: {
        apiKey: "openai_api_key",
        baseUrl: "https://api.openai.com/v1",
        model: "gpt-4o-mini-tts",
        voice: "alloy",
      },
      elevenlabs: {
        apiKey: "elevenlabs_api_key",
        baseUrl: "https://api.elevenlabs.io",
        voiceId: "voice_id",
        modelId: "eleven_multilingual_v2",
        seed: 42,
        applyTextNormalization: "auto",
        languageCode: "en",
        voiceSettings: {
          stability: 0.5,
          similarityBoost: 0.75,
          style: 0.0,
          useSpeakerBoost: true,
          speed: 1.0,
        },
      },
    },
  },
}

{
  messages: {
    tts: {
      auto: "always",
      provider: "edge",
      edge: {
        enabled: true,
        voice: "en-US-MichelleNeural",
        lang: "en-US",
        outputFormat: "audio-24khz-48kbitrate-mono-mp3",
        rate: "+10%",
        pitch: "-5%",
      },
    },
  },
}

{
  messages: {
    tts: {
      edge: {
        enabled: false,
      },
    },
  },
}

{
  messages: {
    tts: {
      auto: "always",
      maxTextLength: 4000,
      timeoutMs: 30000,
      prefsPath: "~/.openclaw/settings/tts.json",
    },
  },
}

{
  messages: {
    tts: {
      auto: "inbound",
    },
  },
}

{
  messages: {
    tts: {
      auto: "always",
    },
  },
}
```次に、次を実行します。

### フィールドに関する注意事項- `auto`: 自動 TTS モード (`off`、`always`、`inbound`、`tagged`)。
  - `inbound` は、受信音声メモの後にのみ音声を送信します。
  - `tagged` は、応答に `[[tts]]` タグが含まれている場合にのみ音声を送信します。
- `enabled`: 従来の切り替え (医師はこれを `auto` に移行します)。
- `mode`: `"final"` (デフォルト) または `"all"` (ツール/ブロック応答を含む)。
- `provider`: `"elevenlabs"`、`"openai"`、または `"edge"` (フォールバックは自動です)。
- `provider` が **未設定**の場合、OpenClaw は `openai` (キーの場合)、次に `elevenlabs` (キーの場合) を優先します。
  それ以外の場合は `edge`。
- `summaryModel`: 自動サマリー用のオプションの安価なモデル。デフォルトは `agents.defaults.model.primary` です。
  - `provider/model` または構成されたモデルのエイリアスを受け入れます。
- `modelOverrides`: モデルが TTS ディレクティブを発行できるようにします (デフォルトでオン)。
  - `allowProvider` のデフォルトは `false` です (プロバイダーの切り替えはオプトインです)。
- `maxTextLength`: TTS 入力 (文字) のハード キャップ。 `/tts audio` を超えると失敗します。
- `timeoutMs`: リクエストのタイムアウト (ミリ秒)。
- `prefsPath`: ローカル設定の JSON パス (プロバイダー/制限/概要) をオーバーライドします。
- `apiKey` 値は環境変数 (`ELEVENLABS_API_KEY`/`XI_API_KEY`、`OPENAI_API_KEY`) にフォールバックします。
- `elevenlabs.baseUrl`: イレブンラボ API ベース URL をオーバーライドします。- `openai.baseUrl`: OpenAI TTS エンドポイントをオーバーライドします。
  - 解決順序: `messages.tts.openai.baseUrl` -> `OPENAI_TTS_BASE_URL` -> `https://api.openai.com/v1`
  - デフォルト以外の値は OpenAI 互換の TTS エンドポイントとして扱われるため、カスタム モデル名と音声名が受け入れられます。
- `elevenlabs.voiceSettings`:
  - `stability`、`similarityBoost`、`style`: `0..1`
  - `useSpeakerBoost`: `true|false`
  - `speed`: `0.5..2.0` (1.0 = 通常)
- `elevenlabs.applyTextNormalization`: `auto|on|off`
- `elevenlabs.languageCode`: 2 文字の ISO 639-1 (例: `en`、`de`)
- `elevenlabs.seed`: 整数 `0..4294967295` (ベストエフォート型決定論)
- `edge.enabled`: Edge TTS の使用を許可します (デフォルト `true`、API キーなし)。
- `edge.voice`: エッジ ニューラル音声名 (例: `en-US-MichelleNeural`)。
- `edge.lang`: 言語コード (例: `en-US`)。
- `edge.outputFormat`: エッジ出力形式 (例: `audio-24khz-48kbitrate-mono-mp3`)。
  - 有効な値については、「Microsoft Speech 出力形式」を参照してください。すべての形式が Edge でサポートされているわけではありません。
- `edge.rate` / `edge.pitch` / `edge.volume`: パーセント文字列 (例: `+10%`、`-5%`)。
- `edge.saveSubtitles`: 音声ファイルと一緒に JSON 字幕を書き込みます。
- `edge.proxy`: Edge TTS リクエストのプロキシ URL。
- `edge.timeoutMs`: リクエストのタイムアウト オーバーライド (ミリ秒)。

## モデル駆動型オーバーライド (デフォルトはオン)デフォルトでは、モデルは単一の応答に対して TTS ディレクティブを発行できます**。
`messages.tts.auto` が `tagged` の場合、オーディオをトリガーするにはこれらのディレクティブが必要です。

有効にすると、モデルは `[[tts:...]]` ディレクティブを発行して音声をオーバーライドできます。
単一の応答の場合、オプションの `[[tts:text]]...[[/tts:text]]` ブロックを加えて、
にのみ表示される表現力豊かなタグ (笑い、歌の合図など) を提供します。
オーディオ。

`provider=...` ディレクティブは、`modelOverrides.allowProvider: true` でない限り無視されます。

応答ペイロードの例:

利用可能なディレクティブ キー (有効な場合):

- `provider` (`openai` | `elevenlabs` | `edge`、`allowProvider: true` が必要)
- `voice` (OpenAI 音声) または `voiceId` (イレブンラボ)
- `model` (OpenAI TTS モデルまたは Celebrities モデル ID)
- `stability`、`similarityBoost`、`style`、`speed`、`useSpeakerBoost`
- `applyTextNormalization` (`auto|on|off`)
- `languageCode` (ISO 639-1)
- `seed`

すべてのモデルのオーバーライドを無効にします。

```json5
{
  messages: {
    tts: {
      modelOverrides: {
        enabled: false,
      },
    },
  },
}

{
  messages: {
    tts: {
      modelOverrides: {
        enabled: true,
        allowProvider: true,
        allowSeed: false,
      },
    },
  },
}

Reply -> TTS enabled?
  no  -> send text
  yes -> has media / MEDIA: / short?
          yes -> send text
          no  -> length > limit?
                   no  -> TTS -> attach audio
                   yes -> summary enabled?
                            no  -> send text
                            yes -> summarize (summaryModel or agents.defaults.model.primary)
                                      -> TTS -> attach audio

/tts off
/tts always
/tts inbound
/tts tagged
/tts status
/tts provider openai
/tts limit 2000
/tts summary off
/tts audio Hello from OpenClaw