--- read_when: - Usas el Plugin de llamadas de voz y quieres todos los puntos de entrada de la CLI - Se necesitan tablas de opciones y valores predeterminados para setup, smoke, call, continue, speak, dtmf, end, status, tail, latency, expose y start summary: Referencia de la CLI para `openclaw voicecall` (superficie de comandos del plugin de llamadas de voz) title: Llamada de voz x-i18n: generated_at: "2026-05-11T20:29:18Z" model: gpt-5.5 provider: openai source_hash: 24013c06bf3e688bd86caa407bf20dddabe0dff60a400ed4f23478de62308634 source_path: cli/voicecall.md workflow: 16 --- # `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 ```bash openclaw voicecall setup [--json] openclaw voicecall smoke [-t ] [--message ] [--mode ] [--yes] [--json] openclaw voicecall call -m [-t ] [--mode ] openclaw voicecall start --to [--message ] [--mode ] openclaw voicecall continue --call-id --message openclaw voicecall speak --call-id --message openclaw voicecall dtmf --call-id --digits openclaw voicecall end --call-id openclaw voicecall status [--call-id ] [--json] openclaw voicecall tail [--file ] [--since ] [--poll ] openclaw voicecall latency [--file ] [--last ] openclaw voicecall expose [--mode ] [--path

] [--port ] [--serve-path

] ``` | 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. ```bash 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 ` | (ninguno) | Número de teléfono al que llamar para un smoke en vivo. | | `--message ` | `OpenClaw voice call smoke test.` | Mensaje que se reproducirá durante la llamada smoke. | | `--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. | ```bash 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 ` | sí | (ninguno) | Mensaje que se reproducirá cuando la llamada se conecte. | | `-t, --to ` | no | config `toNumber` | Número de teléfono E.164 al que llamar. | | `--mode ` | no | `conversation` | Modo de llamada: `notify` (colgar después del mensaje) o `conversation` (mantener abierta). | ```bash 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 ` | sí | (ninguno) | Número de teléfono al que llamar. | | `--message ` | no | (ninguno) | Mensaje que se reproducirá cuando la llamada se conecte. | | `--mode ` | no | `conversation` | Modo de llamada: `notify` o `conversation`. | ### `continue` Reproduce un mensaje y espera una respuesta. | Indicador | Requerido | Descripción | | ------------------ | --------- | -------------------- | | `--call-id ` | sí | ID de llamada. | | `--message ` | sí | Mensaje que reproducir. | ### `speak` Reproduce un mensaje sin esperar respuesta. | Indicador | Requerido | Descripción | | ------------------ | --------- | -------------------- | | `--call-id ` | sí | ID de llamada. | | `--message ` | sí | Mensaje que reproducir. | ### `dtmf` Envía dígitos DTMF a una llamada activa. | Indicador | Requerido | Descripción | | ------------------- | --------- | ----------------------------------------- | | `--call-id ` | sí | ID de llamada. | | `--digits ` | sí | Dígitos DTMF (p. ej., `ww123456#` para esperas). | ### `end` Cuelga una llamada activa. | Indicador | Requerido | Descripción | | ---------------- | --------- | -------------- | | `--call-id ` | sí | ID de llamada. | ### `status` Inspecciona las llamadas activas. | Indicador | Predeterminado | Descripción | | ---------------- | -------------- | --------------------------------- | | `--call-id ` | (ninguno) | Restringe la salida a una llamada. | | `--json` | `false` | Imprime JSON legible por máquinas. | ```bash openclaw voicecall status openclaw voicecall status --json openclaw voicecall status --call-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 ` | resuelto desde el almacén del plugin | Ruta a `calls.jsonl`. | | `--since ` | `25` | Líneas que imprimir antes de seguir. | | `--poll ` | `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 ` | resuelto desde el almacén del plugin | Ruta a `calls.jsonl`. | | `--last ` | `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 ` | `funnel` | `off`, `serve` (tailnet) o `funnel` (público). | | `--path ` | config `tailscale.path` o `--serve-path` | Ruta de Tailscale que exponer. | | `--port ` | config `serve.port` o `3334` | Puerto local del Webhook. | | `--serve-path ` | config `serve.path` o `/voice/webhook` | Ruta local del Webhook. | ```bash 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 - [Referencia de CLI](/es/cli) - [Plugin de llamadas de voz](/es/plugins/voice-call)