Plugin de llamadas de voz

Llamadas de voz para OpenClaw mediante un plugin: notificaciones salientes, conversaciones de varios turnos, voz en tiempo real con dúplex completo, transcripción en streaming y llamadas entrantes con políticas de listas de permitidos.

Proveedores: mock (desarrollo, sin red), plivo (API de voz + transferencia XML + voz de GetInput), telnyx (Call Control v2), twilio (voz programable + Media Streams).

Inicio rápido

openclaw plugins install @openclaw/voice-call

PLUGIN_SRC=./path/to/local/voice-call-pluginopenclaw plugins install "$PLUGIN_SRC"cd "$PLUGIN_SRC" && pnpm install

openclaw voicecall setupopenclaw voicecall setup --json

openclaw voicecall smokeopenclaw voicecall smoke --to "+15555550123"

openclaw voicecall smoke --to "+15555550123" --yes

Configuración

Si enabled: true pero al proveedor seleccionado le faltan credenciales, el inicio del Gateway registra una advertencia de configuración incompleta con las claves que faltan y omite el inicio del entorno de ejecución. Los comandos, las llamadas RPC y las herramientas del agente siguen devolviendo la configuración exacta que falta cuando se utilizan.

{  plugins: {    entries: {      "voice-call": {        enabled: true,        config: {          provider: "twilio", // o "telnyx" | "plivo" | "mock"          fromNumber: "+15550001234", // o TWILIO_FROM_NUMBER para Twilio          toNumber: "+15550005678",          sessionScope: "per-phone", // per-phone | per-call          numbers: {            "+15550009999": {              inboundGreeting: "Silver Fox Cards, ¿en qué puedo ayudar?",              responseSystemPrompt: "Eres un especialista conciso en tarjetas de béisbol.",              tts: {                providers: {                  openai: { speakerVoice: "alloy" },                },              },            },          },           twilio: {            accountSid: "ACxxxxxxxx",            authToken: "...",            // region: "ie1", // opcional: us1 | ie1 | au1; el valor predeterminado es us1          },          telnyx: {            apiKey: "...",            connectionId: "...",            // Clave pública del webhook de Telnyx del Mission Control Portal            // (Base64; también se puede establecer mediante TELNYX_PUBLIC_KEY).            publicKey: "...",          },          plivo: {            authId: "MAxxxxxxxxxxxxxxxxxxxx",            authToken: "...",          },           // Servidor de webhook          serve: {            port: 3334,            path: "/voice/webhook",          },           // Seguridad del webhook (recomendada para túneles/proxies)          webhookSecurity: {            allowedHosts: ["voice.example.com"],            trustedProxyIPs: ["100.64.0.1"],          },           // Exposición pública (elija una opción)          // publicUrl: "https://example.ngrok.app/voice/webhook",          // tunnel: { provider: "ngrok" },          // tailscale: { mode: "funnel", path: "/voice/webhook" },           outbound: {            defaultMode: "notify", // notify | conversation          },           streaming: { enabled: true /* solo Twilio; consulte Transcripción en streaming */ },          realtime: { enabled: false /* consulte Conversaciones de voz en tiempo real */ },        },      },    },  },}

Referencia de configuración

Claves de nivel superior en plugins.entries.voice-call.config que no se muestran arriba:

Twilio utiliza de forma predeterminada su punto de conexión REST US1. Para procesar llamadas en una región fuera de EE. UU. compatible, se debe establecer twilio.region en ie1 o au1 y usar credenciales de esa región. Consulte la guía de la API REST de Twilio para regiones fuera de EE. UU..

Ámbito de la sesión

De forma predeterminada, las llamadas de voz utilizan sessionScope: "per-phone" para que las llamadas repetidas de la misma persona conserven la memoria de la conversación. Se debe establecer sessionScope: "per-call" cuando cada llamada del operador deba comenzar con un contexto nuevo, por ejemplo, en flujos de recepción, reservas, IVR o puente de Google Meet en los que el mismo número de teléfono pueda representar reuniones diferentes.

Las llamadas de voz almacenan las claves de sesión generadas en el espacio de nombres del agente configurado (agent:<agentId>:voice:*). Las claves de integración explícitas sin procesar se resuelven en el mismo espacio de nombres: una clave agent:<configuredAgentId>:* canónica conserva ese propietario y respeta los alias de ámbito session.mainKey/global del núcleo; la entrada agent:* externa o con formato incorrecto se limita como una clave opaca en el agente configurado; global y unknown siguen siendo centinelas globales.

Conversaciones de voz en tiempo real

realtime selecciona un proveedor de voz en tiempo real con dúplex completo para el audio de llamadas en directo. Es independiente de streaming, que solo reenvía audio a proveedores de transcripción en tiempo real.

Comportamiento actual del entorno de ejecución:

• realtime.enabled es compatible con Twilio y Telnyx.
• realtime.provider es opcional. Si no se establece, Llamadas de voz usa el primer proveedor de voz en tiempo real registrado.
• Proveedores de voz en tiempo real incluidos: Google Gemini Live (google) y OpenAI (openai), registrados por sus Plugins de proveedor.
• La configuración sin procesar propiedad del proveedor se encuentra en realtime.providers.<providerId>.
• Llamadas de voz expone de forma predeterminada la herramienta compartida en tiempo real openclaw_agent_consult. El modelo en tiempo real puede llamarla cuando quien llama solicita un razonamiento más profundo, información actual o herramientas normales de OpenClaw.
• realtime.consultPolicy añade opcionalmente instrucciones sobre cuándo debe el modelo en tiempo real llamar a openclaw_agent_consult.
• realtime.agentContext.enabled está desactivado de forma predeterminada. Cuando se activa, Llamadas de voz inserta una identidad acotada del agente y una cápsula seleccionada de archivos del espacio de trabajo en las instrucciones del proveedor en tiempo real al configurar la sesión.
• realtime.fastContext.enabled está desactivado de forma predeterminada. Cuando se activa, Llamadas de voz busca primero en la memoria indexada y el contexto de la sesión la pregunta de consulta, y devuelve esos fragmentos al modelo en tiempo real dentro de realtime.fastContext.timeoutMs antes de recurrir al agente de consulta completo, únicamente si realtime.fastContext.fallbackToConsult es true.
• Si realtime.provider apunta a un proveedor no registrado, o si no hay ningún proveedor de voz en tiempo real registrado, Llamadas de voz registra una advertencia y omite los medios en tiempo real en lugar de hacer que falle todo el Plugin.
• inboundPolicy no debe ser "disabled" cuando realtime.enabled es true; validateProviderConfig rechaza esa combinación.
• Las claves de sesión de consulta reutilizan la sesión de llamada almacenada cuando está disponible y, después, recurren al sessionScope configurado (per-phone de forma predeterminada, o per-call para llamadas aisladas).

Política de herramientas

realtime.toolPolicy controla la ejecución de la consulta:

realtime.consultPolicy controla únicamente las instrucciones del modelo en tiempo real:

Contexto de voz del agente

Active realtime.agentContext cuando el puente de voz deba sonar como el agente de OpenClaw configurado sin incurrir en un recorrido completo de consulta al agente en los turnos normales. La cápsula de contexto se añade una sola vez cuando se crea la sesión en tiempo real, por lo que no añade latencia por turno. Las llamadas a openclaw_agent_consult siguen ejecutando el agente completo de OpenClaw y deben usarse para trabajos con herramientas, información actual, consultas de memoria o estado del espacio de trabajo.

{  plugins: {    entries: {      "voice-call": {        config: {          agentId: "main",          realtime: {            enabled: true,            provider: "google",            toolPolicy: "safe-read-only",            consultPolicy: "substantive",            agentContext: {              enabled: true,              maxChars: 6000,              includeIdentity: true,              includeWorkspaceFiles: true,              files: ["SOUL.md", "IDENTITY.md", "USER.md"],            },          },        },      },    },  },}

Ejemplos de proveedores en tiempo real

{  plugins: {    entries: {      "voice-call": {        config: {          provider: "twilio",          inboundPolicy: "allowlist",          allowFrom: ["+15550005678"],          realtime: {            enabled: true,            provider: "google",            instructions: "Habla brevemente. Llama a openclaw_agent_consult antes de usar herramientas más avanzadas.",            toolPolicy: "safe-read-only",            consultPolicy: "substantive",            consultThinkingLevel: "low",            consultFastMode: true,            agentContext: { enabled: true },            providers: {              google: {                apiKey: "${GEMINI_API_KEY}",                model: "gemini-3.1-flash-live-preview",                speakerVoice: "Kore",                silenceDurationMs: 500,                startSensitivity: "high",              },            },          },        },      },    },  },}

{  plugins: {    entries: {      "voice-call": {        config: {          realtime: {            enabled: true,            provider: "openai",            providers: {              openai: { apiKey: "${OPENAI_API_KEY}" },            },          },        },      },    },  },}

Consulte Proveedor de Google y Proveedor de OpenAI para conocer las opciones de voz en tiempo real específicas de cada proveedor.

Transcripción en streaming

streaming conecta Twilio Media Streams con un proveedor de transcripción en tiempo real. La ruta clásica de streaming requiere provider: "twilio"; se rechaza la configuración con Telnyx, Plivo o un proveedor simulado. El audio en directo de Telnyx usa en su lugar la ruta realtime.enabled, que se autentica por separado.

Comportamiento actual en tiempo de ejecución:

• streaming.provider es opcional. Si no se establece, Llamadas de voz usa el primer proveedor de transcripción en tiempo real registrado.
• Proveedores de transcripción en tiempo real incluidos: Deepgram (deepgram), ElevenLabs (elevenlabs), Mistral (mistral), OpenAI (openai) y xAI (xai), registrados por sus Plugins de proveedor.
• La configuración sin procesar propiedad del proveedor se encuentra en streaming.providers.<providerId>.
• Después de que Twilio envía un mensaje start de streaming aceptado, Llamadas de voz registra el streaming inmediatamente, pone en cola los medios entrantes mediante el proveedor de transcripción mientras este se conecta e inicia el saludo inicial únicamente cuando la transcripción en tiempo real está lista.
• Si streaming.provider apunta a un proveedor no registrado, o si no hay ninguno registrado, Llamadas de voz registra una advertencia y omite el streaming de medios en lugar de hacer que falle todo el Plugin.

Ejemplos de proveedores de streaming

{  plugins: {    entries: {      "voice-call": {        config: {          streaming: {            enabled: true,            provider: "openai",            streamPath: "/voice/stream",            providers: {              openai: {                apiKey: "sk-...", // opcional si OPENAI_API_KEY está establecido                model: "gpt-4o-transcribe",                silenceDurationMs: 800,                vadThreshold: 0.5,              },            },          },        },      },    },  },}

{  plugins: {    entries: {      "voice-call": {        config: {          streaming: {            enabled: true,            provider: "xai",            streamPath: "/voice/stream",            providers: {              xai: {                apiKey: "${XAI_API_KEY}", // opcional si XAI_API_KEY está establecido                endpointingMs: 800,                language: "en",              },            },          },        },      },    },  },}

TTS para llamadas

Llamadas de voz usa la configuración principal messages.tts para transmitir voz en las llamadas. Puede sobrescribirla en la configuración del Plugin con la misma estructura; se combina de forma profunda con messages.tts.

{  tts: {    provider: "elevenlabs",    providers: {      elevenlabs: {        speakerVoiceId: "pMsXgVXv3BLzUgSXRplE",        modelId: "eleven_multilingual_v2",      },    },  },}

Notas sobre el comportamiento:

• Las claves heredadas tts.<provider> dentro de la configuración del Plugin (openai, elevenlabs, microsoft, edge) se reparan mediante openclaw doctor --fix; la configuración confirmada debe usar tts.providers.<provider>.
• Se usa el TTS principal cuando el streaming de medios de Twilio está activado; de lo contrario, las llamadas recurren a las voces nativas del proveedor.
• Si ya hay un streaming de medios de Twilio activo, Llamadas de voz no recurre a OPENCLAW_DOCS_MARKER:calloutOpen:U2F5 de TwiML. Si el TTS telefónico no está disponible en ese estado, la solicitud de reproducción falla en lugar de mezclar dos rutas de reproducción.
• Cuando el TTS telefónico recurre a un proveedor secundario, Llamadas de voz registra una advertencia con la cadena de proveedores (from, to, attempts) para facilitar la depuración.
• Cuando la interrupción del hablante en Twilio o el cierre del streaming vacían la cola de TTS pendiente, las solicitudes de reproducción en cola se resuelven en lugar de dejar bloqueadas a las personas que llaman mientras esperan que finalice la reproducción.

Ejemplos de TTS

{messages: {tts: {provider: "openai",providers: {  openai: { speakerVoice: "alloy" },},},},}

{plugins: {entries: {"voice-call": {  config: {    tts: {      provider: "elevenlabs",      providers: {        elevenlabs: {          apiKey: "elevenlabs_key",          speakerVoiceId: "pMsXgVXv3BLzUgSXRplE",          modelId: "eleven_multilingual_v2",        },      },    },  },},},},}

{plugins: {entries: {"voice-call": {  config: {    tts: {      providers: {        openai: {          model: "gpt-4o-mini-tts",          speakerVoice: "marin",        },      },    },  },},},},}

Llamadas entrantes

La política de llamadas entrantes utiliza de forma predeterminada disabled. Para habilitar las llamadas entrantes, establezca:

{inboundPolicy: "allowlist",allowFrom: ["+15550001234"],inboundGreeting: "¡Hola! ¿En qué puedo ayudar?",}

Las respuestas automáticas utilizan el sistema de agentes. Ajústelas con responseModel, responseSystemPrompt y responseTimeoutMs.

Enrutamiento por número

Utilice numbers cuando un Plugin de llamadas de voz reciba llamadas para varios números de teléfono y cada número deba comportarse como una línea diferente. Por ejemplo, un número puede utilizar un asistente personal informal, mientras que otro utiliza una identidad empresarial, un agente de respuesta diferente y una voz TTS distinta.

Las rutas se seleccionan a partir del número marcado To proporcionado por el proveedor. Las claves deben ser números E.164. Cuando llega una llamada, Llamadas de voz resuelve una sola vez la ruta coincidente, almacena la ruta encontrada en el registro de la llamada y reutiliza esa configuración efectiva para el saludo, la ruta clásica de respuesta automática, la ruta de consulta en tiempo real y la reproducción TTS. Si ninguna ruta coincide, se utiliza la configuración global de Llamadas de voz. Las llamadas salientes no utilizan numbers; proporcione explícitamente el destino saliente, el mensaje y la sesión al iniciar la llamada.

Actualmente, las sustituciones de ruta admiten:

• inboundGreeting
• tts
• agentId
• responseModel
• responseSystemPrompt
• responseTimeoutMs

El valor de ruta tts se fusiona en profundidad sobre la configuración global tts de Llamadas de voz, por lo que normalmente basta con sustituir la voz del proveedor:

{inboundGreeting: "Hola desde la línea principal.",responseSystemPrompt: "Eres el asistente de voz predeterminado.",tts: {  provider: "openai",  providers: {    openai: { speakerVoice: "coral" },  },},numbers: {  "+15550001111": {    inboundGreeting: "Silver Fox Cards, ¿en qué puedo ayudar?",    responseSystemPrompt: "Eres un especialista conciso en tarjetas de béisbol.",    tts: {      providers: {        openai: { speakerVoice: "alloy" },      },    },  },},}

Contrato de salida hablada

Para las respuestas automáticas, Llamadas de voz añade al prompt del sistema un contrato estricto de salida hablada que exige una respuesta JSON {"spoken":"..."}. Llamadas de voz extrae el texto hablado de forma defensiva:

• Ignora las cargas útiles marcadas como contenido de razonamiento/error.
• Analiza JSON directo, JSON delimitado o claves "spoken" en línea.
• Recurre al texto sin formato y elimina los párrafos introductorios que probablemente sean de planificación o metadatos.

Esto mantiene la reproducción hablada centrada en el texto dirigido a la persona que llama y evita que el texto de planificación se filtre al audio.

Comportamiento al iniciar la conversación

En las llamadas conversation salientes, el manejo del primer mensaje está vinculado al estado de reproducción en vivo:

• El vaciado de la cola por interrupción y la respuesta automática solo se suprimen mientras se está pronunciando activamente el saludo inicial.
• Si falla la reproducción inicial, la llamada vuelve a listening y el mensaje inicial permanece en cola para volver a intentarlo.
• La reproducción inicial para la transmisión de Twilio comienza al conectarse la transmisión sin retraso adicional.
• La interrupción cancela la reproducción activa y elimina las entradas TTS de Twilio que están en cola pero aún no se reproducen. Las entradas eliminadas se resuelven como omitidas, por lo que la lógica de respuesta posterior puede continuar sin esperar un audio que nunca se reproducirá.
• Las conversaciones de voz en tiempo real utilizan el turno inicial de la propia transmisión en tiempo real. Llamadas de voz no publica una actualización TwiML heredada OPENCLAW_DOCS_MARKER:calloutOpen:U2F5 para ese mensaje inicial, por lo que las sesiones <Connect><Stream> salientes permanecen conectadas.

Periodo de gracia al desconectar la transmisión de Twilio

Cuando una transmisión multimedia de Twilio se desconecta, Llamadas de voz espera 2000 ms antes de finalizar automáticamente la llamada:

• Si la transmisión vuelve a conectarse durante ese intervalo, se cancela la finalización automática.
• Si no se vuelve a registrar ninguna transmisión después del periodo de gracia, la llamada finaliza para evitar llamadas activas bloqueadas.

Recolector de llamadas obsoletas

Utilice staleCallReaperSeconds (valor predeterminado: 120) para finalizar las llamadas que nunca se responden ni alcanzan un estado de conversación en vivo, por ejemplo, llamadas en modo de notificación para las que el proveedor nunca entrega un Webhook terminal. Establézcalo en 0 para deshabilitarlo.

El recolector se ejecuta cada 30 segundos y solo finaliza las llamadas que no tienen una marca de tiempo answeredAt y que aún no se encuentran en un estado terminal o en vivo (speaking/listening), por lo que este temporizador nunca recolecta las conversaciones respondidas; maxDurationSeconds (valor predeterminado: 300) es el límite independiente que finaliza las llamadas respondidas que duran demasiado.

En flujos de tipo notificación donde los operadores pueden tardar en entregar los Webhooks de timbrado/respuesta, aumente staleCallReaperSeconds por encima del valor predeterminado para que las llamadas lentas pero normales no se recolecten antes de tiempo; 120-300 segundos es un intervalo razonable para producción.

{plugins: {entries: {  "voice-call": {    config: {      maxDurationSeconds: 300,      staleCallReaperSeconds: 120,    },  },},},}

Seguridad del Webhook

Cuando hay un proxy o túnel delante del Gateway, el plugin reconstruye la URL pública para verificar la firma. Estas opciones controlan qué encabezados reenviados son de confianza:

Protecciones adicionales:

• La protección contra repetición de Webhooks está habilitada para Twilio, Telnyx y Plivo. Las solicitudes de Webhook válidas repetidas se confirman, pero se omiten sus efectos secundarios.
• Los turnos de conversación de Twilio incluyen un token por turno en las devoluciones de llamada <Gather>, de modo que las devoluciones de llamada de voz obsoletas o repetidas no puedan satisfacer un turno de transcripción pendiente más reciente.
• Las solicitudes de Webhook no autenticadas se rechazan antes de leer el cuerpo cuando faltan los encabezados de firma requeridos por el proveedor.
• El Webhook de llamadas de voz utiliza el perfil compartido de lectura del cuerpo previo a la autenticación (cuerpo máximo de 64 KB, tiempo de espera de lectura de 5 segundos), además de un límite de solicitudes en curso por clave (8 solicitudes simultáneas por clave de forma predeterminada), antes de verificar la firma.

Ejemplo con un host público estable:

{plugins: {entries: {  "voice-call": {    config: {      publicUrl: "https://voice.example.com/voice/webhook",      webhookSecurity: {        allowedHosts: ["voice.example.com"],      },    },  },},},}

CLI

openclaw voicecall call --to "+15555550123" --message "Hola desde OpenClaw"openclaw voicecall start --to "+15555550123"   # alias de callopenclaw voicecall continue --call-id <id> --message "¿Alguna pregunta?"openclaw voicecall speak --call-id <id> --message "Un momento"openclaw voicecall dtmf --call-id <id> --digits "ww123456#"openclaw voicecall end --call-id <id>openclaw voicecall status --call-id <id>openclaw voicecall tailopenclaw voicecall latency                      # resume la latencia de los turnos a partir de los registrosopenclaw voicecall expose --mode funnel

Cuando el Gateway ya está en ejecución, los comandos operativos voicecall se delegan al entorno de ejecución de llamadas de voz propiedad del Gateway para que la CLI no vincule un segundo servidor de Webhook. Si no se puede acceder a ningún Gateway, los comandos recurren a un entorno de ejecución independiente de la CLI.

latency lee calls.jsonl desde la ruta de almacenamiento predeterminada de llamadas de voz. Utilice --file <path> para indicar un registro diferente y --last <n> para limitar el análisis a los últimos N registros (valor predeterminado: 200). La salida incluye mínimo/máximo/promedio, p50 y p95 para la latencia de los turnos y los tiempos de espera de escucha.

Herramienta del agente

Nombre de la herramienta: voice_call.

El plugin de llamadas de voz incluye una Skills de agente correspondiente.

RPC del Gateway

dtmfSequence solo es válido con mode: "conversation"; las llamadas en modo de notificación deben usar voicecall.dtmf después de que exista la llamada si necesitan dígitos posteriores a la conexión.

Solución de problemas

La configuración no logra exponer el Webhook

Ejecute la configuración desde el mismo entorno que ejecuta el Gateway:

openclaw voicecall setupopenclaw voicecall setup --json

Para twilio, telnyx y plivo, webhook-exposure debe estar en verde. Un publicUrl configurado también falla cuando apunta a un espacio de red local o privado, porque el operador no puede devolver llamadas a esas direcciones. No utilice localhost, 127.0.0.1, 0.0.0.0, 10.x, 172.16.x-172.31.x, 192.168.x, 169.254.x, fc00::/7, fd00::/8 ni otros rangos de NAT de nivel de operador como publicUrl.

Las llamadas salientes de Twilio en modo de notificación envían su TwiML OPENCLAW_DOCS_MARKER:calloutOpen:U2F5 inicial directamente en la solicitud de creación de llamada, por lo que el primer mensaje hablado no depende de que Twilio obtenga el TwiML del Webhook. Sigue siendo necesario un Webhook público para las devoluciones de llamada de estado, las llamadas conversacionales, el DTMF previo a la conexión, los flujos en tiempo real y el control de llamadas posterior a la conexión.

Utilice una ruta de exposición pública:

{plugins: {entries: {"voice-call": {  config: {    publicUrl: "https://voice.example.com/voice/webhook",    // o    tunnel: { provider: "ngrok" },    // o    tailscale: { mode: "funnel", path: "/voice/webhook" },  },},},},}

Después de cambiar la configuración, reinicie o recargue el Gateway y, a continuación, ejecute:

openclaw voicecall setupopenclaw voicecall smoke

voicecall smoke es una ejecución de prueba a menos que se proporcione --yes.

Fallan las credenciales del proveedor

Compruebe el proveedor seleccionado y los campos de credenciales obligatorios:

• Twilio: twilio.accountSid, twilio.authToken y fromNumber, o TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN y TWILIO_FROM_NUMBER.
• Telnyx: telnyx.apiKey, telnyx.connectionId, telnyx.publicKey y fromNumber, o TELNYX_API_KEY, TELNYX_CONNECTION_ID y TELNYX_PUBLIC_KEY.
• Plivo: plivo.authId, plivo.authToken y fromNumber, o PLIVO_AUTH_ID y PLIVO_AUTH_TOKEN.

Las credenciales deben existir en el host del Gateway. Editar un perfil de shell local no afecta a un Gateway que ya está en ejecución hasta que este reinicie o recargue su entorno.

Las llamadas se inician, pero no llegan los Webhooks del proveedor

Confirme que la consola del proveedor apunta a la URL pública exacta del Webhook:

https://voice.example.com/voice/webhook

A continuación, inspeccione el estado de ejecución:

openclaw voicecall status --call-id <id>openclaw voicecall tailopenclaw logs --follow

Causas habituales:

• publicUrl apunta a una ruta diferente de serve.path.
• La URL del túnel cambió después de iniciarse el Gateway.
• Un proxy reenvía la solicitud, pero elimina o reescribe los encabezados de host/protocolo.
• El cortafuegos o el DNS dirige el nombre de host público a un lugar distinto del Gateway.
• El Gateway se reinició sin el Plugin de llamadas de voz habilitado.

Cuando hay un proxy inverso o un túnel delante del Gateway, establezca webhookSecurity.allowedHosts en el nombre de host público o utilice webhookSecurity.trustedProxyIPs para una dirección de proxy conocida. Utilice webhookSecurity.trustForwardingHeaders únicamente cuando el límite del proxy esté bajo su control.

Falla la verificación de firmas

Las firmas del proveedor se comprueban con la URL pública que OpenClaw reconstruye a partir de la solicitud entrante. Si las firmas fallan:

• Confirme que la URL del Webhook del proveedor coincida exactamente con publicUrl, incluidos el esquema, el host y la ruta.
• Para las URL del nivel gratuito de ngrok, actualice publicUrl cuando cambie el nombre de host del túnel.
• Asegúrese de que el proxy conserve los encabezados originales de host y protocolo, o configure webhookSecurity.allowedHosts.
• No habilite skipSignatureVerification fuera de las pruebas locales.

Fallan las conexiones de Google Meet mediante Twilio

Google Meet utiliza este Plugin para conexiones por marcación de Twilio. Primero, verifique las llamadas de voz:

openclaw voicecall setupopenclaw voicecall smoke --to "+15555550123"

A continuación, verifique explícitamente el transporte de Google Meet:

openclaw googlemeet setup --transport twilio

Si las llamadas de voz están en verde, pero el participante de Meet nunca se conecta, compruebe el número de marcación de Meet, el PIN y --dtmf-sequence. La llamada telefónica puede funcionar correctamente mientras la reunión rechaza o ignora una secuencia DTMF incorrecta.

Google Meet inicia el tramo telefónico de Twilio mediante voicecall.start con una secuencia DTMF previa a la conexión. Las secuencias derivadas del PIN incluyen el voiceCall.dtmfDelayMs del Plugin de Google Meet (12000 ms de forma predeterminada) como dígitos de espera iniciales de Twilio, porque las indicaciones de marcación de Meet pueden llegar tarde. A continuación, las llamadas de voz redirigen de nuevo al procesamiento en tiempo real antes de solicitar el saludo introductorio.

Utilice openclaw logs --follow para el seguimiento de fases en directo. Una conexión correcta de Twilio a Meet registra este orden:

• Google Meet delega la conexión de Twilio en las llamadas de voz.
• Las llamadas de voz almacenan el TwiML de DTMF previo a la conexión.
• El TwiML inicial de Twilio se consume y se sirve antes del procesamiento en tiempo real.
• Las llamadas de voz sirven TwiML en tiempo real para la llamada de Twilio.
• Google Meet solicita la locución introductoria con voicecall.speak después de la demora posterior al DTMF.

openclaw voicecall tail sigue mostrando los registros de llamadas persistentes; resulta útil para el estado y las transcripciones de las llamadas, pero no todas las transiciones de Webhooks o tiempo real aparecen allí.

La llamada en tiempo real no tiene voz

Confirme que solo esté habilitado un modo de audio: realtime.enabled y streaming.enabled no pueden ser verdaderos a la vez.

Para las llamadas en tiempo real de Twilio/Telnyx, verifique también:

• Hay cargado y registrado un Plugin de proveedor en tiempo real.
• realtime.provider no está establecido o nombra un proveedor registrado.
• La clave de API del proveedor está disponible para el proceso del Gateway.
• openclaw logs --follow muestra que se sirvió el TwiML en tiempo real, se inició el puente en tiempo real y se puso en cola el saludo inicial.

Temas relacionados

• Modo de conversación
• Texto a voz
• Activación por voz