`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

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.

openclaw voicecall setup
openclaw 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.

openclaw voicecall smoke
openclaw voicecall smoke --to "+15555550123"        # Probelauf
openclaw voicecall smoke --to "+15555550123" --yes  # echter Benachrichtigungsanruf

Für externe Provider (plivo, telnyx, twilio) benötigen setup und smoke eine öffentliche Webhook-URL von publicUrl, einen Tunnel oder eine Tailscale-Freigabe. Ein Loopback- oder privater Serve-Fallback wird abgelehnt, da Mobilfunkanbieter ihn nicht erreichen können.

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).

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.

openclaw voicecall status
openclaw voicecall status --json
openclaw 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.

openclaw voicecall expose --mode serve
openclaw voicecall expose --mode funnel
openclaw voicecall expose --mode off

Geben Sie den Webhook-Endpunkt nur für Netzwerke frei, denen Sie vertrauen. Bevorzugen Sie nach Möglichkeit Tailscale Serve gegenüber Funnel.

CLI commands

RPC and API

Codex harness

Plugin reference

Plugin SDK reference

Plugin maintainer reference

Templates

Technical reference

Concept internals

Project

Contributing

Sprachanruf

`openclaw voicecall`

Unterbefehle

Einrichtung und Funktionstest

`setup`

`smoke`

Anruflebenszyklus

`call`

`start`

`continue`

`speak`

`dtmf`

`end`

`status`

Protokolle und Metriken

`tail`

`latency`

Webhooks freigeben

`expose`

Verwandte Themen

​openclaw voicecall

​Unterbefehle

​Einrichtung und Funktionstest

​setup

​smoke

​Anruflebenszyklus

​call

​start

​continue

​speak

​dtmf

​end

​status

​Protokolle und Metriken

​tail

​latency

​Webhooks freigeben

​expose

​Verwandte Themen

`openclaw voicecall`

Unterbefehle

Einrichtung und Funktionstest

`setup`

`smoke`

Anruflebenszyklus

`call`

`start`

`continue`

`speak`

`dtmf`

`end`

`status`

Protokolle und Metriken

`tail`

`latency`

Webhooks freigeben

`expose`

Verwandte Themen