跳轉到主要內容

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.

Inworld 是串流文字轉語音 (TTS) 提供者。在 OpenClaw 中，它會合成對外回覆音訊（預設為 MP3，語音備註使用 OGG_OPUS），也會為語音通話等電話通道合成 PCM 音訊。 OpenClaw 會發送請求到 Inworld 的串流 TTS 端點，將傳回的 base64 音訊區塊串接成單一緩衝區，並把結果交給標準回覆音訊管線。
屬性值
提供者 IDinworld
Plugin內建，enabledByDefault: true
合約speechProviders（僅 TTS）
驗證環境變數INWORLD_API_KEY（HTTP Basic，Base64 儀表板憑證）
基礎 URLhttps://api.inworld.ai
預設語音Sarah
預設模型inworld-tts-1.5-max
輸出MP3（預設）、OGG_OPUS（語音備註）、PCM 22050 Hz（電話）
網站inworld.ai
文件docs.inworld.ai/tts/tts

​
開始使用

1

設定你的 API 金鑰

從你的 Inworld 儀表板（Workspace > API Keys）複製憑證，並將它設定為環境變數。該值會原樣作為 HTTP Basic 憑證傳送，因此不要再次進行 Base64 編碼，也不要將它轉換為 bearer token。
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.baseUrl覆寫 Inworld API 基礎 URL（預設 https://api.inworld.ai）。
voiceIdmessages.tts.providers.inworld.voiceId語音識別碼（預設 Sarah）。
modelIdmessages.tts.providers.inworld.modelIdTTS 模型 ID（預設 inworld-tts-1.5-max）。
temperaturemessages.tts.providers.inworld.temperature取樣溫度 0..2（選用）。

​
注意事項

Inworld 使用 HTTP Basic 驗證，搭配單一 Base64 編碼的憑證字串。請從 Inworld 儀表板原樣複製。提供者會以 Authorization: Basic <apiKey> 傳送它，不會再進行任何編碼，因此不要自行進行 Base64 編碼，也不要傳入 bearer 風格的 token。相同提醒請參閱 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 提供者。

疑難排解

常見問題與除錯步驟。