Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
openclaw voicecall
voicecall ist ein von einem Plugin bereitgestellter Befehl. Er erscheint nur, 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-Runtime dieses Gateway weitergeleitet. Wenn kein Gateway erreichbar ist, greifen sie auf eine eigenständige CLI-Runtime 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 | Zeigt Bereitschaftsprüfungen für Provider und Webhook an. |
smoke | Führt Bereitschaftsprüfungen aus; startet einen Live-Testanruf nur mit --yes. |
call | Startet einen ausgehenden Sprachanruf. |
start | Alias für call, wobei --to erforderlich und --message optional ist. |
continue | Spricht eine Nachricht und wartet auf die nächste Antwort. |
speak | Spricht eine Nachricht, 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 per --call-id). |
tail | Verfolgt calls.jsonl fortlaufend (nützlich bei Provider-Tests). |
latency | Fasst Turn-Latenzmetriken aus calls.jsonl zusammen. |
expose | Schaltet Tailscale Serve/Funnel für den Webhook-Endpunkt um. |
Einrichtung und Smoke-Test
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. Es wird kein echter Telefonanruf gestartet, außer --to und --yes sind beide vorhanden.
| Flag | Standardwert | Beschreibung |
|---|
-t, --to <phone> | (keiner) | Telefonnummer für einen Live-Smoke-Test. |
--message <text> | OpenClaw voice call smoke test. | Nachricht, die während des Smoke-Anrufs gesprochen wird. |
--mode <mode> | notify | Anrufmodus: notify oder conversation. |
--yes | false | Startet den ausgehenden Live-Anruf wirklich. |
--json | false | Gibt maschinenlesbares JSON aus. |
openclaw voicecall smoke
openclaw voicecall smoke --to "+15555550123" # dry run
openclaw voicecall smoke --to "+15555550123" --yes # live notify call
Für externe Provider (twilio, telnyx, plivo) benötigen setup und smoke eine öffentliche Webhook-URL aus publicUrl, einem Tunnel oder einer Tailscale-Freigabe. Ein Loopback oder privater Serve-Fallback wird abgelehnt, weil Carrier ihn nicht erreichen können.
Anruflebenszyklus
call
Startet einen ausgehenden Sprachanruf.
| Flag | Erforderlich | Standardwert | Beschreibung |
|---|
-m, --message <text> | ja | (keiner) | Nachricht, die gesprochen wird, wenn der Anruf verbunden ist. |
-t, --to <phone> | nein | config toNumber | Telefonnummer im E.164-Format, die angerufen werden soll. |
--mode <mode> | nein | conversation | Anrufmodus: notify (nach der Nachricht auflegen) oder conversation (offen bleiben). |
openclaw voicecall call --to "+15555550123" --message "Hello"
openclaw voicecall call -m "Heads up" --mode notify
start
Alias für call mit einer anderen Standard-Flag-Form.
| Flag | Erforderlich | Standardwert | Beschreibung |
|---|
--to <phone> | ja | (keiner) | Telefonnummer, die angerufen werden soll. |
--message <text> | nein | (keiner) | Nachricht, die gesprochen wird, wenn der Anruf verbunden ist. |
--mode <mode> | nein | conversation | Anrufmodus: notify oder conversation. |
continue
Spricht eine Nachricht und wartet auf eine Antwort.
| Flag | Erforderlich | Beschreibung |
|---|
--call-id <id> | ja | Anruf-ID. |
--message <text> | ja | Nachricht, die gesprochen wird. |
speak
Spricht eine Nachricht, ohne auf eine Antwort zu warten.
| Flag | Erforderlich | Beschreibung |
|---|
--call-id <id> | ja | Anruf-ID. |
--message <text> | ja | Nachricht, die gesprochen wird. |
dtmf
Sendet DTMF-Ziffern an einen aktiven Anruf.
| Flag | Erforderlich | Beschreibung |
|---|
--call-id <id> | ja | Anruf-ID. |
--digits <digits> | ja | DTMF-Ziffern (z. B. ww123456# für Wartezeiten). |
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. |
openclaw voicecall status
openclaw voicecall status --json
openclaw voicecall status --call-id <id>
Protokolle und Metriken
tail
Verfolgt das JSONL-Protokoll für Sprachanrufe fortlaufend. Gibt beim Start die letzten --since Zeilen aus und streamt danach neue Zeilen, sobald sie geschrieben werden.
| Flag | Standardwert | Beschreibung |
|---|
--file <path> | aus dem Plugin-Store aufgelöst | Pfad zu calls.jsonl. |
--since <n> | 25 | Zeilen, die vor dem fortlaufenden Verfolgen ausgegeben werden. |
--poll <ms> | 250 (Minimum 50) | Abfrageintervall in Millisekunden. |
latency
Fasst Turn-Latenz- und Listen-Wait-Metriken aus calls.jsonl zusammen. Die Ausgabe ist JSON mit Zusammenfassungen für recordsScanned, turnLatency und listenWait.
| Flag | Standardwert | Beschreibung |
|---|
--file <path> | aus dem Plugin-Store aufgelöst | Pfad zu calls.jsonl. |
--last <n> | 200 (Minimum 1) | Anzahl der zuletzt zu analysierenden Datensätze. |
Webhooks veröffentlichen
expose
Aktiviert, deaktiviert oder ändert die Tailscale Serve/Funnel-Konfiguration für den Voice-Webhook.
| Flag | Standardwert | Beschreibung |
|---|
--mode <mode> | funnel | off, serve (Tailnet) oder funnel (öffentlich). |
--path <path> | config tailscale.path oder --serve-path | Freizugebender Tailscale-Pfad. |
--port <port> | config serve.port oder 3334 | Lokaler Webhook-Port. |
--serve-path <path> | config 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 Tailscale Serve gegenüber Funnel, wenn möglich.
Verwandte Themen
