Inworld

Inworld 是串流文字轉語音（TTS）提供者。在 OpenClaw 中，它會合成傳出回覆的音訊（預設為 MP3，語音訊息則為 OGG_OPUS），以及供 Voice Call 等電話語音通道使用的原始 PCM 音訊。

OpenClaw 會向 Inworld 的串流 TTS 端點發出 POST 請求，將傳回的 Base64 音訊區塊串接成單一緩衝區，並將結果交給標準回覆音訊流水線。

屬性	值
提供者 ID	inworld
外掛	官方外部套件（@openclaw/inworld-speech）
合約	speechProviders（僅限 TTS）
驗證環境變數	INWORLD_API_KEY（HTTP Basic、Base64 儀表板認證資訊）
基礎 URL	https://api.inworld.ai
預設語音	Sarah
預設模型	inworld-tts-1.5-max
輸出	MP3（預設）、OGG_OPUS（語音訊息）、PCM 22050 Hz（電話語音）
網站	inworld.ai
文件	docs.inworld.ai/tts/tts

​

安裝外掛

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. 在 tts 中選取 Inworld

   {
     tts: {
       auto: "always",
       provider: "inworld",
       providers: {
         inworld: {
           voiceId: "Sarah",
           modelId: "inworld-tts-1.5-max",
         },
       },
     },
   }
   
3. 傳送訊息

   透過任何已連線的通道傳送回覆。OpenClaw 會使用 Inworld 合成音訊，並以 MP3 格式傳送（若通道預期接收語音訊息，則使用 OGG_OPUS）。

​

設定選項

選項	路徑	說明
apiKey	tts.providers.inworld.apiKey	Base64 儀表板認證資訊。若未設定，則使用 INWORLD_API_KEY。
baseUrl	tts.providers.inworld.baseUrl	覆寫 Inworld API 基礎 URL（預設為 https://api.inworld.ai）。
voiceId	tts.providers.inworld.voiceId	語音識別碼（預設為 Sarah）。舊版別名：speakerVoiceId。
modelId	tts.providers.inworld.modelId	TTS 模型 ID（預設為 inworld-tts-1.5-max）。
temperature	tts.providers.inworld.temperature	取樣溫度，範圍為 0（不含）至 2（選用）。

​

注意事項

驗證

Inworld 使用 HTTP Basic 驗證，搭配單一經 Base64 編碼的認證資訊字串。請從 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，以供電話語音橋接器使用。

自訂端點

使用 tts.providers.inworld.baseUrl 覆寫 API 主機。傳送請求前會移除尾端斜線。

​

相關內容

文字轉語音

TTS 概覽、提供者及 tts 設定。

設定

完整設定參考，包括 tts 設定。

提供者

OpenClaw 支援的所有提供者。

疑難排解

常見問題與偵錯步驟。