Deepgram

Deepgram is een spraak-naar-tekst-API. OpenClaw gebruikt deze voor de transcriptie van inkomende audio en spraakberichten via tools.media.audio en voor streaming-STT van Voice Call via plugins.entries.voice-call.config.streaming. Bij batchtranscriptie wordt het volledige audiobestand naar Deepgram geüpload en wordt het transcript in de antwoordpijplijn ingevoegd ({{Transcript}} + [Audio]-blok). Voice Call-streaming stuurt live G.711-u-law-frames via Deepgrams WebSocket-listen-endpoint door en geeft gedeeltelijke/definitieve transcripties uit zodra Deepgram deze retourneert.

Detail	Waarde
Website	deepgram.com
Documentatie	developers.deepgram.com
Authenticatie	`DEEPGRAM_API_KEY`
Standaardmodel	`nova-3`

Aan de slag

Stel je API-sleutel in

DEEPGRAM_API_KEY=dg_...

Schakel de audioprovider in

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

Stuur een spraakbericht

Stuur een audiobericht via een verbonden kanaal. OpenClaw transcribeert het via Deepgram en voegt het transcript in de antwoordpijplijn in.

Configuratieopties

Optie	Pad	Beschrijving
`model`	`tools.media.models[].model`	Deepgram-model-id (standaard: `nova-3`)
`language`	`tools.media.models[].language`	Taalhint (optioneel)

providerOptions.deepgram voegt extra queryparameters rechtstreeks samen met het Deepgram-/listen-verzoek, zodat elke door Deepgram ondersteunde parameternaam werkt (bijvoorbeeld detect_language, punctuate, smart_format):

Met taalhint
Met Deepgram-opties

{
  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" }],
      },
    },
  },
}

Streaming-STT van Voice Call

De meegeleverde deepgram-plugin registreert ook een realtime transcriptieprovider voor de Voice Call-plugin.

Instelling	Configuratiepad	Standaard
API-sleutel	`plugins.entries.voice-call.config.streaming.providers.deepgram.apiKey`	Valt terug op `DEEPGRAM_API_KEY`
Basis-URL	`...deepgram.baseUrl`	`DEEPGRAM_BASE_URL` of Deepgrams openbare API
Model	`...deepgram.model`	`nova-3`
Taal	`...deepgram.language`	(niet ingesteld)
Codering	`...deepgram.encoding`	`mulaw`
Bemonsteringsfrequentie	`...deepgram.sampleRate`	`8000`
Endpointing	`...deepgram.endpointingMs`	`800`
Tussentijdse resultaten	`...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",
              },
            },
          },
        },
      },
    },
  },
}

Stel voor een aangepast Deepgram-endpoint baseUrl in op de hoofdmap van het endpoint, inclusief een eventueel basispad maar zonder /listen. Realtime-endpoints accepteren http://, https://, ws:// en wss://. HTTP wordt aan WS gekoppeld, HTTPS aan WSS en expliciete WebSocket-schema’s blijven ongewijzigd. Ongeldige URL’s en andere schema’s veroorzaken een fout tijdens het instellen van de sessie.

Voice Call ontvangt telefonieaudio als 8 kHz G.711 u-law. De streamingprovider van Deepgram gebruikt standaard encoding: "mulaw" en sampleRate: 8000, zodat Twilio-mediaframes rechtstreeks kunnen worden doorgestuurd.

Opmerkingen

Authenticatie

Authenticatie volgt de standaardvolgorde voor providerauthenticatie. DEEPGRAM_API_KEY is de eenvoudigste methode.

Proxy en aangepaste endpoints

Overschrijf endpoints of headers in de Deepgram-tools.media.models[]-vermelding wanneer je een proxy gebruikt.

Uitvoergedrag

De uitvoer volgt dezelfde audioregels als andere providers (groottelimieten, time-outs, invoeging van transcripties).

Gerelateerd

Mediatools

Overzicht van de verwerkingspijplijn voor audio, afbeeldingen en video.

Configuratie

Volledige configuratiereferentie, inclusief instellingen voor mediatools.

Probleemoplossing

Veelvoorkomende problemen en stappen voor foutopsporing.

Veelgestelde vragen

Veelgestelde vragen over het instellen van OpenClaw.

Overview

Concepts and configuration

Providers

Aan de slag

Configuratieopties

Streaming-STT van Voice Call

Opmerkingen

Gerelateerd

Mediatools

Configuratie

Probleemoplossing

Veelgestelde vragen

​Aan de slag

​Configuratieopties

​Streaming-STT van Voice Call

​Opmerkingen

​Gerelateerd

Mediatools

Configuratie

Probleemoplossing

Veelgestelde vragen

Aan de slag

Configuratieopties

Streaming-STT van Voice Call

Opmerkingen

Gerelateerd