Providers
Deepgram
Deepgram은 음성을 텍스트로 변환하는 API입니다. OpenClaw은 tools.media.audio를 통한
수신 오디오/음성 메모 전사와 plugins.entries.voice-call.config.streaming을 통한
Voice Call 스트리밍 STT에 이 API를 사용합니다.
일괄 전사는 전체 오디오 파일을 Deepgram에 업로드하고 전사문을
응답 파이프라인에 삽입합니다({{Transcript}} + [Audio] 블록).
Voice Call 스트리밍은 실시간 G.711 u-law 프레임을 Deepgram의
WebSocket listen 엔드포인트로 전달하고, Deepgram에서 반환되는
부분/최종 전사문을 내보냅니다.
| 세부 정보 | 값 |
|---|---|
| 웹사이트 | deepgram.com |
| 문서 | developers.deepgram.com |
| 인증 | DEEPGRAM_API_KEY |
| 기본 모델 | nova-3 |
시작하기
API 키 설정
DEEPGRAM_API_KEY=dg_...오디오 제공자 활성화
{ tools: { media: { audio: { enabled: true, models: [{ provider: "deepgram", model: "nova-3" }], }, }, },}음성 메모 보내기
연결된 채널을 통해 오디오 메시지를 보내세요. OpenClaw은 Deepgram을 통해 이를 전사하고 전사문을 응답 파이프라인에 삽입합니다.
구성 옵션
| 옵션 | 경로 | 설명 |
|---|---|---|
model |
tools.media.audio.models[].model |
Deepgram 모델 ID(기본값: nova-3) |
language |
tools.media.audio.models[].language |
언어 힌트(선택 사항) |
providerOptions.deepgram은 추가 쿼리 매개변수를 Deepgram /listen
요청에 직접 병합하므로, Deepgram에서 지원하는 모든 매개변수 이름을 사용할 수 있습니다
(예: detect_language, punctuate, smart_format).
언어 힌트 사용
{ tools: { media: { audio: { enabled: true, models: [{ provider: "deepgram", model: "nova-3", language: "en" }], }, }, },}Deepgram 옵션 사용
{ tools: { media: { audio: { enabled: true, providerOptions: { deepgram: { detect_language: true, punctuate: true, smart_format: true, }, }, models: [{ provider: "deepgram", model: "nova-3" }], }, }, },}Voice Call 스트리밍 STT
번들로 제공되는 deepgram Plugin은 Voice Call Plugin용 실시간 전사 제공자도
등록합니다.
| 설정 | 구성 경로 | 기본값 |
|---|---|---|
| API 키 | plugins.entries.voice-call.config.streaming.providers.deepgram.apiKey |
DEEPGRAM_API_KEY로 대체 |
| 모델 | ...deepgram.model |
nova-3 |
| 언어 | ...deepgram.language |
(설정되지 않음) |
| 인코딩 | ...deepgram.encoding |
mulaw |
| 샘플링 레이트 | ...deepgram.sampleRate |
8000 |
| 엔드포인트 감지 | ...deepgram.endpointingMs |
800 |
| 중간 결과 | ...deepgram.interimResults |
true |
{ plugins: { entries: { "voice-call": { config: { streaming: { enabled: true, provider: "deepgram", providers: { deepgram: { apiKey: "${DEEPGRAM_API_KEY}", model: "nova-3", endpointingMs: 800, language: "en-US", }, }, }, }, }, }, },}참고 사항
인증
인증은 표준 제공자 인증 순서를 따릅니다. DEEPGRAM_API_KEY를 사용하는 것이
가장 간단합니다.
프록시 및 사용자 지정 엔드포인트
프록시를 사용할 때는 tools.media.audio.baseUrl 및
tools.media.audio.headers로 엔드포인트나 헤더를 재정의하세요.
출력 동작
출력은 다른 제공자와 동일한 오디오 규칙(크기 제한, 시간 초과, 전사문 삽입)을 따릅니다.
