--- read_when: - Używasz Plugin voice-call i chcesz wszystkie punkty wejścia CLI - Potrzebne są tabele flag i wartości domyślne dla setup, smoke, call, continue, speak, dtmf, end, status, tail, latency, expose i start summary: Dokumentacja referencyjna CLI dla `openclaw voicecall` (interfejs poleceń Plugin do połączeń głosowych) title: Połączenie głosowe x-i18n: generated_at: "2026-05-10T19:30:43Z" model: gpt-5.5 provider: openai source_hash: 24013c06bf3e688bd86caa407bf20dddabe0dff60a400ed4f23478de62308634 source_path: cli/voicecall.md workflow: 16 --- # `openclaw voicecall` `voicecall` to polecenie dostarczane przez Plugin. Pojawia się tylko wtedy, gdy Plugin połączeń głosowych jest zainstalowany i włączony. Gdy Gateway działa, polecenia operacyjne (`call`, `start`, `continue`, `speak`, `dtmf`, `end`, `status`) są kierowane do środowiska uruchomieniowego połączeń głosowych tego Gateway. Jeśli żaden Gateway nie jest osiągalny, używają awaryjnie samodzielnego środowiska uruchomieniowego CLI. ## Podpolecenia ```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

] ``` | Podpolecenie | Opis | | ------------ | ------------------------------------------------------------------- | | `setup` | Pokazuje kontrole gotowości dostawcy i Webhook. | | `smoke` | Uruchamia kontrole gotowości; wykonuje testowe połączenie na żywo tylko z `--yes`. | | `call` | Inicjuje wychodzące połączenie głosowe. | | `start` | Alias `call` z wymaganym `--to` i opcjonalnym `--message`. | | `continue` | Odtwarza komunikat i czeka na następną odpowiedź. | | `speak` | Odtwarza komunikat bez czekania na odpowiedź. | | `dtmf` | Wysyła cyfry DTMF do aktywnego połączenia. | | `end` | Rozłącza aktywne połączenie. | | `status` | Sprawdza aktywne połączenia (lub jedno przez `--call-id`). | | `tail` | Śledzi `calls.jsonl` (przydatne podczas testów dostawcy). | | `latency` | Podsumowuje metryki opóźnienia tur z `calls.jsonl`. | | `expose` | Przełącza Tailscale serve/funnel dla punktu końcowego Webhook. | ## Konfiguracja i smoke ### `setup` Domyślnie wypisuje kontrole gotowości czytelne dla człowieka. Przekaż `--json` dla skryptów. ```bash openclaw voicecall setup openclaw voicecall setup --json ``` ### `smoke` Uruchamia te same kontrole gotowości. Nie wykona prawdziwego połączenia telefonicznego, chyba że obecne są zarówno `--to`, jak i `--yes`. | Flaga | Domyślnie | Opis | | ------------------ | --------------------------------- | ----------------------------------------- | | `-t, --to ` | (brak) | Numer telefonu do połączenia na żywo smoke. | | `--message ` | `OpenClaw voice call smoke test.` | Komunikat do odtworzenia podczas połączenia smoke. | | `--mode ` | `notify` | Tryb połączenia: `notify` lub `conversation`. | | `--yes` | `false` | Faktycznie wykonuje wychodzące połączenie na żywo. | | `--json` | `false` | Wypisuje JSON czytelny maszynowo. | ```bash openclaw voicecall smoke openclaw voicecall smoke --to "+15555550123" # dry run openclaw voicecall smoke --to "+15555550123" --yes # live notify call ``` W przypadku dostawców zewnętrznych (`twilio`, `telnyx`, `plivo`) `setup` i `smoke` wymagają publicznego adresu URL Webhook z `publicUrl`, tunelu albo ekspozycji Tailscale. Awaryjny local loopback lub prywatny serve jest odrzucany, ponieważ operatorzy nie mogą do niego dotrzeć. ## Cykl życia połączenia ### `call` Inicjuje wychodzące połączenie głosowe. | Flaga | Wymagane | Domyślnie | Opis | | ---------------------- | -------- | ----------------- | -------------------------------------------------------------------------- | | `-m, --message ` | tak | (brak) | Komunikat do odtworzenia po połączeniu. | | `-t, --to ` | nie | config `toNumber` | Numer telefonu E.164, pod który należy zadzwonić. | | `--mode ` | nie | `conversation` | Tryb połączenia: `notify` (rozłącz po komunikacie) lub `conversation` (pozostań połączony). | ```bash openclaw voicecall call --to "+15555550123" --message "Hello" openclaw voicecall call -m "Heads up" --mode notify ``` ### `start` Alias `call` z innym domyślnym kształtem flag. | Flaga | Wymagane | Domyślnie | Opis | | ------------------ | -------- | -------------- | ----------------------------------------- | | `--to ` | tak | (brak) | Numer telefonu do połączenia. | | `--message ` | nie | (brak) | Komunikat do odtworzenia po połączeniu. | | `--mode ` | nie | `conversation` | Tryb połączenia: `notify` lub `conversation`. | ### `continue` Odtwarza komunikat i czeka na odpowiedź. | Flaga | Wymagane | Opis | | ------------------ | -------- | ---------------------------- | | `--call-id ` | tak | Identyfikator połączenia. | | `--message ` | tak | Komunikat do odtworzenia. | ### `speak` Odtwarza komunikat bez czekania na odpowiedź. | Flaga | Wymagane | Opis | | ------------------ | -------- | ---------------------------- | | `--call-id ` | tak | Identyfikator połączenia. | | `--message ` | tak | Komunikat do odtworzenia. | ### `dtmf` Wysyła cyfry DTMF do aktywnego połączenia. | Flaga | Wymagane | Opis | | ------------------- | -------- | ------------------------------------------- | | `--call-id ` | tak | Identyfikator połączenia. | | `--digits ` | tak | Cyfry DTMF (np. `ww123456#` dla oczekiwania). | ### `end` Rozłącza aktywne połączenie. | Flaga | Wymagane | Opis | | ---------------- | -------- | -------------------------- | | `--call-id ` | tak | Identyfikator połączenia. | ### `status` Sprawdza aktywne połączenia. | Flaga | Domyślnie | Opis | | ---------------- | --------- | ----------------------------------------- | | `--call-id ` | (brak) | Ogranicza wynik do jednego połączenia. | | `--json` | `false` | Wypisuje JSON czytelny maszynowo. | ```bash openclaw voicecall status openclaw voicecall status --json openclaw voicecall status --call-id ``` ## Logi i metryki ### `tail` Śledzi dziennik JSONL połączeń głosowych. Przy starcie wypisuje ostatnie `--since` wierszy, a następnie strumieniuje nowe wiersze w miarę ich zapisywania. | Flaga | Domyślnie | Opis | | --------------- | -------------------------------- | ----------------------------------------- | | `--file ` | rozwiązywane z magazynu Plugin | Ścieżka do `calls.jsonl`. | | `--since ` | `25` | Wiersze do wypisania przed śledzeniem. | | `--poll ` | `250` (minimum 50) | Interwał odpytywania w milisekundach. | ### `latency` Podsumowuje metryki opóźnienia tury i oczekiwania na nasłuch z `calls.jsonl`. Wynik to JSON z podsumowaniami `recordsScanned`, `turnLatency` i `listenWait`. | Flaga | Domyślnie | Opis | | --------------- | -------------------------------- | ---------------------------------------------- | | `--file ` | rozwiązywane z magazynu Plugin | Ścieżka do `calls.jsonl`. | | `--last ` | `200` (minimum 1) | Liczba ostatnich rekordów do przeanalizowania. | ## Udostępnianie Webhook ### `expose` Włącza, wyłącza lub zmienia konfigurację Tailscale serve/funnel dla głosowego Webhook. | Flaga | Domyślnie | Opis | | --------------------- | ---------------------------------------- | --------------------------------------------- | | `--mode ` | `funnel` | `off`, `serve` (tailnet) lub `funnel` (publiczne). | | `--path ` | config `tailscale.path` lub `--serve-path` | Ścieżka Tailscale do udostępnienia. | | `--port ` | config `serve.port` lub `3334` | Lokalny port Webhook. | | `--serve-path ` | config `serve.path` lub `/voice/webhook` | Lokalna ścieżka Webhook. | ```bash openclaw voicecall expose --mode serve openclaw voicecall expose --mode funnel openclaw voicecall expose --mode off ``` Udostępniaj punkt końcowy Webhook tylko sieciom, którym ufasz. Gdy to możliwe, preferuj Tailscale Serve zamiast Funnel. ## Powiązane - [Referencja CLI](/pl/cli) - [Plugin połączeń głosowych](/pl/plugins/voice-call)