跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Inworld 是串流文字轉語音 (TTS) 提供者。在 OpenClaw 中,它會合成外寄回覆音訊(預設為 MP3,語音訊息則為 OGG_OPUS),以及語音通話等電話語音頻道使用的 PCM 音訊。 OpenClaw 會送出請求至 Inworld 的串流 TTS 端點,將傳回的 base64 音訊區塊串接成單一緩衝區,並把結果交給標準回覆音訊管線。
詳細資料
網站inworld.ai
文件docs.inworld.ai/tts/tts
驗證INWORLD_API_KEY(HTTP Basic,Base64 儀表板憑證)
預設語音Sarah
預設模型inworld-tts-1.5-max

開始使用

1

設定你的 API 金鑰

從 Inworld 儀表板(Workspace > API Keys)複製憑證,並將其設定為環境變數。此值會原樣作為 HTTP Basic 憑證送出,因此不要再次進行 Base64 編碼,也不要轉換為 bearer token。
INWORLD_API_KEY=<base64-credential-from-dashboard>
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 <apiKey> 形式送出,不會進一步編碼,因此不要自行進行 Base64 編碼,也不要傳入 bearer 樣式的 token。相同提示請參閱 TTS 驗證備註
支援的模型 ID:inworld-tts-1.5-max(預設)、inworld-tts-1.5-miniinworld-tts-1-maxinworld-tts-1
回覆預設使用 MP3。當頻道目標是 voice-note 時,OpenClaw 會向 Inworld 要求 OGG_OPUS,讓音訊以原生語音泡泡播放。電話語音合成會使用 22050 Hz 的原始 PCM 來供給電話語音橋接器。
使用 messages.tts.providers.inworld.baseUrl 覆寫 API 主機。送出請求前會移除結尾斜線。

相關

文字轉語音

TTS 概覽、提供者,以及 messages.tts 設定。

設定

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

提供者

所有隨附的 OpenClaw 提供者。

疑難排解

常見問題與偵錯步驟。