--- read_when: - Usi il plugin voice-call e vuoi tutti i punti di ingresso della CLI - Servono tabelle dei flag e valori predefiniti per setup, smoke, call, continue, speak, dtmf, end, status, tail, latency, expose e start summary: Riferimento CLI per `openclaw voicecall` (interfaccia dei comandi del plugin per chiamate vocali) title: Chiamata vocale x-i18n: generated_at: "2026-05-10T19:30:06Z" model: gpt-5.5 provider: openai source_hash: 24013c06bf3e688bd86caa407bf20dddabe0dff60a400ed4f23478de62308634 source_path: cli/voicecall.md workflow: 16 --- # `openclaw voicecall` `voicecall` è un comando fornito da un Plugin. Compare solo quando il Plugin per le chiamate vocali è installato e abilitato. Quando il Gateway è in esecuzione, i comandi operativi (`call`, `start`, `continue`, `speak`, `dtmf`, `end`, `status`) vengono instradati al runtime delle chiamate vocali di quel Gateway. Se nessun Gateway è raggiungibile, ricadono su un runtime CLI autonomo. ## Sottocomandi ```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

] ``` | Sottocomando | Descrizione | | ------------ | ------------------------------------------------------------------- | | `setup` | Mostra i controlli di prontezza del provider e del Webhook. | | `smoke` | Esegue i controlli di prontezza; effettua una chiamata di test live solo con `--yes`. | | `call` | Avvia una chiamata vocale in uscita. | | `start` | Alias di `call` con `--to` obbligatorio e `--message` opzionale. | | `continue` | Pronuncia un messaggio e attende la risposta successiva. | | `speak` | Pronuncia un messaggio senza attendere una risposta. | | `dtmf` | Invia cifre DTMF a una chiamata attiva. | | `end` | Termina una chiamata attiva. | | `status` | Ispeziona le chiamate attive (o una tramite `--call-id`). | | `tail` | Segue `calls.jsonl` (utile durante i test del provider). | | `latency` | Riassume le metriche di latenza dei turni da `calls.jsonl`. | | `expose` | Attiva/disattiva Tailscale serve/funnel per l'endpoint Webhook. | ## Configurazione e smoke ### `setup` Per impostazione predefinita stampa controlli di prontezza leggibili. Passa `--json` per gli script. ```bash openclaw voicecall setup openclaw voicecall setup --json ``` ### `smoke` Esegue gli stessi controlli di prontezza. Non effettuerà una vera telefonata a meno che siano presenti sia `--to` sia `--yes`. | Flag | Predefinito | Descrizione | | ------------------ | --------------------------------- | ------------------------------------------------ | | `-t, --to ` | (nessuno) | Numero di telefono da chiamare per uno smoke live. | | `--message ` | `OpenClaw voice call smoke test.` | Messaggio da pronunciare durante la chiamata smoke. | | `--mode ` | `notify` | Modalità chiamata: `notify` o `conversation`. | | `--yes` | `false` | Effettua davvero la chiamata live in uscita. | | `--json` | `false` | Stampa JSON leggibile dalla macchina. | ```bash openclaw voicecall smoke openclaw voicecall smoke --to "+15555550123" # dry run openclaw voicecall smoke --to "+15555550123" --yes # live notify call ``` Per provider esterni (`twilio`, `telnyx`, `plivo`), `setup` e `smoke` richiedono un URL Webhook pubblico da `publicUrl`, un tunnel o un'esposizione Tailscale. Un fallback local loopback o serve privato viene rifiutato perché gli operatori telefonici non possono raggiungerlo. ## Ciclo di vita della chiamata ### `call` Avvia una chiamata vocale in uscita. | Flag | Obbligatorio | Predefinito | Descrizione | | ---------------------- | ------------ | ---------------- | ------------------------------------------------------------------------- | | `-m, --message ` | sì | (nessuno) | Messaggio da pronunciare quando la chiamata si connette. | | `-t, --to ` | no | config `toNumber` | Numero di telefono E.164 da chiamare. | | `--mode ` | no | `conversation` | Modalità chiamata: `notify` (riaggancia dopo il messaggio) o `conversation` (resta aperta). | ```bash openclaw voicecall call --to "+15555550123" --message "Hello" openclaw voicecall call -m "Heads up" --mode notify ``` ### `start` Alias di `call` con una diversa forma predefinita dei flag. | Flag | Obbligatorio | Predefinito | Descrizione | | ------------------ | ------------ | -------------- | -------------------------------------------------------- | | `--to ` | sì | (nessuno) | Numero di telefono da chiamare. | | `--message ` | no | (nessuno) | Messaggio da pronunciare quando la chiamata si connette. | | `--mode ` | no | `conversation` | Modalità chiamata: `notify` o `conversation`. | ### `continue` Pronuncia un messaggio e attende una risposta. | Flag | Obbligatorio | Descrizione | | ------------------ | ------------ | ------------------------ | | `--call-id ` | sì | ID chiamata. | | `--message ` | sì | Messaggio da pronunciare. | ### `speak` Pronuncia un messaggio senza attendere una risposta. | Flag | Obbligatorio | Descrizione | | ------------------ | ------------ | ------------------------ | | `--call-id ` | sì | ID chiamata. | | `--message ` | sì | Messaggio da pronunciare. | ### `dtmf` Invia cifre DTMF a una chiamata attiva. | Flag | Obbligatorio | Descrizione | | ------------------- | ------------ | ------------------------------------------------ | | `--call-id ` | sì | ID chiamata. | | `--digits ` | sì | Cifre DTMF (ad es. `ww123456#` per le attese). | ### `end` Termina una chiamata attiva. | Flag | Obbligatorio | Descrizione | | ---------------- | ------------ | ------------ | | `--call-id ` | sì | ID chiamata. | ### `status` Ispeziona le chiamate attive. | Flag | Predefinito | Descrizione | | ---------------- | ----------- | ----------------------------------- | | `--call-id ` | (nessuno) | Limita l'output a una sola chiamata. | | `--json` | `false` | Stampa JSON leggibile dalla macchina. | ```bash openclaw voicecall status openclaw voicecall status --json openclaw voicecall status --call-id ``` ## Log e metriche ### `tail` Segue il log JSONL delle chiamate vocali. Stampa le ultime righe indicate da `--since` all'avvio, poi trasmette le nuove righe man mano che vengono scritte. | Flag | Predefinito | Descrizione | | --------------- | ------------------------------ | ------------------------------------ | | `--file ` | risolto dallo store del Plugin | Percorso di `calls.jsonl`. | | `--since ` | `25` | Righe da stampare prima del tailing. | | `--poll ` | `250` (minimo 50) | Intervallo di polling in millisecondi. | ### `latency` Riassume le metriche di latenza dei turni e di attesa dell'ascolto da `calls.jsonl`. L'output è JSON con riepiloghi `recordsScanned`, `turnLatency` e `listenWait`. | Flag | Predefinito | Descrizione | | --------------- | ------------------------------ | ---------------------------------------- | | `--file ` | risolto dallo store del Plugin | Percorso di `calls.jsonl`. | | `--last ` | `200` (minimo 1) | Numero di record recenti da analizzare. | ## Esporre i Webhook ### `expose` Abilita, disabilita o modifica la configurazione Tailscale serve/funnel per il Webhook vocale. | Flag | Predefinito | Descrizione | | --------------------- | ---------------------------------------- | ----------------------------------------------- | | `--mode ` | `funnel` | `off`, `serve` (tailnet) o `funnel` (pubblico). | | `--path ` | config `tailscale.path` o `--serve-path` | Percorso Tailscale da esporre. | | `--port ` | config `serve.port` o `3334` | Porta Webhook locale. | | `--serve-path ` | config `serve.path` o `/voice/webhook` | Percorso Webhook locale. | ```bash openclaw voicecall expose --mode serve openclaw voicecall expose --mode funnel openclaw voicecall expose --mode off ``` Esponi l'endpoint Webhook solo a reti di cui ti fidi. Preferisci Tailscale Serve rispetto a Funnel quando possibile. ## Correlati - [Riferimento CLI](/it/cli) - [Plugin per chiamate vocali](/it/plugins/voice-call)