Deepgram 是语音转文字(STT)API,在 OpenClaw 中用于:

  • 批量转录:通过 tools.media.audio 处理音频附件
  • Voice Call 实时流式 STT:通过 WebSocket listen 端点转发 G.711 u-law 帧
属性值
认证DEEPGRAM_API_KEY
默认模型nova-3
官网deepgram.com

快速开始

export DEEPGRAM_API_KEY=dg_...
{
  tools: {
    media: {
      audio: {
        enabled: true,
        models: [{ provider: "deepgram", model: "nova-3" }],
      },
    },
  },
}

配置选项

选项路径说明
modeltools.media.audio.models[].model模型 ID,默认 nova-3
languagetools.media.audio.models[].language语言提示(可选)
detect_languagetools.media.audio.providerOptions.deepgram.detect_language自动检测语言
punctuate...deepgram.punctuate启用标点
smart_format...deepgram.smart_format智能格式化

Voice Call 流式 STT

参数默认值
模型nova-3
编码mulaw
采样率8000
端点检测800ms
中间结果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",
              },
            },
          },
        },
      },
    },
  },
}

Twilio 电话音频为 8 kHz G.711 u-law,Deepgram 默认 encoding: "mulaw" + sampleRate: 8000 可直接转发。

相关链接