Kitta Audio 文档
集成指南第三方软件接入

OpenClaw 接入教程

通过 OpenClaw 的 OpenAI TTS Provider 接入 Kitta Audio,为 Telegram、WhatsApp 等渠道生成语音回复。

OpenClaw 接入 Kitta Audio TTS

OpenClaw 的 OpenAI TTS Provider 支持覆盖 Base URL,并把非默认地址作为 OpenAI 兼容接口处理。配置后可通过 /tts 命令或自动语音模式生成回复。

添加配置

在 OpenClaw 配置文件中加入:

{
  messages: {
    tts: {
      auto: 'always',
      provider: 'openai',
      providers: {
        openai: {
          baseUrl: 'https://fishaudio.org/v1',
          apiKey: 'YOUR_API_KEY',
          model: 'fishaudio-s21pro-flash',
          speakerVoice: '00a1b221-6137-4b73-ad62-b0cbce134167',
          responseFormat: 'mp3',
        },
      },
    },
  },
}

也可以用 OPENAI_TTS_BASE_URL=https://fishaudio.org/v1 单独覆盖 TTS 地址。为了避免把 Key 写入配置文件,建议通过环境变量或 OpenClaw 的密钥管理方式提供凭证。

测试

重启或重新加载 OpenClaw 配置后运行:

/tts status
/tts audio 你好,这是一条 Kitta Audio 测试语音。

确认音频正常后,把 speakerVoice 替换为自己的音色 ID。若不希望所有回复自动转语音,把 auto 改为 off,按需使用 /tts audio

常见问题

  • 仍然调用 OpenAI:检查 baseUrl 的位置是否在 messages.tts.providers.openai 下。
  • 音色无效speakerVoice 必须填写 Kitta Audio 音色 ID。
  • 渠道不显示语音气泡:不同渠道对 MP3 和 Opus 的展示方式不同,可先确认音频附件能播放。
  • 401/402:检查 API Key 和独立 API 积分余额。

相关文档