---
read_when:
    - 你想要將 Inworld 語音合成用於傳出回覆
    - 你需要 Inworld 輸出的 PCM 電話語音或 OGG_OPUS 語音訊息輸出
summary: 用於 OpenClaw 回覆的 Inworld 串流文字轉語音
title: Inworld
x-i18n:
    generated_at: "2026-05-06T02:56:32Z"
    model: gpt-5.5
    provider: openai
    source_hash: caf291bab5da946262ecaf4263c188c168be08ddb43fda72f250b8f8db87b3ff
    source_path: providers/inworld.md
    workflow: 16
---

Inworld 是串流文字轉語音 (TTS) 提供者。在 OpenClaw 中，它會合成對外回覆音訊（預設為 MP3，語音備註使用 OGG_OPUS），也會為語音通話等電話通道合成 PCM 音訊。

OpenClaw 會發送請求到 Inworld 的串流 TTS 端點，將傳回的 base64 音訊區塊串接成單一緩衝區，並把結果交給標準回覆音訊管線。

| 屬性          | 值                                                              |
| ------------- | --------------------------------------------------------------- |
| 提供者 ID     | `inworld`                                                       |
| Plugin        | 內建，`enabledByDefault: true`                                  |
| 合約          | `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](https://inworld.ai)                                |
| 文件          | [docs.inworld.ai/tts/tts](https://docs.inworld.ai/tts/tts)      |

## 開始使用

<Steps>
  <Step title="設定你的 API 金鑰">
    從你的 Inworld 儀表板（Workspace > API Keys）複製憑證，並將它設定為環境變數。該值會原樣作為 HTTP Basic 憑證傳送，因此不要再次進行 Base64 編碼，也不要將它轉換為 bearer token。

    ```
    INWORLD_API_KEY=<base64-credential-from-dashboard>
    ```

  </Step>
  <Step title="在 messages.tts 中選取 Inworld">
    ```json5
    {
      messages: {
        tts: {
          auto: "always",
          provider: "inworld",
          providers: {
            inworld: {
              voiceId: "Sarah",
              modelId: "inworld-tts-1.5-max",
            },
          },
        },
      },
    }
    ```
  </Step>
  <Step title="傳送訊息">
    透過任何已連線的通道傳送回覆。OpenClaw 會使用 Inworld 合成音訊，並以 MP3 傳送（或在通道預期語音備註時使用 OGG_OPUS）。
  </Step>
</Steps>

## 設定選項

| 選項          | 路徑                                         | 說明                                                              |
| ------------- | -------------------------------------------- | ----------------------------------------------------------------- |
| `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`（選用）。                                         |

## 注意事項

<AccordionGroup>
  <Accordion title="驗證">
    Inworld 使用 HTTP Basic 驗證，搭配單一 Base64 編碼的憑證字串。請從 Inworld 儀表板原樣複製。提供者會以 `Authorization: Basic <apiKey>` 傳送它，不會再進行任何編碼，因此不要自行進行 Base64 編碼，也不要傳入 bearer 風格的 token。相同提醒請參閱 [TTS 驗證注意事項](/zh-TW/tools/tts#inworld-primary)。
  </Accordion>
  <Accordion title="模型">
    支援的模型 ID：`inworld-tts-1.5-max`（預設）、`inworld-tts-1.5-mini`、`inworld-tts-1-max`、`inworld-tts-1`。
  </Accordion>
  <Accordion title="音訊輸出">
    回覆預設使用 MP3。當通道目標是 `voice-note` 時，OpenClaw 會要求 Inworld 使用 `OGG_OPUS`，讓音訊以原生語音泡泡播放。電話合成會使用 22050 Hz 的原始 `PCM` 來供給電話橋接器。
  </Accordion>
  <Accordion title="自訂端點">
    使用 `messages.tts.providers.inworld.baseUrl` 覆寫 API 主機。傳送請求前會移除尾端斜線。
  </Accordion>
</AccordionGroup>

## 相關

<CardGroup cols={2}>
  <Card title="文字轉語音" href="/zh-TW/tools/tts" icon="waveform-lines">
    TTS 概觀、提供者，以及 `messages.tts` 設定。
  </Card>
  <Card title="設定" href="/zh-TW/gateway/configuration" icon="gear">
    完整設定參考，包括 `messages.tts` 設定。
  </Card>
  <Card title="提供者" href="/zh-TW/providers" icon="grid">
    所有內建 OpenClaw 提供者。
  </Card>
  <Card title="疑難排解" href="/zh-TW/help/troubleshooting" icon="wrench">
    常見問題與除錯步驟。
  </Card>
</CardGroup>