--- read_when: - Usi il plugin per le chiamate vocali e desideri tutti i punti di ingresso della CLI - Ti 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-07-12T06:55:33Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: aec445886cccb79c9212dd9f1f448ff9634274deb380632be786478c9bb29670 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, viene usato come ripiego 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 disponibilità del provider e del Webhook. | | `smoke` | Esegue i controlli di disponibilità; effettua una chiamata di prova reale solo con `--yes`. | | `call` | Avvia una chiamata vocale in uscita. | | `start` | Alias di `call` con `--to` obbligatorio e `--message` facoltativo. | | `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` | Esamina le chiamate attive (oppure una tramite `--call-id`). | | `tail` | Segue `calls.jsonl` in tempo reale (utile durante i test del provider). | | `latency` | Riepiloga le metriche di latenza dei turni da `calls.jsonl`. | | `expose` | Attiva o disattiva Tailscale Serve/Funnel per l'endpoint Webhook. | ## Configurazione e test rapido ### `setup` Per impostazione predefinita, stampa controlli di disponibilità leggibili. Passare `--json` per gli script. ```bash openclaw voicecall setup openclaw voicecall setup --json ``` ### `smoke` Esegue gli stessi controlli di disponibilità. Effettua una chiamata telefonica reale solo quando sono presenti sia `--to` sia `--yes`. | Flag | Valore predefinito | Descrizione | | ------------------ | --------------------------------- | --------------------------------------------------- | | `-t, --to ` | (nessuno) | Numero di telefono da chiamare per una prova reale. | | `--message ` | `OpenClaw voice call smoke test.` | Messaggio da pronunciare durante la chiamata di prova. | | `--mode ` | `notify` | Modalità di chiamata: `notify` o `conversation`. | | `--yes` | `false` | Effettua realmente la chiamata in uscita. | | `--json` | `false` | Stampa JSON leggibile dalla macchina. | ```bash openclaw voicecall smoke openclaw voicecall smoke --to "+15555550123" # esecuzione simulata openclaw voicecall smoke --to "+15555550123" --yes # chiamata di notifica reale ``` Per i provider esterni (`plivo`, `telnyx`, `twilio`), `setup` e `smoke` richiedono un URL Webhook pubblico ottenuto da `publicUrl`, da un tunnel o dall'esposizione tramite Tailscale. Un ripiego tramite 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 | Valore predefinito | Descrizione | | ---------------------- | ------------ | ------------------- | --------------------------------------------------------------------------------- | | `-m, --message ` | sì | (nessuno) | Messaggio da pronunciare quando la chiamata viene connessa. | | `-t, --to ` | no | config `toNumber` | Numero di telefono E.164 da chiamare. | | `--mode ` | no | `conversation` | Modalità di chiamata: `notify` (termina dopo il messaggio) o `conversation` (rimane aperta). | ```bash openclaw voicecall call --to "+15555550123" --message "Hello" openclaw voicecall call -m "Heads up" --mode notify ``` ### `start` Alias di `call` con una diversa struttura predefinita dei flag. | Flag | Obbligatorio | Valore predefinito | Descrizione | | ------------------ | ------------ | ------------------- | ---------------------------------------------------------- | | `--to ` | sì | (nessuno) | Numero di telefono da chiamare. | | `--message ` | no | (nessuno) | Messaggio da pronunciare quando la chiamata viene connessa. | | `--mode ` | no | `conversation` | Modalità di chiamata: `notify` o `conversation`. | ### `continue` Pronuncia un messaggio e attende una risposta. | Flag | Obbligatorio | Descrizione | | ------------------ | ------------ | ----------------------- | | `--call-id ` | sì | ID della chiamata. | | `--message ` | sì | Messaggio da pronunciare. | ### `speak` Pronuncia un messaggio senza attendere una risposta. | Flag | Obbligatorio | Descrizione | | ------------------ | ------------ | ----------------------- | | `--call-id ` | sì | ID della chiamata. | | `--message ` | sì | Messaggio da pronunciare. | ### `dtmf` Invia cifre DTMF a una chiamata attiva. | Flag | Obbligatorio | Descrizione | | ------------------- | ------------ | ----------------------------------------------------------- | | `--call-id ` | sì | ID della chiamata. | | `--digits ` | sì | Cifre DTMF (ad esempio `ww123456#` per inserire delle attese). | ### `end` Termina una chiamata attiva. | Flag | Obbligatorio | Descrizione | | ---------------- | ------------ | ------------------ | | `--call-id ` | sì | ID della chiamata. | ### `status` Esamina le chiamate attive. | Flag | Valore 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 in tempo reale il log JSONL delle chiamate vocali. All'avvio stampa le ultime `--since` righe, quindi trasmette le nuove righe man mano che vengono scritte. | Flag | Valore predefinito | Descrizione | | --------------- | -------------------------------- | -------------------------------------------- | | `--file ` | risolto dall'archivio del plugin | Percorso di `calls.jsonl`. | | `--since ` | `25` | Righe da stampare prima di seguire il file. | | `--poll ` | `250` (minimo 50) | Intervallo di polling in millisecondi. | ### `latency` Riepiloga le metriche di latenza dei turni e di attesa dell'ascolto da `calls.jsonl`. L'output è in formato JSON con i riepiloghi `recordsScanned`, `turnLatency` e `listenWait`. | Flag | Valore predefinito | Descrizione | | --------------- | -------------------------------- | -------------------------------------------- | | `--file ` | risolto dall'archivio del plugin | Percorso di `calls.jsonl`. | | `--last ` | `200` (minimo 1) | Numero di record recenti da analizzare. | ## Esposizione dei Webhook ### `expose` Abilita, disabilita o modifica la configurazione Tailscale Serve/Funnel per il Webhook vocale. | Flag | Valore 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 locale del Webhook. | | `--serve-path ` | config `serve.path` o `/voice/webhook` | Percorso locale del Webhook. | ```bash openclaw voicecall expose --mode serve openclaw voicecall expose --mode funnel openclaw voicecall expose --mode off ``` Esporre l'endpoint Webhook solo alle reti considerate attendibili. Quando possibile, preferire Tailscale Serve a Funnel. ## Contenuti correlati - [Riferimento CLI](/it/cli) - [Plugin per le chiamate vocali](/it/plugins/voice-call)