跳轉到主要內容
Inworld 是串流文字轉語音 (TTS) 提供者。在 OpenClaw 中,它會合成外送回覆音訊(預設為 MP3,語音筆記使用 OGG_OPUS),以及供語音通話等電話通訊通道使用的原始 PCM 音訊。 OpenClaw 會發送請求到 Inworld 的串流 TTS 端點,將回傳的 base64 音訊片段串接成單一緩衝區,並將結果交給標準回覆音訊管線。
屬性
提供者 idinworld
外掛官方外部套件 (@openclaw/inworld-speech)
合約speechProviders(僅 TTS)
驗證環境變數INWORLD_API_KEY(HTTP Basic,Base64 控制台憑證)
基底 URLhttps://api.inworld.ai
預設語音Sarah
預設模型inworld-tts-1.5-max
輸出MP3(預設)、OGG_OPUS(語音筆記)、PCM 22050 Hz(電話通訊)
網站inworld.ai
文件docs.inworld.ai/tts/tts

安裝外掛

openclaw plugins install @openclaw/inworld-speech
openclaw gateway restart

開始使用

1

Set your API key

從你的 Inworld 控制台(Workspace > API Keys)複製憑證,並將它設定為環境變數。該值會逐字作為 HTTP Basic 憑證傳送,因此不要再次進行 Base64 編碼,也不要將它轉換為 bearer token。
INWORLD_API_KEY=<base64-credential-from-dashboard>
2

Select Inworld in messages.tts

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

Send a message

透過任何已連接的通道傳送回覆。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)。舊版別名:speakerVoiceId
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 主機。傳送請求前會移除結尾斜線。

相關

Text-to-speech

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

Configuration

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

Providers

所有支援的 OpenClaw 提供者。

Troubleshooting

常見問題與除錯步驟。