Deepgram

Deepgram은 음성을 텍스트로 변환하는 API입니다. OpenClaw은 tools.media.audio을 통한 수신 오디오/음성 메모 전사와 plugins.entries.voice-call.config.streaming을 통한 음성 통화 스트리밍 STT에 이를 사용합니다.

일괄 전사는 전체 오디오 파일을 Deepgram에 업로드하고 전사문을 응답 파이프라인에 삽입합니다({{Transcript}} + [Audio] 블록). 음성 통화 스트리밍은 실시간 G.711 u-law 프레임을 Deepgram의 WebSocket listen 엔드포인트로 전달하고, Deepgram이 반환하는 대로 부분/최종 전사문을 내보냅니다.

시작하기

DEEPGRAM_API_KEY=dg_...

{  tools: {    media: {      audio: {        enabled: true,        models: [{ provider: "deepgram", model: "nova-3" }],      },    },  },}

구성 옵션

providerOptions.deepgram은 추가 쿼리 매개변수를 Deepgram /listen 요청에 직접 병합하므로 Deepgram에서 지원하는 모든 매개변수 이름을 사용할 수 있습니다 (예: detect_language, punctuate, smart_format).

{  tools: {    media: {      audio: {        enabled: true,        models: [{ provider: "deepgram", model: "nova-3", language: "en" }],      },    },  },}

{  tools: {    media: {      audio: {        enabled: true,        providerOptions: {          deepgram: {            detect_language: true,            punctuate: true,            smart_format: true,          },        },        models: [{ provider: "deepgram", model: "nova-3" }],      },    },  },}

음성 통화 스트리밍 STT

번들로 제공되는 deepgram Plugin은 음성 통화 Plugin용 실시간 전사 제공자도 등록합니다.

{  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 사용자 지정 엔드포인트의 경우 baseUrl을 기본 경로를 포함하되 /listen은 제외한 엔드포인트 루트로 설정하십시오. 실시간 엔드포인트는 http://, https://, ws://, wss://을 허용합니다. HTTP는 WS로, HTTPS는 WSS로 매핑되며 명시적인 WebSocket 스킴은 변경되지 않습니다. 잘못된 형식의 URL과 기타 스킴은 세션 설정 중 실패합니다.

참고 사항

관련 문서