Fish Audio Docs
통합 가이드타사 통합
Back to site

OpenClaw 설정

Telegram, WhatsApp 및 기타 채널에서 음성 응답을 하려면 OpenClaw OpenAI TTS 공급자를 Fish Audio와 함께 사용하세요.

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',
        },
      },
    },
  },
}

대신 TTS 엔드포인트만 재정의하도록 OPENAI_TTS_BASE_URL=https://fishaudio.org/v1를 설정할 수 있습니다. 소스 제어 구성에 키를 저장하는 것보다 환경 변수 또는 OpenClaw의 비밀 관리를 선호합니다.

연결 테스트

OpenClaw를 다시 시작하거나 다시 로드한 후 다음을 실행하세요.

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

오디오가 재생된 후 speakerVoice를 자신의 Voice ID로 바꾸세요. /tts audio가 사용될 때만 음성을 원할 경우 autooff로 설정하십시오.

문제 해결

  • 요청은 여전히 ​​OpenAI에 도달합니다: baseUrlmessages.tts.providers.openai 아래에 중첩되어 있는지 확인하세요.
  • 잘못된 음성: speakerVoice에는 Fish Audio 음성 ID가 포함되어야 합니다.
  • 기본 음성 버블 없음: 채널은 MP3와 Opus를 다르게 처리합니다. 먼저 오디오 첨부 파일이 재생되는지 확인하세요.
  • 401/402: API 키를 확인하고 API 크레딧 잔액을 별도로 확인합니다.

관련 문서