Providers
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
{ tools: { media: { audio: { enabled: true, models: [{ provider: "deepgram", model: "nova-3", language: "en" }], }, }, },}Met Deepgram-opties
{ 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.
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
Overzicht van de verwerkingspijplijn voor audio, afbeeldingen en video.
Volledige configuratiereferentie, inclusief instellingen voor mediatools.
Veelvoorkomende problemen en stappen voor foutopsporing.
Veelgestelde vragen over het instellen van OpenClaw.
