Skip to content

Inworld

Inworld 是一個串流文字轉語音 (TTS) 提供商。在 OpenClaw 中,它合成輸出回覆音訊(預設為 MP3,語音留言則為 OGG_OPUS)以及語音頻道(例如 Voice Call)的 PCM 音訊。

OpenClaw 發佈請求至 Inworld 的串流 TTS 端點,將傳回的 base64 音訊區塊串接成單一緩衝區,並將結果傳遞給標準回覆音訊管線。

屬性數值
供應商 IDinworld
外掛程式內建,enabledByDefault: true
合約speechProviders (僅 TTS)
Auth 環境變數INWORLD_API_KEY (HTTP Basic,Base64 儀表板憑證)
Base 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=
  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

` 發送, 而不進行任何額外編碼,因此請勿自行進行 Base64 編碼,也請勿傳遞 bearer-style 的 token。 請參閱 TTS auth notes 瞭解相同的注意事項。

模型

支援的模型 ID:inworld-tts-1.5-max (預設)、 inworld-tts-1.5-miniinworld-tts-1-maxinworld-tts-1

音訊輸出

回覆預設使用 MP3。當頻道目標是 voice-note 時,OpenClaw 會要求 Inworld 提供 OGG_OPUS,以便音訊作為原生語音泡泡播放。 電信語音合成使用原始的 PCM (22050 Hz) 以饋送至電信橋接器。

自訂端點

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

文字轉語音

TTS 概觀、提供者及 messages.tts 設定。

設定

完整設定參考,包含 messages.tts 設定。

提供者

所有內建的 OpenClaw 提供者。

疑難排解

常見問題與偵錯步驟。