# Inworld

> 用于 OpenClaw 回复的 Inworld 流式文本转语音

- 网址：https://funcoding.ai/agents/openclaw/providers/inworld/
- 来源：OpenClaw 官方文档原文（中文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.openclaw.ai/zh-CN/providers/inworld

---
Inworld 是流式文本转语音（TTS）提供商。在 OpenClaw 中，它为出站回复合成音频（默认为 MP3，语音消息使用 OGG_OPUS），并为语音通话等电话渠道合成原始 PCM 音频。

OpenClaw 向 Inworld 的流式 TTS 端点发出 POST 请求，将返回的 Base64 音频块拼接为单个缓冲区，然后将结果交给标准回复音频流水线。

| 属性          | 值                                                              |
| ------------- | --------------------------------------------------------------- |
| 提供商 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](https://inworld.ai)                                |
| 文档          | [docs.inworld.ai/tts/tts](https://docs.inworld.ai/tts/tts)      |

## 安装插件

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

## 入门指南

**设置 API 密钥**

从 Inworld 控制面板（Workspace > API Keys）复制凭据，并将其设置为环境变量。该值会原样作为 HTTP Basic 凭据发送，因此不要再次对其进行 Base64 编码，也不要将其转换为不记名令牌。

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

**在 tts 中选择 Inworld**

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

**发送消息**

通过任意已连接的渠道发送回复。OpenClaw 使用 Inworld 合成音频，并以 MP3 格式传送（当渠道要求语音消息时则使用 OGG_OPUS）。

## 配置选项

| 选项          | 路径                                | 说明                                                                |
| ------------- | ----------------------------------- | ------------------------------------------------------------------- |
| `apiKey`      | `tts.providers.inworld.apiKey`      | Base64 控制面板凭据。回退到 `INWORLD_API_KEY`。                     |
| `baseUrl`     | `tts.providers.inworld.baseUrl`     | 覆盖 Inworld API 基础 URL（默认为 `https://api.inworld.ai`）。             |
| `voiceId`     | `tts.providers.inworld.voiceId`     | 语音标识符（默认为 `Sarah`）。旧版别名：`speakerVoiceId`。 |
| `modelId`     | `tts.providers.inworld.modelId`     | TTS 模型 ID（默认为 `inworld-tts-1.5-max`）。                           |
| `temperature` | `tts.providers.inworld.temperature` | 采样温度，范围为 `0`（不含）至 `2`（可选）。 |

## 注意事项

<details>
<summary>身份验证</summary>

Inworld 使用 HTTP Basic 身份验证，其中包含一个经过 Base64 编码的凭据字符串。请从 Inworld 控制面板原样复制该字符串。提供商将其作为 `Authorization: Basic <apiKey>` 发送，不会进行任何进一步编码，因此不要自行对其进行 Base64 编码，也不要传入不记名令牌类型的令牌。相同的注意事项请参阅 [TTS 身份验证说明](https://funcoding.ai/agents/openclaw/tools/tts/#inworld-primary)。

</details>

<details>
<summary>模型</summary>

支持的模型 ID：`inworld-tts-1.5-max`（默认）、`inworld-tts-1.5-mini`、`inworld-tts-1-max`、`inworld-tts-1`。

</details>

<details>
<summary>音频输出</summary>

回复默认使用 MP3。当渠道目标为 `voice-note` 时，OpenClaw 会请求 Inworld 返回 `OGG_OPUS`，以便音频作为原生语音气泡播放。电话合成使用 22050 Hz 的原始 `PCM` 音频输入电话桥接器。

</details>

<details>
<summary>自定义端点</summary>

使用 `tts.providers.inworld.baseUrl` 覆盖 API 主机。发送请求前会移除末尾的斜杠。

</details>

## 相关内容

- [文本转语音](https://funcoding.ai/agents/openclaw/tools/tts/)：TTS 概览、提供商和 `tts` 配置。
- [配置](https://funcoding.ai/agents/openclaw/gateway/configuration/)：完整的配置参考，包括 `tts` 设置。
- [提供商](https://funcoding.ai/agents/openclaw/providers/)：OpenClaw 支持的所有提供商。
- [故障排查](https://funcoding.ai/agents/openclaw/help/troubleshooting/)：常见问题和调试步骤。