> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Chiamata vocale # `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 theme={"theme":{"light":"min-light","dark":"min-dark"}} 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 theme={"theme":{"light":"min-light","dark":"min-dark"}} 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 theme={"theme":{"light":"min-light","dark":"min-dark"}} 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 theme={"theme":{"light":"min-light","dark":"min-dark"}} 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 theme={"theme":{"light":"min-light","dark":"min-dark"}} 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 theme={"theme":{"light":"min-light","dark":"min-dark"}} 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)