CLI commands
Appel vocal
OmeniaClaw 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
OmeniaClaw voicecall setup [--json]OmeniaClaw voicecall smoke [-t <phone>] [--message <text>] [--mode <m>] [--yes] [--json]OmeniaClaw voicecall call -m <text> [-t <phone>] [--mode <m>]OmeniaClaw voicecall start --to <phone> [--message <text>] [--mode <m>]OmeniaClaw voicecall continue --call-id <id> --message <text>OmeniaClaw voicecall speak --call-id <id> --message <text>OmeniaClaw voicecall dtmf --call-id <id> --digits <digits>OmeniaClaw voicecall end --call-id <id>OmeniaClaw voicecall status [--call-id <id>] [--json]OmeniaClaw voicecall tail [--file <path>] [--since <n>] [--poll <ms>]OmeniaClaw voicecall latency [--file <path>] [--last <n>]OmeniaClaw 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.
OmeniaClaw voicecall setupOmeniaClaw voicecall setup --jsonsmoke
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> |
OmeniaClaw 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. |
OmeniaClaw voicecall smokeOmeniaClaw voicecall smoke --to "+15555550123" # simulationOmeniaClaw voicecall smoke --to "+15555550123" --yes # appel notify réelCycle 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). |
OmeniaClaw voicecall call --to "+15555550123" --message "Hello"OmeniaClaw voicecall call -m "Heads up" --mode notifystart
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. |
OmeniaClaw voicecall statusOmeniaClaw voicecall status --jsonOmeniaClaw 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. |
OmeniaClaw voicecall expose --mode serveOmeniaClaw voicecall expose --mode funnelOmeniaClaw voicecall expose --mode off