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

CLI commands

Sprachanruf

openclaw voicecall

voicecall ist ein von einem Plugin bereitgestellter Befehl. Er wird nur angezeigt, wenn das Voice-Call-Plugin installiert und aktiviert ist.

Wenn der Gateway ausgeführt wird, werden Betriebsbefehle (call, start, continue, speak, dtmf, end, status) an die Voice-Call-Laufzeit dieses Gateways weitergeleitet. Wenn kein Gateway erreichbar ist, greifen sie auf eine eigenständige CLI-Laufzeit zurück.

Unterbefehle

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>]
Unterbefehl Beschreibung
setup Bereitschaftsprüfungen für Provider und Webhook anzeigen.
smoke Bereitschaftsprüfungen ausführen; nur mit --yes einen echten Testanruf tätigen.
call Einen ausgehenden Sprachanruf einleiten.
start Alias für call; --to ist erforderlich und --message optional.
continue Eine Nachricht sprechen und auf die nächste Antwort warten.
speak Eine Nachricht sprechen, ohne auf eine Antwort zu warten.
dtmf DTMF-Ziffern an einen aktiven Anruf senden.
end Einen aktiven Anruf beenden.
status Aktive Anrufe prüfen (oder einen einzelnen anhand von --call-id).
tail calls.jsonl fortlaufend anzeigen (nützlich bei Provider-Tests).
latency Latenzmetriken der Gesprächswechsel aus calls.jsonl zusammenfassen.
expose Tailscale Serve/Funnel für den Webhook-Endpunkt umschalten.

Einrichtung und Funktionstest

setup

Gibt standardmäßig menschenlesbare Bereitschaftsprüfungen aus. Übergeben Sie --json für Skripte.

bash
openclaw voicecall setupopenclaw voicecall setup --json

smoke

Führt dieselben Bereitschaftsprüfungen aus. Tätigt nur dann einen echten Telefonanruf, wenn sowohl --to als auch --yes vorhanden sind.

Flag Standard Beschreibung
-t, --to <phone> (keiner) Telefonnummer für einen echten Funktionstest.
--message <text> OpenClaw voice call smoke test. Während des Testanrufs zu sprechende Nachricht.
--mode <mode> notify Anrufmodus: notify oder conversation.
--yes false Den echten ausgehenden Anruf tatsächlich tätigen.
--json false Maschinenlesbares JSON ausgeben.
bash
openclaw voicecall smokeopenclaw voicecall smoke --to "+15555550123"        # Probelaufopenclaw voicecall smoke --to "+15555550123" --yes  # echter Benachrichtigungsanruf

Anruflebenszyklus

call

Einen ausgehenden Sprachanruf einleiten.

Flag Erforderlich Standard Beschreibung
-m, --message <text> ja (keiner) Nachricht, die gesprochen wird, wenn die Verbindung hergestellt ist.
-t, --to <phone> nein Konfiguration toNumber Anzurufende Telefonnummer im E.164-Format.
--mode <mode> nein conversation Anrufmodus: notify (nach der Nachricht auflegen) oder conversation (Verbindung offen halten).
bash
openclaw voicecall call --to "+15555550123" --message "Hello"openclaw voicecall call -m "Heads up" --mode notify

start

Alias für call mit einer anderen Standardform der Flags.

Flag Erforderlich Standard Beschreibung
--to <phone> ja (keiner) Anzurufende Telefonnummer.
--message <text> nein (keiner) Nachricht, die gesprochen wird, wenn die Verbindung hergestellt ist.
--mode <mode> nein conversation Anrufmodus: notify oder conversation.

continue

Eine Nachricht sprechen und auf eine Antwort warten.

Flag Erforderlich Beschreibung
--call-id <id> ja Anruf-ID.
--message <text> ja Zu sprechende Nachricht.

speak

Eine Nachricht sprechen, ohne auf eine Antwort zu warten.

Flag Erforderlich Beschreibung
--call-id <id> ja Anruf-ID.
--message <text> ja Zu sprechende Nachricht.

dtmf

DTMF-Ziffern an einen aktiven Anruf senden.

Flag Erforderlich Beschreibung
--call-id <id> ja Anruf-ID.
--digits <digits> ja DTMF-Ziffern (zum Beispiel ww123456# für Wartezeiten).

end

Einen aktiven Anruf beenden.

Flag Erforderlich Beschreibung
--call-id <id> ja Anruf-ID.

status

Aktive Anrufe prüfen.

Flag Standard Beschreibung
--call-id <id> (keiner) Ausgabe auf einen Anruf beschränken.
--json false Maschinenlesbares JSON ausgeben.
bash
openclaw voicecall statusopenclaw voicecall status --jsonopenclaw voicecall status --call-id <id>

Protokolle und Metriken

tail

Zeigt das Voice-Call-JSONL-Protokoll fortlaufend an. Gibt beim Start die letzten --since Zeilen aus und überträgt anschließend neue Zeilen, sobald sie geschrieben werden.

Flag Standard Beschreibung
--file <path> aus dem Plugin-Speicher aufgelöst Pfad zu calls.jsonl.
--since <n> 25 Anzahl der Zeilen, die vor der fortlaufenden Anzeige ausgegeben werden.
--poll <ms> 250 (mindestens 50) Abfrageintervall in Millisekunden.

latency

Fasst die Metriken für Gesprächswechsellatenz und Hörwartezeit aus calls.jsonl zusammen. Die Ausgabe ist JSON mit Zusammenfassungen für recordsScanned, turnLatency und listenWait.

Flag Standard Beschreibung
--file <path> aus dem Plugin-Speicher aufgelöst Pfad zu calls.jsonl.
--last <n> 200 (mindestens 1) Anzahl der zu analysierenden aktuellen Datensätze.

Webhooks freigeben

expose

Aktiviert oder deaktiviert die Tailscale-Serve/Funnel-Konfiguration für den Voice-Webhook oder ändert sie.

Flag Standard Beschreibung
--mode <mode> funnel off, serve (Tailnet) oder funnel (öffentlich).
--path <path> Konfiguration tailscale.path oder --serve-path Freizugebender Tailscale-Pfad.
--port <port> Konfiguration serve.port oder 3334 Lokaler Webhook-Port.
--serve-path <path> Konfiguration serve.path oder /voice/webhook Lokaler Webhook-Pfad.
bash
openclaw voicecall expose --mode serveopenclaw voicecall expose --mode funnelopenclaw voicecall expose --mode off

Verwandte Themen

Was this useful?
On this page

On this page