Providers

Inworld

Inworld 是串流文字轉語音（TTS）供應商。在 OpenClaw 中，它會合成外送回覆音訊（預設為 MP3，語音訊息則為 OGG_OPUS），並為 Voice Call 等電話通訊頻道合成原始 PCM 音訊。

OpenClaw 會向 Inworld 的串流 TTS 端點發送請求，將回傳的 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

安裝外掛

bash

openclaw plugins install @openclaw/inworld-speechopenclaw gateway restart

開始使用

設定 API 金鑰

從 Inworld 儀表板（Workspace > API Keys）複製憑證，並將其設為環境變數。該值會原封不動地作為 HTTP Basic 憑證傳送，因此請勿再次進行 Base64 編碼，也不要將其轉換為不記名權杖。

bash

INWORLD_API_KEY=<base64-credential-from-dashboard>

在 messages.tts 中選取 Inworld

json5

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

傳送訊息

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

設定選項

選項	路徑	說明
`apiKey`	`messages.tts.providers.inworld.apiKey`	Base64 儀表板憑證。若未設定，則使用 `INWORLD_API_KEY`。
`baseUrl`	`messages.tts.providers.inworld.baseUrl`	覆寫 Inworld API 基礎 URL（預設為 `https://api.inworld.ai`）。
`voiceId`	`messages.tts.providers.inworld.voiceId`	語音識別碼（預設為 `Sarah`）。舊版別名：`speakerVoiceId`。
`modelId`	`messages.tts.providers.inworld.modelId`	TTS 模型 ID（預設為 `inworld-tts-1.5-max`）。
`temperature`	`messages.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，以提供給電話通訊橋接器。

自訂端點

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