OpenClaw 한국어 문서

Appearance

OpenClaw는 text-to-speech, Scribe v2를 사용한 배치 speech-to-text, 그리고 Scribe v2 Realtime을 사용한 Voice Call 스트리밍 STT에 ElevenLabs를 사용합니다.

기능OpenClaw 표면기본값
Text-to-speechmessages.tts / talkeleven_multilingual_v2
배치 speech-to-texttools.media.audioscribe_v2
스트리밍 speech-to-textVoice Call streaming.provider: "elevenlabs"scribe_v2_realtime

인증 ​

환경에 ELEVENLABS_API_KEY를 설정하십시오. 기존 ElevenLabs 도구와의 호환성을 위해 XI_API_KEY도 허용됩니다.

bash
export ELEVENLABS_API_KEY="..."

Text-to-speech ​

json5
{
  messages: {
    tts: {
      providers: {
        elevenlabs: {
          apiKey: "${ELEVENLABS_API_KEY}",
          voiceId: "pMsXgVXv3BLzUgSXRplE",
          modelId: "eleven_multilingual_v2",
        },
      },
    },
  },
}

Speech-to-text ​

인바운드 오디오 첨부 파일과 짧은 녹음 음성 세그먼트에는 Scribe v2를 사용하십시오:

json5
{
  tools: {
    media: {
      audio: {
        enabled: true,
        models: [{ provider: "elevenlabs", model: "scribe_v2" }],
      },
    },
  },
}

OpenClaw는 model_id: "scribe_v2"로 ElevenLabs /v1/speech-to-text에 multipart 오디오를 전송합니다. 언어 힌트는 존재하는 경우 language_code에 매핑됩니다.

Voice Call 스트리밍 STT ​

번들 elevenlabs 플러그인은 Voice Call 스트리밍 전사를 위해 Scribe v2 Realtime을 등록합니다.

설정구성 경로기본값
API 키plugins.entries.voice-call.config.streaming.providers.elevenlabs.apiKeyELEVENLABS_API_KEY / XI_API_KEY로 폴백
모델...elevenlabs.modelIdscribe_v2_realtime
오디오 포맷...elevenlabs.audioFormatulaw_8000
샘플 레이트...elevenlabs.sampleRate8000
커밋 전략...elevenlabs.commitStrategyvad
언어...elevenlabs.languageCode(설정 없음)
json5
{
  plugins: {
    entries: {
      "voice-call": {
        config: {
          streaming: {
            enabled: true,
            provider: "elevenlabs",
            providers: {
              elevenlabs: {
                apiKey: "${ELEVENLABS_API_KEY}",
                audioFormat: "ulaw_8000",
                commitStrategy: "vad",
                languageCode: "en",
              },
            },
          },
        },
      },
    },
  },
}

NOTE

Voice Call은 Twilio 미디어를 8 kHz G.711 u-law로 수신합니다. ElevenLabs 실시간 provider는 기본값으로 ulaw_8000을 사용하므로 전화망 프레임을 트랜스코딩 없이 전달할 수 있습니다.

관련 항목 ​