跳转至

Inworld

Inworld 是一个流式文本转语音(TTS)提供商。在 OpenClaw 中,它合成出站回复音频(默认 MP3,语音消息为 OGG_OPUS)以及用于 Voice Call 等电话频道的原始 PCM 音频。

OpenClaw 向 Inworld 的流式 TTS 端点发送请求,将返回的 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
文档 docs.inworld.ai/tts/tts

安装插件

openclaw plugins install @openclaw/inworld-speech

安装会自动应用于正在运行的 Gateway;否则将在下次启动时生效。请参阅 应用更改并检查。

快速开始

1. 设置 API 密钥

从 Inworld 仪表盘(Workspace > API Keys)复制凭据,并将其设置为环境变量。该值会原样作为 HTTP Basic 凭据发送,因此请勿再次进行 Base64 编码,也不要将其转换为 bearer 令牌。

INWORLD_API_KEY=<base64-credential-from-dashboard>

2. 在 tts 中选择 Inworld

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

3. 发送消息

通过任意已连接频道发送回复。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(可选)。

备注

认证

Inworld 使用 HTTP Basic 认证,并采用单个 Base64 编码的凭据字符串。请从 Inworld 仪表盘原样复制。提供商会将其作为 Authorization: Basic <apiKey> 发送,不再进行任何编码,因此请勿自行进行 Base64 编码,也不要传递 bearer 风格的令牌。有关相同提示,请参阅 TTS 认证说明。

模型

支持的模型 ID:inworld-tts-1.5-max(默认)、inworld-tts-1.5-mini、inworld-tts-1-max、inworld-tts-1。

音频输出

回复默认使用 MP3。当频道目标为 voice-note 时,OpenClaw 会请求 Inworld 返回 OGG_OPUS,以便音频以原生语音气泡形式播放。电话合成使用 22050 Hz 的原始 PCM 来驱动电话桥接。

自定义端点

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

文本转语音

TTS 概述、提供商以及 tts 配置。

配置

完整配置参考,包括 tts 设置。

提供商

所有受支持的 OpenClaw 提供商。

故障排除

常见问题和调试步骤。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw