1.8 KiB
1.8 KiB
name, description
| name | description |
|---|---|
| add-voice-transcription | Enable Discord voice transcription using Groq Whisper with OpenAI fallback. |
Add Voice Transcription
디스코드 음성 첨부 전사는 이미 코드에 들어 있습니다. 현재 구현은 src/channels/discord.ts에 있고, 별도 브랜치 머지나 채널 추가 작업은 필요 없습니다.
우선순위는 Groq Whisper -> OpenAI Whisper fallback 입니다.
1. 환경 변수 설정
.env에 아래 중 하나 이상을 넣습니다.
GROQ_API_KEY=gsk_... # 권장. 빠르고 무료 티어가 있음
OPENAI_API_KEY=sk-... # fallback
Groq를 쓰면 whisper-large-v3-turbo, OpenAI를 쓰면 whisper-1 경로를 탑니다.
2. 재시작
npm run build
npm run setup -- --step service
이미 서비스가 떠 있다면 플랫폼에 맞게 재시작만 해도 됩니다.
3. 검증
등록된 디스코드 채널에 음성 메시지나 오디오 첨부를 보냅니다. 정상이라면 에이전트 입력에 전사 텍스트가 포함됩니다.
tail -f logs/nanoclaw.log | grep -iE 'transcri|audio'
성공 신호:
Audio transcribed + cachedprovider: "groq"또는provider: "openai"- 동일 첨부 재처리 시 cache hit
Troubleshooting
전사가 전혀 안 됨
.env에GROQ_API_KEY나OPENAI_API_KEY가 없는 경우가 대부분입니다.- 서비스 재시작 전에는 새 키가 반영되지 않습니다.
너무 느림
- 로그에
provider: "groq"가 안 보이면 Groq 키가 빠졌거나 잘못된 상태입니다.
채널에서는 보이는데 에이전트가 못 읽음
- 채널 등록과 서비스 상태를 먼저 확인합니다.
npm run setup -- --step verify결과에서REGISTERED_GROUPS와SERVICE를 같이 봅니다.