Talk Mode: 실시간 음성 대화 가이드

코드를 짜다가 문득 손이 꼬이거나, 복잡한 로직을 설명하느라 키보드를 두드리는 게 답답할 때가 있죠. 화면을 계속 쳐다보지 않고도 대화하듯 아이디어를 정리하거나 문제를 풀 수 있다면 개발 흐름을 끊지 않고도 훨씬 효율적으로 작업할 수 있어요.

What You’ll Need

시작하기 전에 다음 항목들이 준비되었는지 확인해 주세요.

Speech 및 Microphone 접근 권한
ElevenLabs API Key (ELEVENLABS_API_KEY)
macOS, iOS 또는 Android 기기

Quick Start

5분 안에 Talk Mode를 설정하고 대화를 시작해 보세요.

1. Config 설정

~/.openclaw/openclaw.json 파일을 열고 아래 설정을 추가하세요. ElevenLabs API Key와 원하는 목소리 ID를 입력하면 됩니다.

{
  talk: {
    voiceId: "elevenlabs_voice_id",
    modelId: "eleven_v3",
    outputFormat: "mp3_44100_128",
    apiKey: "elevenlabs_api_key",
    interruptOnSpeech: true,
  },
}

2. 대화 시작하기

macOS 메뉴바에서 Talk를 클릭하거나 설정 탭의 Talk Mode 그룹에서 기능을 켜세요. 화면에 오버레이가 나타나며 현재 상태를 알려줍니다.

Listening: 구름 모양이 마이크 레벨에 맞춰 깜빡입니다.
Thinking: 싱킹(sinking) 애니메이션이 작동합니다.
Speaking: 고리 모양이 퍼져 나갑니다.

3. 음성 제어하기

모델의 답변 맨 첫 줄에 JSON 데이터를 넣어 목소리를 실시간으로 제어할 수 있습니다. 특정 답변에만 적용하고 싶다면 once: true를 사용하세요.

{ "voice": "<voice-id>", "once": true }

4. 상호작용 팁

말 끊기: 어시스턴트가 말하는 도중에 사용자가 말을 시작하면 재생이 즉시 중단됩니다. (interruptOnSpeech 옵션)
강제 종료: 오버레이의 구름을 클릭하면 음성 재생이 멈추고, X를 누르면 Talk Mode가 종료됩니다.

Troubleshooting

사용 중 문제가 발생하면 아래 내용을 확인해 보세요.

샘플 레이트 문제: macOS/iOS는 pcm_44100, Android는 pcm_24000이 기본값입니다. 특정 환경에서 스트리밍 문제가 있다면 outputFormat을 mp3_* 형식으로 설정해 보세요.
지연 시간(Latency): 응답이 느리다면 latency_tier를 0에서 4 사이의 값으로 조정하여 최적의 지연 시간을 찾을 수 있습니다.
모델 설정 오류: eleven_v3 모델 사용 시 stability 값은 0.0, 0.5, 1.0 중 하나여야 합니다. 다른 모델은 0에서 1 사이의 값을 사용할 수 있습니다.

설정 과정에서 도움이 필요하다면 AI Setup Assistant에게 물어보세요.

What’s Next

OpenClaw Expert

아직 막혀 있나요?

이 문서에서 답을 못 찾았다면 OpenClaw Expert에게 바로 물어보세요.