Ir al contenido

Llamada de voz

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.

Ventana de terminal
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>]
SubcomandoDescripción
setupMostrar comprobaciones de preparación del proveedor y del webhook.
smokeEjecutar comprobaciones de preparación; realizar una llamada de prueba en vivo solo con --yes.
callIniciar una llamada de voz saliente.
startAlias para call con --to obligatorio y --message opcional.
continueHablar un mensaje y esperar la siguiente respuesta.
speakHablar un mensaje sin esperar una respuesta.
dtmfEnviar dígitos DTMF a una llamada activa.
endColgar una llamada activa.
statusInspeccionar llamadas activas (o una por --call-id).
tailSeguir calls.jsonl (útil durante las pruebas del proveedor).
latencyResumir las métricas de latencia de turno desde calls.jsonl.
exposeAlternar Tailscale serve/funnel para el endpoint del webhook.

Imprime comprobaciones de preparación legibles por humanos por defecto. Pasa --json para scripts.

Ventana de terminal
openclaw voicecall setup
openclaw voicecall setup --json

Ejecuta las mismas comprobaciones de preparación. No realizará una llamada telefónica real a menos que tanto --to como --yes estén presentes.

OpciónPredeterminadoDescripció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>notifyModo de llamada: notify o conversation.
--yesfalseRealmente realiza la llamada saliente en vivo.
--jsonfalseImprime JSON legible por máquina.
Ventana de terminal
openclaw voicecall smoke
openclaw voicecall smoke --to "+15555550123" # dry run
openclaw voicecall smoke --to "+15555550123" --yes # live notify call

Iniciar una llamada de voz saliente.

OpciónObligatorioPredeterminadoDescripción
-m, --message <text>(ninguno)Mensaje que decir cuando se conecta la llamada.
-t, --to <phone>noconfig toNumberNúmero de teléfono E.164 al que llamar.
--mode <mode>noconversationModo de llamada: notify (colgar después del mensaje) o conversation (mantener abierta).
Ventana de terminal
openclaw voicecall call --to "+15555550123" --message "Hello"
openclaw voicecall call -m "Heads up" --mode notify

Alias para call con una forma de opción predeterminada diferente.

OpciónObligatorioPredeterminadoDescripción
--to <phone>(ninguno)Número de teléfono al que llamar.
--message <text>no(ninguno)Mensaje que decir cuando se conecta la llamada.
--mode <mode>noconversationModo de llamada: notify o conversation.

Decir un mensaje y esperar una respuesta.

OpciónObligatorioDescripción
--call-id <id>ID de llamada.
--message <text>Mensaje a decir.

Hablar un mensaje sin esperar una respuesta.

OpciónObligatorioDescripción
--call-id <id>ID de llamada.
--message <text>Mensaje a decir.

Enviar dígitos DTMF a una llamada activa.

OpciónObligatorioDescripción
--call-id <id>ID de llamada.
--digits <digits>Dígitos DTMF (ej. ww123456# para esperas).

Colgar una llamada activa.

OpciónObligatorioDescripción
--call-id <id>ID de llamada.

Inspeccionar llamadas activas.

OpciónPredeterminadoDescripción
--call-id <id>(ninguno)Restringir la salida a una llamada.
--jsonfalseImprimir JSON legible por máquina.
Ventana de terminal
openclaw voicecall status
openclaw voicecall status --json
openclaw voicecall status --call-id <id>

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ónPredeterminadoDescripción
--file <path>resuelto desde la tienda de complementosRuta a calls.jsonl.
--since <n>25Líneas a imprimir antes de iniciar el seguimiento.
--poll <ms>250 (mínimo 50)Intervalo de sondeo en milisegundos.

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ónPredeterminadoDescripción
--file <path>resuelto desde la tienda de complementosRuta a calls.jsonl.
--last <n>200 (mínimo 1)Número de registros recientes a analizar.

Habilitar, deshabilitar o cambiar la configuración de serve/funnel de Tailscale para el webhook de voz.

OpciónPredeterminadoDescripción
--mode <mode>funneloff, serve (tailnet) o funnel (público).
--path <path>config tailscale.path o --serve-pathRuta de Tailscale a exponer.
--port <port>config serve.port o 3334Puerto local del webhook.
--serve-path <path>config serve.path o /voice/webhookRuta local del webhook.
Ventana de terminal
openclaw voicecall expose --mode serve
openclaw voicecall expose --mode funnel
openclaw voicecall expose --mode off