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 routées vers le runtime d’appel vocal de ce Gateway. Si aucun Gateway n’est joignable, elles se replient sur un runtime 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 appel de test réel uniquement avec `--yes`.
`call`	Lance un appel vocal sortant.
`start`	Alias de `call` avec `--to` requis 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`	Raccroche un appel actif.
`status`	Inspecte les appels actifs (ou un seul via `--call-id`).
`tail`	Suit `calls.jsonl` (utile pendant les tests de fournisseur).
`latency`	Résume les métriques de latence par tour depuis `calls.jsonl`.
`expose`	Active/désactive Tailscale Serve/Funnel pour le point de terminaison Webhook.

Configuration et smoke

`setup`

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

bash

openclaw voicecall setupopenclaw voicecall setup --json

`smoke`

Exécute les mêmes vérifications de disponibilité. Aucun véritable appel téléphonique n’est passé sauf si --to et --yes sont tous deux présents.

Indicateur	Par défaut	Description
`-t, --to <phone>`	(aucun)	Numéro de téléphone à appeler pour un smoke réel.
`--message <text>`	`OpenClaw voice call smoke test.`	Message à prononcer pendant l’appel smoke.
`--mode <mode>`	`notify`	Mode d’appel : `notify` ou `conversation`.
`--yes`	`false`	Passe réellement l’appel sortant.
`--json`	`false`	Affiche du JSON lisible par machine.

bash

openclaw voicecall smokeopenclaw voicecall smoke --to "+15555550123"        # simulationopenclaw voicecall smoke --to "+15555550123" --yes  # appel notify réel

Cycle de vie des appels

`call`

Lance un appel vocal sortant.

Indicateur	Requis	Par défaut	Description
`-m, --message <text>`	oui	(aucun)	Message à prononcer lorsque l’appel se connecte.
`-t, --to <phone>`	non	config `toNumber`	Numéro de téléphone E.164 à appeler.
`--mode <mode>`	non	`conversation`	Mode d’appel : `notify` (raccrocher après le message) ou `conversation` (rester ouvert).

bash

openclaw voicecall call --to "+15555550123" --message "Hello"openclaw voicecall call -m "Heads up" --mode notify

`start`

Alias de call avec une forme d’indicateurs par défaut différente.

Indicateur	Requis	Par défaut	Description
`--to <phone>`	oui	(aucun)	Numéro de téléphone à appeler.
`--message <text>`	non	(aucun)	Message à prononcer lorsque l’appel se connecte.
`--mode <mode>`	non	`conversation`	Mode d’appel : `notify` ou `conversation`.

`continue`

Prononce un message et attend une réponse.

Indicateur	Requis	Description
`--call-id <id>`	oui	ID d’appel.
`--message <text>`	oui	Message à prononcer.

`speak`

Prononce un message sans attendre de réponse.

Indicateur	Requis	Description
`--call-id <id>`	oui	ID d’appel.
`--message <text>`	oui	Message à prononcer.

`dtmf`

Envoie des chiffres DTMF à un appel actif.

Indicateur	Requis	Description
`--call-id <id>`	oui	ID d’appel.
`--digits <digits>`	oui	Chiffres DTMF (par ex. `ww123456#` pour les attentes).

`end`

Raccroche un appel actif.

Indicateur	Requis	Description
`--call-id <id>`	oui	ID d’appel.

`status`

Inspecte les appels actifs.

Indicateur	Par défaut	Description
`--call-id <id>`	(aucun)	Limite la sortie à un seul appel.
`--json`	`false`	Affiche du JSON lisible par machine.

bash

openclaw voicecall statusopenclaw voicecall status --jsonopenclaw voicecall status --call-id <id>

Journaux et métriques

`tail`

Suit le journal JSONL d’appel vocal. Affiche les dernières lignes --since au démarrage, puis diffuse les nouvelles lignes à mesure qu’elles sont écrites.

Indicateur	Par défaut	Description
`--file <path>`	résolu depuis le magasin du Plugin	Chemin vers `calls.jsonl`.
`--since <n>`	`25`	Lignes à afficher avant le suivi.
`--poll <ms>`	`250` (minimum 50)	Intervalle d’interrogation en millisecondes.

`latency`

Résume les métriques de latence par tour et d’attente d’écoute depuis calls.jsonl. La sortie est du JSON avec les résumés recordsScanned, turnLatency et listenWait.

Indicateur	Par défaut	Description
`--file <path>`	résolu depuis le magasin 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 Tailscale Serve/Funnel pour le Webhook vocal.

Indicateur	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 Webhook local.
`--serve-path <path>`	config `serve.path` ou `/voice/webhook`	Chemin Webhook local.

bash

openclaw voicecall expose --mode serveopenclaw voicecall expose --mode funnelopenclaw voicecall expose --mode off

Connexe

Was this useful?