OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

CLI commands

Appel vocal

openclaw voicecall

voicecall est une commande fournie par un Plugin. Elle apparaît uniquement lorsque le Plugin d’appel vocal est installé et activé.

Lorsque le Gateway est en cours d’exécution, les commandes opérationnelles (call, start, continue, speak, dtmf, end, status) sont acheminées vers l’environnement d’exécution des appels vocaux de ce Gateway. Si aucun Gateway n’est accessible, elles se rabattent sur un environnement d’exécution CLI autonome.

Sous-commandes

bash
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>]
Sous-commande Description
setup Affiche les vérifications de disponibilité du fournisseur et du Webhook.
smoke Exécute les vérifications de disponibilité ; passe un véritable appel de test uniquement avec --yes.
call Lance un appel vocal sortant.
start Alias de call avec --to obligatoire et --message facultatif.
continue Prononce un message et attend la réponse suivante.
speak Prononce un message sans attendre de réponse.
dtmf Envoie des chiffres DTMF à un appel actif.
end Met fin à un appel actif.
status Examine les appels actifs (ou un appel avec --call-id).
tail Suit calls.jsonl en temps réel (utile pendant les tests du fournisseur).
latency Résume les métriques de latence des tours à partir de calls.jsonl.
expose Active ou désactive la publication Serve/Funnel de Tailscale pour le point de terminaison Webhook.

Configuration et test rapide

setup

Affiche par défaut des vérifications de disponibilité lisibles par un humain. Utilisez --json pour les scripts.

bash
openclaw voicecall setupopenclaw voicecall setup --json

smoke

Exécute les mêmes vérifications de disponibilité. Passe un véritable appel téléphonique uniquement lorsque --to et --yes sont tous deux présents.

Option Valeur par défaut Description
-t, --to <phone> (aucune) Numéro de téléphone à appeler pour un test réel.
--message <text> OpenClaw voice call smoke test. Message à prononcer pendant l’appel de test.
--mode <mode> notify Mode d’appel : notify ou conversation.
--yes false Passe effectivement l’appel sortant réel.
--json false Affiche du JSON lisible par une machine.
bash
openclaw voicecall smokeopenclaw voicecall smoke --to "+15555550123"        # dry runopenclaw voicecall smoke --to "+15555550123" --yes  # live notify call

Cycle de vie d’un appel

call

Lance un appel vocal sortant.

Option Obligatoire Valeur par défaut Description
-m, --message <text> oui (aucune) Message à prononcer lorsque l’appel est connecté.
-t, --to <phone> non config toNumber Numéro de téléphone E.164 à appeler.
--mode <mode> non conversation Mode d’appel : notify (raccroche après le message) ou conversation (reste connecté).
bash
openclaw voicecall call --to "+15555550123" --message "Hello"openclaw voicecall call -m "Heads up" --mode notify

start

Alias de call avec une structure différente pour les options par défaut.

Option Obligatoire Valeur par défaut Description
--to <phone> oui (aucune) Numéro de téléphone à appeler.
--message <text> non (aucune) Message à prononcer lorsque l’appel est connecté.
--mode <mode> non conversation Mode d’appel : notify ou conversation.

continue

Prononce un message et attend une réponse.

Option Obligatoire Description
--call-id <id> oui Identifiant d’appel.
--message <text> oui Message à prononcer.

speak

Prononce un message sans attendre de réponse.

Option Obligatoire Description
--call-id <id> oui Identifiant d’appel.
--message <text> oui Message à prononcer.

dtmf

Envoie des chiffres DTMF à un appel actif.

Option Obligatoire Description
--call-id <id> oui Identifiant d’appel.
--digits <digits> oui Chiffres DTMF (par exemple ww123456# pour insérer des pauses).

end

Met fin à un appel actif.

Option Obligatoire Description
--call-id <id> oui Identifiant d’appel.

status

Examine les appels actifs.

Option Valeur par défaut Description
--call-id <id> (aucune) Limite la sortie à un seul appel.
--json false Affiche du JSON lisible par une machine.
bash
openclaw voicecall statusopenclaw voicecall status --jsonopenclaw voicecall status --call-id <id>

Journaux et métriques

tail

Suit le journal JSONL des appels vocaux en temps réel. Affiche les dernières lignes indiquées par --since au démarrage, puis diffuse les nouvelles lignes à mesure qu’elles sont écrites.

Option Valeur par défaut Description
--file <path> résolu depuis le stockage du Plugin Chemin vers calls.jsonl.
--since <n> 25 Nombre de lignes à afficher avant le suivi en direct.
--poll <ms> 250 (minimum 50) Intervalle d’interrogation en millisecondes.

latency

Résume les métriques de latence des tours et d’attente d’écoute à partir de calls.jsonl. La sortie est un objet JSON contenant les résumés recordsScanned, turnLatency et listenWait.

Option Valeur par défaut Description
--file <path> résolu depuis le stockage du Plugin Chemin vers calls.jsonl.
--last <n> 200 (minimum 1) Nombre d’enregistrements récents à analyser.

Exposition des Webhooks

expose

Active, désactive ou modifie la configuration Serve/Funnel de Tailscale pour le Webhook vocal.

Option Valeur par défaut Description
--mode <mode> funnel off, serve (tailnet) ou funnel (public).
--path <path> config tailscale.path ou --serve-path Chemin Tailscale à exposer.
--port <port> config serve.port ou 3334 Port local du Webhook.
--serve-path <path> config serve.path ou /voice/webhook Chemin local du Webhook.
bash
openclaw voicecall expose --mode serveopenclaw voicecall expose --mode funnelopenclaw voicecall expose --mode off

Voir aussi

Was this useful?
On this page

On this page