Fish Audio Docs
整合指南第三方集成
返回主站

OpenClaw 設定

將 OpenClaw OpenAI TTS 提供者與 Fish Audio 結合使用,在 Telegram、WhatsApp 和其他管道上進行語音回覆。

將 Fish Audio TTS 連接到 OpenClaw

OpenClaw 的 OpenAI TTS 提供者可以覆寫其基本 URL 並將非預設 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 端點。優先選擇環境變數或 OpenClaw 的秘密管理,而不是將金鑰儲存在原始碼控制的配置中。

測試連接

重新啟動或重新載入 OpenClaw,然後執行:

/tts status
/tts audio Hello, this is a Fish Audio connection test.

音訊播放後,將 speakerVoice 替換為您自己的語音 ID。如果您只想在使用 /tts audio 時講話,請將 auto 設定為 off

故障排除

  • 請求仍到達 OpenAI:確保 baseUrl 嵌套在 messages.tts.providers.openai 下。
  • 無效語音speakerVoice 必須包含 Fish Audio 語音 ID。
  • 沒有原生語音氣泡:通道以不同方式處理 MP3 和 Opus;首先確認音訊附件是否播放。
  • 401/402:驗證API金鑰和單獨的API信用餘額。

相關文檔