Providers

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

安裝外掛

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>

在 tts 中選取 Inworld

json5

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

傳送訊息

透過任何已連線的通道傳送回覆。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 主機。傳送請求前會移除尾端斜線。