集成指南第三方软件接入
OpenClaw 接入教程
通过 OpenClaw 的 OpenAI TTS Provider 接入 Fish Audio,为 Telegram、WhatsApp 等渠道生成语音回复。
OpenClaw 接入 Fish 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 你好,这是一条 Fish Audio 测试语音。确认音频正常后,把 speakerVoice 替换为自己的音色 ID。若不希望所有回复自动转语音,把 auto 改为 off,按需使用 /tts audio。
常见问题
- 仍然调用 OpenAI:检查
baseUrl的位置是否在messages.tts.providers.openai下。 - 音色无效:
speakerVoice必须填写 Fish Audio 音色 ID。 - 渠道不显示语音气泡:不同渠道对 MP3 和 Opus 的展示方式不同,可先确认音频附件能播放。
- 401/402:检查 API Key 和独立 API 积分余额。