TUI

​

Szybki start

​

Tryb Gateway

1. Uruchom Gateway.

openclaw gateway

2. Otwórz TUI.

openclaw tui

3. Wpisz wiadomość i naciśnij Enter.

openclaw tui --url ws://<host>:<port> --token <gateway-token>

​

Tryb lokalny

openclaw chat
# lub
openclaw tui --local

• openclaw chat i openclaw terminal są aliasami openclaw tui --local.
• --local nie można łączyć z --url, --token ani --password.
• Tryb lokalny korzysta bezpośrednio z osadzonego środowiska uruchomieniowego agenta. Większość narzędzi lokalnych działa, ale funkcje dostępne wyłącznie w Gateway są niedostępne.
• Samo openclaw (bez podpolecenia) automatycznie wybiera cel: nieskonfigurowana instalacja uruchamia wdrażanie wnioskowania; nieprawidłowa konfiguracja otwiera klasyczne wskazówki narzędzia Doctor; osiągalny, skonfigurowany Gateway otwiera tę powłokę TUI w trybie Gateway; w przeciwnym razie skonfigurowany model lokalny otwiera ją w trybie lokalnym.

​

Co jest wyświetlane

• Nagłówek: adres URL połączenia, bieżący agent, bieżąca sesja.
• Dziennik czatu: wiadomości użytkownika, odpowiedzi asystenta, powiadomienia systemowe, karty narzędzi.
• Wiersz stanu: stan połączenia/wykonania (łączenie, działanie, strumieniowanie, bezczynność, błąd).
• Stopka: agent + sesja + model + stan celu + myślenie/tryb szybki/szczegółowość/śledzenie/rozumowanie + liczba tokenów + dostarczanie. Gdy włączono tui.footer.showRemoteHost, zdalne połączenia z Gateway pokazują również hosta połączenia.
• Pole wprowadzania: edytor tekstu z autouzupełnianiem.

​

Model mentalny: agenci + sesje

• Agenci mają unikatowe identyfikatory tekstowe (np. main, research). Gateway udostępnia ich listę.
• Sesje należą do bieżącego agenta.
• Klucze sesji są przechowywane jako agent:<agentId>:<sessionKey>.
  • Po wpisaniu /session main TUI rozwija je do agent:<currentAgent>:main.
  • Po wpisaniu /session agent:other:main następuje jawne przełączenie na sesję tego agenta.
• Zakres sesji:
  • per-sender (domyślnie): każdy agent ma wiele sesji.
  • global: TUI zawsze używa sesji global (selektor może być pusty).
• Bieżący agent i sesja są zawsze widoczne w stopce.
• Aby wyświetlić hosta Gateway dla nielokalnych połączeń opartych na adresie URL, włącz tę opcję za pomocą:
  openclaw config set tui.footer.showRemoteHost true
  
  Wartość domyślna to false. Połączenia zwrotne i osadzone połączenia lokalne nigdy nie pokazują etykiety hosta.
• Jeśli sesja ma cel, stopka pokazuje jego skrócony stan: Pursuing goal, Goal paused (/goal resume), Goal blocked (/goal resume) lub Goal achieved.
• Po uruchomieniu bez --session TUI w trybie Gateway wznawia ostatnio wybraną sesję dla tego samego Gateway, agenta i zakresu sesji, jeśli ta sesja nadal istnieje. Przekazanie --session, /session, /new lub /reset pozostaje wyborem jawnym.

​

Wysyłanie + dostarczanie

• Wiadomości zawsze trafiają do Gateway (lub osadzonego środowiska uruchomieniowego w trybie lokalnym); dostarczenie odpowiedzi asystenta z powrotem do dostawcy czatu jest osobnym krokiem, domyślnie wyłączonym.
• TUI jest wewnętrznym interfejsem źródłowym, podobnie jak WebChat, a nie ogólnym kanałem wychodzącym. Środowiska wymagające tools.message do wyświetlania odpowiedzi mogą obsłużyć aktywną turę TUI za pomocą bezcelowego message.send; jawne dostarczanie przez dostawcę nadal korzysta ze zwykłych skonfigurowanych kanałów i nigdy nie przełącza się awaryjnie na lastChannel.
• Ustawienie dostarczania obowiązuje przez całą sesję TUI od chwili uruchomienia: aby je włączyć, uruchom z openclaw tui --deliver. Nie ma polecenia ukośnikowego /deliver ani przełącznika w Ustawieniach pozwalającego zmienić je w trakcie sesji; aby je zmienić, uruchom TUI ponownie.

​

Selektory + nakładki

