OpenCrabs 接入 Fish Audio TTS

OpenCrabs 支持任意 /v1/audio/speech 兼容端点，可将 Agent 回复转换为 Telegram、WhatsApp、Discord 或 Slack 语音消息。

配置 TTS

编辑 config.toml：

[voice]
tts_enabled = true
tts_mode = "openai_compatible"
tts_base_url = "https://fishaudio.org/v1"
tts_model = "fishaudio-s21pro-flash"
tts_voice = "00a1b221-6137-4b73-ad62-b0cbce134167"

在 keys.toml 中保存 API Key：

[providers.tts.openai_compatible]
api_key = "YOUR_API_KEY"

不要把 keys.toml 提交到公开仓库。也可以运行 /onboard:voice 使用交互式配置，TTS Provider 选择 OpenAI-compatible，然后填写相同的地址、模型和音色。

测试

重启 OpenCrabs，通过已连接的消息渠道触发一条短回复。确认音频能够生成和播放后，把测试音色替换为自己的 音色 ID。

OpenCrabs 会根据消息渠道处理音频编码；首次测试应先确认语音文件能够播放，再检查是否显示为原生语音气泡。

常见问题

• 请求地址 404：Base URL 应为 https://fishaudio.org/v1，不要填写文档页面地址。
• 仍使用本地 Piper：确认 tts_mode 已改为 openai_compatible。
• 没有生成语音：确认 tts_enabled = true，并检查渠道是否允许发送音频。
• 401/402：检查 keys.toml 中的 Key 和 API 积分余额。

相关文档

• OpenAI 兼容 TTS
• API 错误说明
• OpenCrabs 官方语音文档