| 屬性 | 值 |
|---|---|
| 提供者 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 |
安裝外掛
開始使用
Set your API key
從你的 Inworld 控制台(Workspace > API Keys)複製憑證,並將它設定為環境變數。該值會逐字作為 HTTP Basic 憑證傳送,因此不要再次進行 Base64 編碼,也不要將它轉換為 bearer token。
設定選項
| 選項 | 路徑 | 說明 |
|---|---|---|
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)。舊版別名:speakerVoiceId。 |
modelId | messages.tts.providers.inworld.modelId | TTS 模型 id(預設 inworld-tts-1.5-max)。 |
temperature | messages.tts.providers.inworld.temperature | 取樣溫度,0(不含)到 2(選用)。 |
注意事項
Authentication
Authentication
Inworld 使用 HTTP Basic 驗證,搭配單一 Base64 編碼憑證字串。請從 Inworld 控制台逐字複製。提供者會將它作為
Authorization: Basic <apiKey> 傳送,不會再進行任何編碼,因此不要自行進行 Base64 編碼,也不要傳入 bearer 風格的 token。相同提醒請參閱 TTS 驗證注意事項。Models
Models
支援的模型 id:
inworld-tts-1.5-max(預設)、inworld-tts-1.5-mini、inworld-tts-1-max、inworld-tts-1。Audio outputs
Audio outputs
回覆預設使用 MP3。當通道目標為
voice-note 時,OpenClaw 會向 Inworld 要求 OGG_OPUS,讓音訊以原生語音泡泡播放。電話通訊合成會使用 22050 Hz 的原始 PCM,以供給電話通訊橋接器。Custom endpoints
Custom endpoints
使用
messages.tts.providers.inworld.baseUrl 覆寫 API 主機。傳送請求前會移除結尾斜線。相關
Text-to-speech
TTS 概觀、提供者,以及
messages.tts 設定。Configuration
完整設定參考,包含
messages.tts 設定。Providers
所有支援的 OpenClaw 提供者。
Troubleshooting
常見問題與除錯步驟。