Llamada de voz
openclaw voicecall
Sección titulada «openclaw voicecall»voicecall es un comando proporcionado por un complemento. Solo aparece cuando el complemento de llamada de voz está instalado y habilitado.
Cuando el Gateway se está ejecutando, los comandos operativos (call, start, continue, speak, dtmf, end, status) se enrutan al tiempo de ejecución de llamada de voz de ese Gateway. Si no se puede alcanzar ningún Gateway, recurren a un tiempo de ejecución de CLI independiente.
Subcomandos
Sección titulada «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 | Mostrar comprobaciones de preparación del proveedor y del webhook. |
smoke | Ejecutar comprobaciones de preparación; realizar una llamada de prueba en vivo solo con --yes. |
call | Iniciar una llamada de voz saliente. |
start | Alias para call con --to obligatorio y --message opcional. |
continue | Hablar un mensaje y esperar la siguiente respuesta. |
speak | Hablar un mensaje sin esperar una respuesta. |
dtmf | Enviar dígitos DTMF a una llamada activa. |
end | Colgar una llamada activa. |
status | Inspeccionar llamadas activas (o una por --call-id). |
tail | Seguir calls.jsonl (útil durante las pruebas del proveedor). |
latency | Resumir las métricas de latencia de turno desde calls.jsonl. |
expose | Alternar Tailscale serve/funnel para el endpoint del webhook. |
Configuración y prueba
Sección titulada «Configuración y prueba»Imprime comprobaciones de preparación legibles por humanos por defecto. Pasa --json para scripts.
openclaw voicecall setupopenclaw voicecall setup --jsonEjecuta las mismas comprobaciones de preparación. No realizará una llamada telefónica real a menos que tanto --to como --yes estén presentes.
| Opción | Predeterminado | Descripción |
|---|---|---|
-t, --to <phone> | (ninguno) | Número de teléfono al que llamar para una prueba en vivo. |
--message <text> | OpenClaw voice call smoke test. | Mensaje que decir durante la llamada de prueba. |
--mode <mode> | notify | Modo de llamada: notify o conversation. |
--yes | false | Realmente realiza la llamada saliente en vivo. |
--json | false | Imprime JSON legible por máquina. |
openclaw voicecall smokeopenclaw voicecall smoke --to "+15555550123" # dry runopenclaw voicecall smoke --to "+15555550123" --yes # live notify callCiclo de vida de la llamada
Sección titulada «Ciclo de vida de la llamada»Iniciar una llamada de voz saliente.
| Opción | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|
-m, --message <text> | sí | (ninguno) | Mensaje que decir cuando se conecta la llamada. |
-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 notifyAlias para call con una forma de opción predeterminada diferente.
| Opción | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|
--to <phone> | sí | (ninguno) | Número de teléfono al que llamar. |
--message <text> | no | (ninguno) | Mensaje que decir cuando se conecta la llamada. |
--mode <mode> | no | conversation | Modo de llamada: notify o conversation. |
continue
Sección titulada «continue»Decir un mensaje y esperar una respuesta.
| Opción | Obligatorio | Descripción |
|---|---|---|
--call-id <id> | sí | ID de llamada. |
--message <text> | sí | Mensaje a decir. |
Hablar un mensaje sin esperar una respuesta.
| Opción | Obligatorio | Descripción |
|---|---|---|
--call-id <id> | sí | ID de llamada. |
--message <text> | sí | Mensaje a decir. |
Enviar dígitos DTMF a una llamada activa.
| Opción | Obligatorio | Descripción |
|---|---|---|
--call-id <id> | sí | ID de llamada. |
--digits <digits> | sí | Dígitos DTMF (ej. ww123456# para esperas). |
Colgar una llamada activa.
| Opción | Obligatorio | Descripción |
|---|---|---|
--call-id <id> | sí | ID de llamada. |
Inspeccionar llamadas activas.
| Opción | Predeterminado | Descripción |
|---|---|---|
--call-id <id> | (ninguno) | Restringir la salida a una llamada. |
--json | false | Imprimir JSON legible por máquina. |
openclaw voicecall statusopenclaw voicecall status --jsonopenclaw voicecall status --call-id <id>Registros y métricas
Sección titulada «Registros y métricas»Ver el registro JSONL de voice-call. Imprime las últimas --since líneas al inicio, luego transmite las nuevas líneas a medida que se escriben.
| Opción | Predeterminado | Descripción |
|---|---|---|
--file <path> | resuelto desde la tienda de complementos | Ruta a calls.jsonl. |
--since <n> | 25 | Líneas a imprimir antes de iniciar el seguimiento. |
--poll <ms> | 250 (mínimo 50) | Intervalo de sondeo en milisegundos. |
latency
Sección titulada «latency»Resumir las métricas de latencia de turno y espera de escucha de calls.jsonl. La salida es JSON con resúmenes de recordsScanned, turnLatency y listenWait.
| Opción | Predeterminado | Descripción |
|---|---|---|
--file <path> | resuelto desde la tienda de complementos | Ruta a calls.jsonl. |
--last <n> | 200 (mínimo 1) | Número de registros recientes a analizar. |
Exponer webhooks
Sección titulada «Exponer webhooks»Habilitar, deshabilitar o cambiar la configuración de serve/funnel de Tailscale para el webhook de voz.
| Opción | Predeterminado | Descripción |
|---|---|---|
--mode <mode> | funnel | off, serve (tailnet) o funnel (público). |
--path <path> | config tailscale.path o --serve-path | Ruta de Tailscale a 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 serveopenclaw voicecall expose --mode funnelopenclaw voicecall expose --mode off