Providers
Deepgram
Deepgram es una API de conversión de voz a texto. OpenClaw la utiliza para la transcripción
de audio entrante y notas de voz mediante tools.media.audio, y para la conversión de voz
a texto en streaming de Voice Call mediante plugins.entries.voice-call.config.streaming.
La transcripción por lotes carga el archivo de audio completo en Deepgram e inserta
la transcripción en el flujo de respuestas (bloque {{Transcript}} + [Audio]).
El streaming de Voice Call reenvía en directo las tramas G.711 u-law a través del
endpoint WebSocket listen de Deepgram y emite transcripciones parciales
y finales a medida que Deepgram las devuelve.
| Detalle | Valor |
|---|---|
| Sitio web | deepgram.com |
| Documentación | developers.deepgram.com |
| Autenticación | DEEPGRAM_API_KEY |
| Modelo predeterminado | nova-3 |
Primeros pasos
Establecer la clave de API
DEEPGRAM_API_KEY=dg_...Activar el proveedor de audio
{ tools: { media: { audio: { enabled: true, models: [{ provider: "deepgram", model: "nova-3" }], }, }, },}Enviar una nota de voz
Envíe un mensaje de audio a través de cualquier canal conectado. OpenClaw lo transcribe mediante Deepgram e inserta la transcripción en el flujo de respuestas.
Opciones de configuración
| Opción | Ruta | Descripción |
|---|---|---|
model |
tools.media.audio.models[].model |
ID del modelo de Deepgram (valor predeterminado: nova-3) |
language |
tools.media.audio.models[].language |
Indicación de idioma (opcional) |
providerOptions.deepgram combina parámetros de consulta adicionales directamente con la
solicitud /listen de Deepgram, por lo que se admite cualquier nombre de
parámetro compatible con Deepgram (por ejemplo, detect_language,
punctuate y smart_format):
Con indicación de idioma
{ tools: { media: { audio: { enabled: true, models: [{ provider: "deepgram", model: "nova-3", language: "en" }], }, }, },}Con opciones de Deepgram
{ tools: { media: { audio: { enabled: true, providerOptions: { deepgram: { detect_language: true, punctuate: true, smart_format: true, }, }, models: [{ provider: "deepgram", model: "nova-3" }], }, }, },}Conversión de voz a texto en streaming de Voice Call
El plugin deepgram incluido también registra un proveedor de transcripción
en tiempo real para el plugin Voice Call.
| Ajuste | Ruta de configuración | Valor predeterminado |
|---|---|---|
| Clave de API | plugins.entries.voice-call.config.streaming.providers.deepgram.apiKey |
Recurre a DEEPGRAM_API_KEY |
| URL base | ...deepgram.baseUrl |
DEEPGRAM_BASE_URL o la API pública de Deepgram |
| Modelo | ...deepgram.model |
nova-3 |
| Idioma | ...deepgram.language |
(sin establecer) |
| Codificación | ...deepgram.encoding |
mulaw |
| Frecuencia de muestreo | ...deepgram.sampleRate |
8000 |
| Detección de fin de intervención | ...deepgram.endpointingMs |
800 |
| Resultados provisionales | ...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", }, }, }, }, }, }, },}Para usar un endpoint personalizado de Deepgram,
establezca baseUrl en la raíz del endpoint, incluida cualquier ruta base,
pero no /listen. Los endpoints en tiempo real aceptan http://,
https://, ws:// y wss://. HTTP se asigna a WS,
HTTPS se asigna a WSS y los esquemas WebSocket explícitos permanecen sin cambios.
Las URL mal formadas y otros esquemas provocan un error durante la configuración
de la sesión.
Notas
Autenticación
La autenticación sigue el orden estándar de autenticación de proveedores.
DEEPGRAM_API_KEY es la ruta más sencilla.
Proxy y endpoints personalizados
Sobrescriba los endpoints o encabezados con tools.media.audio.baseUrl y
tools.media.audio.headers al utilizar un proxy.
Comportamiento de la salida
La salida sigue las mismas reglas de audio que los demás proveedores (límites de tamaño, tiempos de espera e inserción de la transcripción).
Contenido relacionado
Descripción general del flujo de procesamiento de audio, imágenes y vídeo.
Referencia de configuración completa, incluidos los ajustes de las herramientas multimedia.
Problemas comunes y pasos de depuración.
Preguntas frecuentes sobre la configuración de OpenClaw.
