--- read_when: - Sie verwenden das voice-call-Plugin und möchten jeden CLI-Einstiegspunkt - Sie benötigen Flag-Tabellen und Standardwerte für setup, smoke, call, continue, speak, dtmf, end, status, tail, latency, expose und start summary: CLI-Referenz für `openclaw voicecall` (Befehlsoberfläche des Sprachanruf-Plugins) title: Sprachanruf x-i18n: generated_at: "2026-05-10T19:30:04Z" model: gpt-5.5 provider: openai source_hash: 24013c06bf3e688bd86caa407bf20dddabe0dff60a400ed4f23478de62308634 source_path: cli/voicecall.md workflow: 16 --- # `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 ```bash openclaw voicecall setup [--json] openclaw voicecall smoke [-t ] [--message ] [--mode ] [--yes] [--json] openclaw voicecall call -m [-t ] [--mode ] openclaw voicecall start --to [--message ] [--mode ] openclaw voicecall continue --call-id --message openclaw voicecall speak --call-id --message openclaw voicecall dtmf --call-id --digits openclaw voicecall end --call-id openclaw voicecall status [--call-id ] [--json] openclaw voicecall tail [--file ] [--since ] [--poll ] openclaw voicecall latency [--file ] [--last ] openclaw voicecall expose [--mode ] [--path

] [--port ] [--serve-path

] ``` | 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. ```bash 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 ` | (keiner) | Telefonnummer für einen Live-Smoke-Test. | | `--message ` | `OpenClaw voice call smoke test.` | Nachricht, die während des Smoke-Anrufs gesprochen wird. | | `--mode ` | `notify` | Anrufmodus: `notify` oder `conversation`. | | `--yes` | `false` | Startet den ausgehenden Live-Anruf wirklich. | | `--json` | `false` | Gibt maschinenlesbares JSON aus. | ```bash 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 ` | ja | (keiner) | Nachricht, die gesprochen wird, wenn der Anruf verbunden ist. | | `-t, --to ` | nein | config `toNumber` | Telefonnummer im E.164-Format, die angerufen werden soll. | | `--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 Standard-Flag-Form. | Flag | Erforderlich | Standardwert | Beschreibung | | ------------------ | ------------ | -------------- | ------------------------------------------------------------- | | `--to ` | ja | (keiner) | Telefonnummer, die angerufen werden soll. | | `--message ` | nein | (keiner) | Nachricht, die gesprochen wird, wenn der Anruf verbunden ist. | | `--mode ` | nein | `conversation` | Anrufmodus: `notify` oder `conversation`. | ### `continue` Spricht eine Nachricht und wartet auf eine Antwort. | Flag | Erforderlich | Beschreibung | | ------------------ | ------------ | ----------------------------- | | `--call-id ` | ja | Anruf-ID. | | `--message ` | ja | Nachricht, die gesprochen wird. | ### `speak` Spricht eine Nachricht, ohne auf eine Antwort zu warten. | Flag | Erforderlich | Beschreibung | | ------------------ | ------------ | ----------------------------- | | `--call-id ` | ja | Anruf-ID. | | `--message ` | ja | Nachricht, die gesprochen wird. | ### `dtmf` Sendet DTMF-Ziffern an einen aktiven Anruf. | Flag | Erforderlich | Beschreibung | | ------------------- | ------------ | --------------------------------------------- | | `--call-id ` | ja | Anruf-ID. | | `--digits ` | ja | DTMF-Ziffern (z. B. `ww123456#` für Wartezeiten). | ### `end` Beendet einen aktiven Anruf. | Flag | Erforderlich | Beschreibung | | ---------------- | ------------ | ------------ | | `--call-id ` | ja | Anruf-ID. | ### `status` Prüft aktive Anrufe. | Flag | Standardwert | Beschreibung | | ---------------- | ------------ | ----------------------------------------- | | `--call-id ` | (keiner) | Beschränkt die Ausgabe auf einen Anruf. | | `--json` | `false` | Gibt maschinenlesbares JSON aus. | ```bash openclaw voicecall status openclaw voicecall status --json openclaw voicecall status --call-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 ` | aus dem Plugin-Store aufgelöst | Pfad zu `calls.jsonl`. | | `--since ` | `25` | Zeilen, die vor dem fortlaufenden Verfolgen ausgegeben werden. | | `--poll ` | `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 ` | aus dem Plugin-Store aufgelöst | Pfad zu `calls.jsonl`. | | `--last ` | `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 ` | `funnel` | `off`, `serve` (Tailnet) oder `funnel` (öffentlich). | | `--path ` | config `tailscale.path` oder `--serve-path` | Freizugebender Tailscale-Pfad. | | `--port ` | config `serve.port` oder `3334` | Lokaler Webhook-Port. | | `--serve-path ` | config `serve.path` oder `/voice/webhook` | Lokaler Webhook-Pfad. | ```bash 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 - [CLI-Referenz](/de/cli) - [Voice-Call-Plugin](/de/plugins/voice-call)