Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
openclaw voicecall
voicecall es un comando proporcionado por un plugin. Solo aparece cuando el plugin de llamadas de voz está instalado y habilitado.
Cuando el Gateway está en ejecución, los comandos operativos (call, start, continue, speak, dtmf, end, status) se enrutan al runtime de llamadas de voz de ese Gateway. Si no se puede alcanzar ningún Gateway, recurren a un runtime de CLI independiente.
Subcomandos
openclaw voicecall setup [--json]
openclaw voicecall smoke [-t <phone>] [--message <text>] [--mode <m>] [--yes] [--json]
openclaw voicecall call -m <text> [-t <phone>] [--mode <m>]
openclaw voicecall start --to <phone> [--message <text>] [--mode <m>]
openclaw voicecall continue --call-id <id> --message <text>
openclaw voicecall speak --call-id <id> --message <text>
openclaw voicecall dtmf --call-id <id> --digits <digits>
openclaw voicecall end --call-id <id>
openclaw voicecall status [--call-id <id>] [--json]
openclaw voicecall tail [--file <path>] [--since <n>] [--poll <ms>]
openclaw voicecall latency [--file <path>] [--last <n>]
openclaw voicecall expose [--mode <m>] [--path <p>] [--port <port>] [--serve-path <p>]
| Subcomando | Descripción |
|---|
setup | Muestra comprobaciones de preparación del proveedor y del Webhook. |
smoke | Ejecuta comprobaciones de preparación; realiza una llamada de prueba en vivo solo con --yes. |
call | Inicia una llamada de voz saliente. |
start | Alias de call con --to requerido y --message opcional. |
continue | Reproduce un mensaje y espera la siguiente respuesta. |
speak | Reproduce un mensaje sin esperar respuesta. |
dtmf | Envía dígitos DTMF a una llamada activa. |
end | Cuelga una llamada activa. |
status | Inspecciona las llamadas activas (o una por --call-id). |
tail | Sigue calls.jsonl (útil durante pruebas de proveedor). |
latency | Resume métricas de latencia de turno desde calls.jsonl. |
expose | Alterna Tailscale serve/funnel para el endpoint del Webhook. |
Configuración y smoke
setup
Imprime comprobaciones de preparación legibles para humanos de forma predeterminada. Pasa --json para scripts.
openclaw voicecall setup
openclaw voicecall setup --json
smoke
Ejecuta las mismas comprobaciones de preparación. No realizará una llamada telefónica real a menos que estén presentes tanto --to como --yes.
| Indicador | Predeterminado | Descripción |
|---|
-t, --to <phone> | (ninguno) | Número de teléfono al que llamar para un smoke en vivo. |
--message <text> | OpenClaw voice call smoke test. | Mensaje que se reproducirá durante la llamada smoke. |
--mode <mode> | notify | Modo de llamada: notify o conversation. |
--yes | false | Realiza realmente la llamada saliente en vivo. |
--json | false | Imprime JSON legible por máquinas. |
openclaw voicecall smoke
openclaw voicecall smoke --to "+15555550123" # dry run
openclaw voicecall smoke --to "+15555550123" --yes # live notify call
Para proveedores externos (twilio, telnyx, plivo), setup y smoke requieren una URL pública de Webhook desde publicUrl, un túnel o exposición mediante Tailscale. Se rechaza un fallback de local loopback o serve privado porque los operadores no pueden alcanzarlo.
Ciclo de vida de la llamada
call
Inicia una llamada de voz saliente.
| Indicador | Requerido | Predeterminado | Descripción |
|---|
-m, --message <text> | sí | (ninguno) | Mensaje que se reproducirá cuando la llamada se conecte. |
-t, --to <phone> | no | config toNumber | Número de teléfono E.164 al que llamar. |
--mode <mode> | no | conversation | Modo de llamada: notify (colgar después del mensaje) o conversation (mantener abierta). |
openclaw voicecall call --to "+15555550123" --message "Hello"
openclaw voicecall call -m "Heads up" --mode notify
start
Alias de call con una forma de indicadores predeterminada diferente.
| Indicador | Requerido | Predeterminado | Descripción |
|---|
--to <phone> | sí | (ninguno) | Número de teléfono al que llamar. |
--message <text> | no | (ninguno) | Mensaje que se reproducirá cuando la llamada se conecte. |
--mode <mode> | no | conversation | Modo de llamada: notify o conversation. |
continue
Reproduce un mensaje y espera una respuesta.
| Indicador | Requerido | Descripción |
|---|
--call-id <id> | sí | ID de llamada. |
--message <text> | sí | Mensaje que reproducir. |
speak
Reproduce un mensaje sin esperar respuesta.
| Indicador | Requerido | Descripción |
|---|
--call-id <id> | sí | ID de llamada. |
--message <text> | sí | Mensaje que reproducir. |
dtmf
Envía dígitos DTMF a una llamada activa.
| Indicador | Requerido | Descripción |
|---|
--call-id <id> | sí | ID de llamada. |
--digits <digits> | sí | Dígitos DTMF (p. ej., ww123456# para esperas). |
end
Cuelga una llamada activa.
| Indicador | Requerido | Descripción |
|---|
--call-id <id> | sí | ID de llamada. |
status
Inspecciona las llamadas activas.
| Indicador | Predeterminado | Descripción |
|---|
--call-id <id> | (ninguno) | Restringe la salida a una llamada. |
--json | false | Imprime JSON legible por máquinas. |
openclaw voicecall status
openclaw voicecall status --json
openclaw voicecall status --call-id <id>
Registros y métricas
tail
Sigue el registro JSONL de llamadas de voz. Imprime las últimas --since líneas al iniciar y luego transmite las líneas nuevas a medida que se escriben.
| Indicador | Predeterminado | Descripción |
|---|
--file <path> | resuelto desde el almacén del plugin | Ruta a calls.jsonl. |
--since <n> | 25 | Líneas que imprimir antes de seguir. |
--poll <ms> | 250 (mínimo 50) | Intervalo de sondeo en milisegundos. |
latency
Resume las métricas de latencia de turno y espera de escucha desde calls.jsonl. La salida es JSON con resúmenes de recordsScanned, turnLatency y listenWait.
| Indicador | Predeterminado | Descripción |
|---|
--file <path> | resuelto desde el almacén del plugin | Ruta a calls.jsonl. |
--last <n> | 200 (mínimo 1) | Número de registros recientes que analizar. |
Exposición de Webhooks
expose
Habilita, deshabilita o cambia la configuración de Tailscale serve/funnel para el Webhook de voz.
| Indicador | Predeterminado | Descripción |
|---|
--mode <mode> | funnel | off, serve (tailnet) o funnel (público). |
--path <path> | config tailscale.path o --serve-path | Ruta de Tailscale que exponer. |
--port <port> | config serve.port o 3334 | Puerto local del Webhook. |
--serve-path <path> | config serve.path o /voice/webhook | Ruta local del Webhook. |
openclaw voicecall expose --mode serve
openclaw voicecall expose --mode funnel
openclaw voicecall expose --mode off
Expón el endpoint del Webhook solo a redes en las que confíes. Prefiere Tailscale Serve frente a Funnel cuando sea posible.
Relacionado
