Providers
Deepgram
Deepgram è un'API di conversione da voce a testo. OpenClaw la utilizza per la trascrizione
dell'audio in ingresso e delle note vocali tramite tools.media.audio e per lo STT in streaming
delle chiamate vocali tramite plugins.entries.voice-call.config.streaming.
La trascrizione in batch carica il file audio completo su Deepgram e inserisce
la trascrizione nella pipeline di risposta ({{Transcript}} + blocco [Audio]).
Lo streaming delle chiamate vocali inoltra in tempo reale i frame G.711 u-law tramite
l'endpoint WebSocket listen di Deepgram ed emette trascrizioni parziali e finali
man mano che Deepgram le restituisce.
| Dettaglio | Valore |
|---|---|
| Sito web | deepgram.com |
| Documentazione | developers.deepgram.com |
| Autenticazione | DEEPGRAM_API_KEY |
| Modello predefinito | nova-3 |
Guida introduttiva
Imposta la chiave API
DEEPGRAM_API_KEY=dg_...Abilita il provider audio
{ tools: { media: { audio: { enabled: true, models: [{ provider: "deepgram", model: "nova-3" }], }, }, },}Invia una nota vocale
Invia un messaggio audio tramite qualsiasi canale connesso. OpenClaw lo trascrive tramite Deepgram e inserisce la trascrizione nella pipeline di risposta.
Opzioni di configurazione
| Opzione | Percorso | Descrizione |
|---|---|---|
model |
tools.media.audio.models[].model |
ID del modello Deepgram (predefinito: nova-3) |
language |
tools.media.audio.models[].language |
Indicazione della lingua (facoltativa) |
providerOptions.deepgram integra parametri di query aggiuntivi direttamente nella
richiesta /listen di Deepgram, quindi è possibile utilizzare qualsiasi nome di parametro
supportato da Deepgram (ad esempio detect_language, punctuate, smart_format):
Con indicazione della lingua
{ tools: { media: { audio: { enabled: true, models: [{ provider: "deepgram", model: "nova-3", language: "en" }], }, }, },}Con opzioni Deepgram
{ tools: { media: { audio: { enabled: true, providerOptions: { deepgram: { detect_language: true, punctuate: true, smart_format: true, }, }, models: [{ provider: "deepgram", model: "nova-3" }], }, }, },}STT in streaming delle chiamate vocali
Il Plugin deepgram incluso registra anche un provider di trascrizione in tempo reale
per il Plugin delle chiamate vocali.
| Impostazione | Percorso di configurazione | Valore predefinito |
|---|---|---|
| Chiave API | plugins.entries.voice-call.config.streaming.providers.deepgram.apiKey |
Utilizza in alternativa DEEPGRAM_API_KEY |
| Modello | ...deepgram.model |
nova-3 |
| Lingua | ...deepgram.language |
(non impostata) |
| Codifica | ...deepgram.encoding |
mulaw |
| Frequenza di campionamento | ...deepgram.sampleRate |
8000 |
| Rilevamento della fine del parlato | ...deepgram.endpointingMs |
800 |
| Risultati intermedi | ...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", }, }, }, }, }, }, },}Note
Autenticazione
L'autenticazione segue l'ordine standard di autenticazione dei provider. DEEPGRAM_API_KEY è
il percorso più semplice.
Proxy ed endpoint personalizzati
Quando utilizzi un proxy, sostituisci gli endpoint o le intestazioni tramite
tools.media.audio.baseUrl e tools.media.audio.headers.
Comportamento dell'output
L'output segue le stesse regole audio degli altri provider (limiti di dimensione, timeout, inserimento della trascrizione).
Contenuti correlati
Panoramica della pipeline di elaborazione di audio, immagini e video.
Riferimento completo della configurazione, incluse le impostazioni degli strumenti multimediali.
Problemi comuni e passaggi per il debug.
Domande frequenti sulla configurazione di OpenClaw.
