Inworld
Inworld 是一個串流文字轉語音 (TTS) 提供商。在 OpenClaw 中,它合成輸出回覆音訊(預設為 MP3,語音留言則為 OGG_OPUS)以及語音頻道(例如 Voice Call)的 PCM 音訊。
OpenClaw 發佈請求至 Inworld 的串流 TTS 端點,將傳回的 base64 音訊區塊串接成單一緩衝區,並將結果傳遞給標準回覆音訊管線。
| 屬性 | 數值 |
|---|---|
| 供應商 ID | inworld |
| 外掛程式 | 內建,enabledByDefault: true |
| 合約 | speechProviders (僅 TTS) |
| Auth 環境變數 | INWORLD_API_KEY (HTTP Basic,Base64 儀表板憑證) |
| Base URL | https://api.inworld.ai |
| 預設語音 | Sarah |
| 預設模型 | inworld-tts-1.5-max |
| 輸出 | MP3 (預設),OGG_OPUS (語音訊息),PCM 22050 Hz (電話) |
| 網站 | inworld.ai |
| 文件 | docs.inworld.ai/tts/tts |
設定您的 API 金鑰
從您的 Inworld 儀表板複製憑證 (Workspace > API Keys) 並將其設定為環境變數。該值會原樣作為 HTTP Basic 憑證發送,因此請勿再次進行 Base64 編碼或將其轉換為 bearer token。
INWORLD_API_KEY=在 messages.tts 中選擇 Inworld
{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)。 |
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
` 發送, 而不進行任何額外編碼,因此請勿自行進行 Base64 編碼,也請勿傳遞 bearer-style 的 token。 請參閱 TTS auth notes 瞭解相同的注意事項。
模型
支援的模型 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,以便音訊作為原生語音泡泡播放。
電信語音合成使用原始的 PCM (22050 Hz) 以饋送至電信橋接器。
自訂端點
使用 messages.tts.providers.inworld.baseUrl 覆寫 API 主機。
並在發送請求前移除結尾斜線。
TTS 概觀、提供者及 messages.tts 設定。
完整設定參考,包含 messages.tts 設定。
所有內建的 OpenClaw 提供者。
常見問題與偵錯步驟。