• Selektor modelu: wyświetla dostępne modele i ustawia nadpisanie dla sesji.
• Selektor agenta: umożliwia wybór innego agenta.
• Selektor sesji: pokazuje maksymalnie 50 sesji bieżącego agenta zaktualizowanych w ciągu ostatnich 7 dni. Użyj /session <key>, aby przejść do starszej znanej sesji.
• Ustawienia (/settings): przełączanie rozwinięcia wyników narzędzi i widoczności procesu myślenia. Ten panel nie steruje dostarczaniem.

​

Skróty klawiaturowe

• Enter: wyślij wiadomość
• Esc: przerwij aktywne wykonanie
• Ctrl+C: wyczyść pole wprowadzania (naciśnij dwukrotnie, aby zakończyć)
• Ctrl+D: zakończ
• Ctrl+L: selektor modelu
• Ctrl+G: selektor agenta
• Ctrl+P: selektor sesji
• Ctrl+O: przełącz rozwinięcie wyników narzędzi
• Ctrl+T: przełącz widoczność procesu myślenia (ponownie wczytuje historię)

​

Polecenia ukośnikowe

• /help
• /status (przekazywane do Gateway; pokazuje podsumowanie sesji/modelu)
• /gateway-status (alias /gwstatus; bezpośrednio pokazuje stan połączenia z Gateway)
• /agent <id> (lub /agents)
• /session <key> (lub /sessions)
• /model <provider/model> (lub /models)

• /think <off|minimal|low|medium|high> (wyższe poziomy mogą dodawać ustawienia takie jak xhigh/max, zależnie od modelu)
• /fast <status|auto|on|off>
• /verbose <on|full|off>
• /trace <on|off>
• /reasoning <on|off|stream>
• /usage <off|tokens|full|reset> (reset/inherit/clear/default usuwa nadpisanie sesji)
• /goal [status] | /goal start <objective> | /goal edit <objective> | /goal pause|resume|complete|block|clear
• /elevated <on|off|ask|full> (alias: /elev)
• /activation <mention|always>

• /new (tworzy nową, odizolowaną sesję z nowym kluczem; nie wpływa na innych klientów TUI korzystających ze starej sesji)
• /reset (resetuje bieżący klucz sesji w miejscu)
• /abort (przerywa aktywne wykonanie)
• /settings
• /exit (lub /quit)

• /auth [provider] otwiera proces uwierzytelniania/logowania u dostawcy wewnątrz TUI.

• /openclaw [request] pozwala wrócić ze zwykłego TUI agenta do czatu konfiguracji/naprawy OpenClaw, opcjonalnie przekazując jedno żądanie.

​

Lokalne polecenia powłoki

• Poprzedź wiersz ciągiem !, aby uruchomić lokalne polecenie powłoki na hoście TUI.
• TUI raz na sesję prosi o zezwolenie na lokalne wykonywanie poleceń; odmowa pozostawia ! wyłączone w tej sesji.
• Polecenia działają w nowej, nieinteraktywnej powłoce w katalogu roboczym TUI (bez trwałego cd/środowiska).
• Lokalne polecenia powłoki otrzymują w swoim środowisku OPENCLAW_SHELL=tui-local.
• Samotne ! jest wysyłane jako zwykła wiadomość; początkowe spacje nie uruchamiają lokalnego wykonywania.

​

Pomocnik konfiguracji i naprawy OpenClaw

openclaw setup                       # uruchom interaktywnie
openclaw setup -m "status"           # wykonaj jedno żądanie i zakończ
openclaw setup -m "set default model openai/gpt-5.2" --yes   # zastosuj zapis konfiguracji

• Trwałe zapisy konfiguracji wymagają zatwierdzenia: potwierdź je interaktywnie albo przekaż --yes.
• --json wyświetla przegląd początkowy jako JSON zamiast uruchamiać czat.
• Wewnątrz OpenClaw żądanie open-tui (na przykład prośba o rozmowę ze zwykłym agentem) zamyka OpenClaw i otwiera standardowe TUI agenta; aby wrócić, użyj tam /openclaw.

1. Uruchom tryb lokalny:

openclaw chat

2. Poproś agenta o wykonanie kontroli, na przykład:

Porównaj moją konfigurację uwierzytelniania Gateway z dokumentacją i zaproponuj najmniejszą poprawkę.

3. Użyj lokalnych poleceń powłoki, aby uzyskać dokładne dane i przeprowadzić walidację:

!openclaw config file
!openclaw docs gateway auth token secretref
!openclaw config validate
!openclaw doctor

