メインコンテンツへスキップ
Inworld はストリーミングのテキスト読み上げ (TTS) プロバイダーです。OpenClaw では、送信返信音声 (デフォルトは MP3、ボイスノートでは OGG_OPUS) と、Voice Call などの電話チャンネル向けの生 PCM 音声を合成します。 OpenClaw は Inworld のストリーミング TTS エンドポイントに投稿し、返された base64 音声チャンクを 1 つのバッファーに連結して、その結果を標準の返信音声パイプラインに渡します。
プロパティ値
プロバイダー IDinworld
Plugin公式外部パッケージ (@openclaw/inworld-speech)
コントラクトspeechProviders (TTS のみ)
認証環境変数INWORLD_API_KEY (HTTP Basic、Base64 ダッシュボード認証情報)
ベース URLhttps://api.inworld.ai
デフォルト音声Sarah
デフォルトモデルinworld-tts-1.5-max
出力MP3 (デフォルト)、OGG_OPUS (ボイスノート)、PCM 22050 Hz (電話)
Web サイトinworld.ai
ドキュメントdocs.inworld.ai/tts/tts

​
Pluginをインストール

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

​
はじめに

1

API キーを設定する

Inworld ダッシュボード (Workspace > API Keys) から認証情報をコピーし、環境変数として設定します。この値は HTTP Basic 認証情報としてそのまま送信されるため、再度 Base64 エンコードしたり、ベアラートークンに変換したりしないでください。
INWORLD_API_KEY=<base64-credential-from-dashboard>
2

messages.tts で Inworld を選択する

{
  messages: {
    tts: {
      auto: "always",
      provider: "inworld",
      providers: {
        inworld: {
          voiceId: "Sarah",
          modelId: "inworld-tts-1.5-max",
        },
      },
    },
  },
}
3

メッセージを送信する

接続済みチャンネルから返信を送信します。OpenClaw は Inworld で音声を合成し、MP3 として配信します (チャンネルがボイスノートを想定している場合は OGG_OPUS)。

​
設定オプション

オプションパス説明
apiKeymessages.tts.providers.inworld.apiKeyBase64 ダッシュボード認証情報。INWORLD_API_KEY にフォールバックします。
baseUrlmessages.tts.providers.inworld.baseUrlInworld API ベース URL を上書きします (デフォルト https://api.inworld.ai)。
voiceIdmessages.tts.providers.inworld.voiceId音声識別子 (デフォルト Sarah)。レガシーエイリアス: speakerVoiceId。
modelIdmessages.tts.providers.inworld.modelIdTTS モデル ID (デフォルト inworld-tts-1.5-max)。
temperaturemessages.tts.providers.inworld.temperatureサンプリング温度、0 (排他) から 2 (任意)。

​
注意事項

Inworld は、単一の Base64 エンコード済み認証情報文字列を使った HTTP Basic 認証を使用します。Inworld ダッシュボードからそのままコピーしてください。プロバイダーは追加のエンコードなしで Authorization: Basic <apiKey> として送信するため、自分で Base64 エンコードせず、ベアラー形式のトークンも渡さないでください。同じ注意事項については TTS 認証メモ を参照してください。
サポートされるモデル ID: inworld-tts-1.5-max (デフォルト)、inworld-tts-1.5-mini、inworld-tts-1-max、inworld-tts-1。
返信はデフォルトで MP3 を使用します。チャンネルターゲットが voice-note の場合、OpenClaw は音声がネイティブの音声吹き出しとして再生されるよう、Inworld に OGG_OPUS を要求します。電話合成では、電話ブリッジに渡すために 22050 Hz の生 PCM を使用します。
messages.tts.providers.inworld.baseUrl で API ホストを上書きします。リクエスト送信前に末尾のスラッシュは削除されます。

​
関連

テキスト読み上げ

TTS の概要、プロバイダー、messages.tts 設定。

設定

messages.tts 設定を含む完全な設定リファレンス。

プロバイダー

サポートされているすべての OpenClaw プロバイダー。

トラブルシューティング

よくある問題とデバッグ手順。