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 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
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>]
| 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.
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 <phone> | (brak) | Numer telefonu do połączenia na żywo smoke. |
--message <text> | OpenClaw voice call smoke test. | Komunikat do odtworzenia podczas połączenia smoke. |
--mode <mode> | notify | Tryb połączenia: notify lub conversation. |
--yes | false | Faktycznie wykonuje wychodzące połączenie na żywo. |
--json | false | Wypisuje JSON czytelny maszynowo. |
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 <text> | tak | (brak) | Komunikat do odtworzenia po połączeniu. |
-t, --to <phone> | nie | config toNumber | Numer telefonu E.164, pod który należy zadzwonić. |
--mode <mode> | nie | conversation | Tryb połączenia: notify (rozłącz po komunikacie) lub conversation (pozostań połączony). |
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 <phone> | tak | (brak) | Numer telefonu do połączenia. |
--message <text> | nie | (brak) | Komunikat do odtworzenia po połączeniu. |
--mode <mode> | nie | conversation | Tryb połączenia: notify lub conversation. |
continue
Odtwarza komunikat i czeka na odpowiedź.
| Flaga | Wymagane | Opis |
|---|
--call-id <id> | tak | Identyfikator połączenia. |
--message <text> | tak | Komunikat do odtworzenia. |
speak
Odtwarza komunikat bez czekania na odpowiedź.
| Flaga | Wymagane | Opis |
|---|
--call-id <id> | tak | Identyfikator połączenia. |
--message <text> | tak | Komunikat do odtworzenia. |
dtmf
Wysyła cyfry DTMF do aktywnego połączenia.
| Flaga | Wymagane | Opis |
|---|
--call-id <id> | tak | Identyfikator połączenia. |
--digits <digits> | tak | Cyfry DTMF (np. ww123456# dla oczekiwania). |
end
Rozłącza aktywne połączenie.
| Flaga | Wymagane | Opis |
|---|
--call-id <id> | tak | Identyfikator połączenia. |
status
Sprawdza aktywne połączenia.
| Flaga | Domyślnie | Opis |
|---|
--call-id <id> | (brak) | Ogranicza wynik do jednego połączenia. |
--json | false | Wypisuje JSON czytelny maszynowo. |
openclaw voicecall status
openclaw voicecall status --json
openclaw voicecall status --call-id <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 <path> | rozwiązywane z magazynu Plugin | Ścieżka do calls.jsonl. |
--since <n> | 25 | Wiersze do wypisania przed śledzeniem. |
--poll <ms> | 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 <path> | rozwiązywane z magazynu Plugin | Ścieżka do calls.jsonl. |
--last <n> | 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 <mode> | funnel | off, serve (tailnet) lub funnel (publiczne). |
--path <path> | config tailscale.path lub --serve-path | Ścieżka Tailscale do udostępnienia. |
--port <port> | config serve.port lub 3334 | Lokalny port Webhook. |
--serve-path <path> | config serve.path lub /voice/webhook | Lokalna ścieżka Webhook. |
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