4. Zastosuj precyzyjne zmiany za pomocą openclaw config set lub openclaw configure, a następnie ponownie uruchom !openclaw config validate.
5. Jeśli Doctor zaleci automatyczną migrację lub naprawę, przejrzyj ją i uruchom !openclaw doctor --fix.

• Zamiast ręcznej edycji openclaw.json preferuj openclaw config set lub openclaw configure.
• openclaw docs "<query>" przeszukuje aktualny indeks dokumentacji z tego samego komputera.
• openclaw config validate --json jest przydatne, gdy potrzebne są ustrukturyzowany schemat oraz błędy SecretRef/rozwiązywalności.

​

Wyniki narzędzi

• Wywołania narzędzi są wyświetlane jako karty z argumentami i wynikami.
• Ctrl+O przełącza między widokiem zwiniętym i rozwiniętym.
• Podczas działania narzędzi częściowe aktualizacje są strumieniowane do tej samej karty.

​

Kolory terminala

• TUI zachowuje dla głównego tekstu asystenta domyślny kolor pierwszoplanowy terminala, dzięki czemu tekst pozostaje czytelny zarówno w ciemnych, jak i jasnych terminalach.
• Jeśli terminal ma jasne tło, a automatyczne wykrywanie działa nieprawidłowo, ustaw OPENCLAW_THEME=light przed uruchomieniem openclaw tui.
• Aby zamiast tego wymusić oryginalną ciemną paletę, ustaw OPENCLAW_THEME=dark.

​

Historia + strumieniowanie

• Po nawiązaniu połączenia TUI wczytuje najnowszą historię (domyślnie 200 wiadomości).
• Odpowiedzi strumieniowane są aktualizowane w miejscu do chwili ich ukończenia.
• TUI nasłuchuje również zdarzeń narzędzi agenta, aby wyświetlać bardziej szczegółowe karty narzędzi.

​

Szczegóły połączenia

• TUI łączy się z identyfikatorem klienta openclaw-tui w ogólnym trybie klienta ui (tym samym, którego Control UI i WebChat używają na potrzeby zasad Gateway).
• Ponowne połączenia są sygnalizowane komunikatem systemowym; luki w zdarzeniach są widoczne w dzienniku.

​

Opcje

• --local: Uruchom z lokalnym, wbudowanym środowiskiem uruchomieniowym agenta
• --url <url>: Adres URL WebSocket Gateway (domyślnie gateway.remote.url z konfiguracji lub ws://127.0.0.1:<port> dla interfejsu pętli zwrotnej)
• --token <token>: Token Gateway (jeśli wymagany)
• --password <password>: Hasło Gateway (jeśli wymagane)
• --tls-fingerprint <sha256>: Oczekiwany odcisk palca certyfikatu TLS dla Gateway wss:// z przypiętym certyfikatem
• --session <key>: Klucz sesji (domyślnie: main lub global, gdy zakres jest globalny)
• --deliver: Dostarczaj odpowiedzi asystenta do dostawcy (domyślnie wyłączone)
• --thinking <level>: Zastąp poziom rozumowania dla wysyłanych wiadomości
• --message <text>: Wyślij wiadomość początkową po nawiązaniu połączenia
• --timeout-ms <ms>: Limit czasu agenta w ms (domyślnie agents.defaults.timeoutSeconds)
• --history-limit <n>: Liczba wpisów historii do wczytania (domyślnie 200)

​

Rozwiązywanie problemów

• Uruchom /status w TUI, aby potwierdzić, że Gateway jest połączony i bezczynny lub zajęty.
• Sprawdź dzienniki Gateway: openclaw logs --follow.
• Potwierdź, że agent może działać: openclaw status i openclaw models status.
• Jeśli wiadomości mają pojawiać się na kanale czatu, potwierdź, że TUI uruchomiono z opcją --deliver (nie można jej włączyć później bez ponownego uruchomienia).

​

Rozwiązywanie problemów z połączeniem

• disconnected: upewnij się, że Gateway działa, a --url/--token/--password są prawidłowe.
• Brak agentów na liście wyboru: sprawdź openclaw agents list i konfigurację routingu.
• Pusta lista wyboru sesji: być może używany jest zakres globalny albo nie ma jeszcze żadnych sesji.

​

Powiązane

• Interfejs sterowania — internetowy interfejs sterowania
• Konfiguracja — sprawdzanie, weryfikowanie i edytowanie openclaw.json
• Doctor — wspomagane kontrole napraw i migracji
• Dokumentacja CLI — pełna dokumentacja poleceń CLI