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 Sprachanruf-Plugin installiert und aktiviert ist.

Wenn der Gateway ausgeführt wird, werden operative Befehle (call, start, continue, speak, dtmf, end, status) an die Sprachanruf-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 Zeigt Bereitschaftsprüfungen für Provider und Webhook an.
smoke Führt Bereitschaftsprüfungen durch; startet nur mit --yes einen echten Testanruf.
call Initiiert einen ausgehenden Sprachanruf.
start Alias für call, wobei --to erforderlich und --message optional ist.
continue Gibt eine Nachricht wieder und wartet auf die nächste Antwort.
speak Gibt eine Nachricht wieder, ohne auf eine Antwort zu warten.
dtmf Sendet DTMF-Ziffern an einen aktiven Anruf.
end Beendet einen aktiven Anruf.
status Prüft aktive Anrufe oder einen einzelnen über --call-id.
tail Verfolgt calls.jsonl fortlaufend (nützlich bei Provider-Tests).
latency Fasst Metriken zur Durchgangslatenz aus calls.jsonl zusammen.
expose Schaltet Tailscale Serve/Funnel für den Webhook-Endpunkt um.

Einrichtung und Funktionstest

setup

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

bash
openclaw voicecall setupopenclaw voicecall setup --json

smoke

Führt dieselben Bereitschaftsprüfungen durch. Ein echter Telefonanruf wird nur gestartet, wenn sowohl --to als auch --yes angegeben sind.

Flag Standardwert Beschreibung
-t, --to <phone> (keiner) Telefonnummer für einen echten Funktionstest.
--message <text> OpenClaw voice call smoke test. Beim Testanruf wiederzugebende Nachricht.
--mode <mode> notify Anrufmodus: notify oder conversation.
--yes false Startet tatsächlich den ausgehenden echten Anruf.
--json false Gibt maschinenlesbares JSON aus.
bash
openclaw voicecall smokeopenclaw voicecall smoke --to "+15555550123"        # Probelaufopenclaw voicecall smoke --to "+15555550123" --yes  # Echter Benachrichtigungsanruf

Lebenszyklus eines Anrufs

call

Initiiert einen ausgehenden Sprachanruf.

Flag Erforderlich Standardwert Beschreibung
-m, --message <text> ja (keiner) Nachricht, die wiedergegeben wird, sobald der Anruf verbunden ist.
-t, --to <phone> nein Konfig. toNumber Anzurufende Telefonnummer im E.164-Format.
--mode <mode> nein conversation Anrufmodus: notify (nach der Nachricht auflegen) oder conversation (offen bleiben).
bash
openclaw voicecall call --to "+15555550123" --message "Hello"openclaw voicecall call -m "Heads up" --mode notify

start

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

Flag Erforderlich Standardwert Beschreibung
--to <phone> ja (keiner) Anzurufende Telefonnummer.
--message <text> nein (keiner) Nachricht, die wiedergegeben wird, sobald der Anruf verbunden ist.
--mode <mode> nein conversation Anrufmodus: notify oder conversation.

continue

Gibt eine Nachricht wieder und wartet auf eine Antwort.

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

speak

Gibt eine Nachricht wieder, ohne auf eine Antwort zu warten.

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

dtmf

Sendet DTMF-Ziffern an einen aktiven Anruf.

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

end

Beendet einen aktiven Anruf.

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

status

Prüft aktive Anrufe.

Flag Standardwert Beschreibung
--call-id <id> (keiner) Beschränkt die Ausgabe auf einen Anruf.
--json false Gibt maschinenlesbares JSON aus.
bash
openclaw voicecall statusopenclaw voicecall status --jsonopenclaw voicecall status --call-id <id>

Protokolle und Metriken

tail

Verfolgt das JSONL-Protokoll der Sprachanrufe fortlaufend. Gibt beim Start die letzten mit --since angegebenen Zeilen aus und zeigt anschließend neue Zeilen an, sobald sie geschrieben werden.

Flag Standardwert Beschreibung
--file <path> aus dem Plugin-Speicher ermittelt Pfad zu calls.jsonl.
--since <n> 25 Anzahl der vor Beginn der Verfolgung auszugebenden Zeilen.
--poll <ms> 250 (mindestens 50) Abfrageintervall in Millisekunden.

latency

Fasst Metriken zur Durchgangslatenz und zur Wartezeit beim Zuhören aus calls.jsonl zusammen. Die Ausgabe ist JSON mit Zusammenfassungen für recordsScanned, turnLatency und listenWait.

Flag Standardwert Beschreibung
--file <path> aus dem Plugin-Speicher ermittelt Pfad zu calls.jsonl.
--last <n> 200 (mindestens 1) Anzahl der zu analysierenden neuesten Datensätze.

Webhooks freigeben

expose

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

Flag Standardwert Beschreibung
--mode <mode> funnel off, serve (Tailnet) oder funnel (öffentlich).
--path <path> Konfig. tailscale.path oder --serve-path Freizugebender Tailscale-Pfad.
--port <port> Konfig. serve.port oder 3334 Lokaler Webhook-Port.
--serve-path <path> Konfig. 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