TUI

# Szybki start

# Tryb Gateway

1. Uruchom Gateway.

openclaw gateway

2. Otwórz TUI.

openclaw tui

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

Zdalny Gateway:

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

Użyj --password, jeśli Twój Gateway używa uwierzytelniania hasłem.

# Tryb lokalny

Uruchom TUI bez Gateway:

openclaw chat
# or
openclaw tui --local

Uwagi:

• openclaw chat i openclaw terminal są aliasami dla openclaw tui --local.
• --local nie można łączyć z --url, --token ani --password.
• Tryb lokalny używa bezpośrednio wbudowanego środowiska uruchomieniowego agenta. Większość narzędzi lokalnych działa, ale funkcje dostępne tylko w Gateway są niedostępne.
• openclaw i openclaw crestodian również używają tej powłoki TUI, z Crestodian jako lokalnym backendem czatu do konfiguracji i napraw.

# Co widzisz

• 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/uruchomienia (łączenie, uruchomiony, strumieniowanie, bezczynny, błąd).
• Stopka: stan połączenia + agent + sesja + model + think/fast/verbose/trace/reasoning + liczba tokenów + dostarczanie.
• Wejście: edytor tekstu z autouzupełnianiem.

# Model mentalny: agenty + sesje

• Agenty to unikalne identyfikatory typu slug (np. main, research). Gateway udostępnia listę.
• Sesje należą do bieżącego agenta.
• Klucze sesji są przechowywane jako agent:<agentId>:<sessionKey>.
  • Jeśli wpiszesz /session main, TUI rozwinie to do agent:<currentAgent>:main.
  • Jeśli wpiszesz /session agent:other:main, przełączysz się jawnie 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 + sesja są zawsze widoczne w stopce.
• 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 jawne.

# Wysyłanie + dostarczanie

• Wiadomości są wysyłane do Gateway; dostarczanie do dostawców jest domyślnie wyłączone.
• Włącz dostarczanie:
  • /deliver on
  • albo w panelu Ustawienia
  • albo uruchom z openclaw tui --deliver

# Selektory + nakładki

• Selektor modelu: wyświetla dostępne modele i ustawia nadpisanie dla sesji.
• Selektor agenta: wybierz innego agenta.
• Selektor sesji: pokazuje do 50 sesji bieżącego agenta zaktualizowanych w ciągu ostatnich 7 dni. Użyj /session <key>, aby przejść do starszej znanej sesji.
• Ustawienia: przełącz dostarczanie, rozwijanie wyjścia narzędzi i widoczność myślenia.

# Skróty klawiaturowe

• Enter: wyślij wiadomość
• Esc: przerwij aktywne uruchomienie
• Ctrl+C: wyczyść wejście (naciśnij dwa razy, aby wyjść)
• Ctrl+D: wyjdź
• Ctrl+L: selektor modelu
• Ctrl+G: selektor agenta
• Ctrl+P: selektor sesji
• Ctrl+O: przełącz rozwijanie wyjścia narzędzi
• Ctrl+T: przełącz widoczność myślenia (ponownie ładuje historię)

# Polecenia slash

Podstawowe:

• /help
• /status
• /agent <id> (lub /agents)
• /session <key> (lub /sessions)
• /model <provider/model> (lub /models)

Kontrola sesji:

• /think <off|minimal|low|medium|high>
• /fast <status|on|off>
• /verbose <on|full|off>
• /trace <on|off>
• /reasoning <on|off|stream>
• /usage <off|tokens|full>
• /elevated <on|off|ask|full> (alias: /elev)
• /activation <mention|always>
• /deliver <on|off>

Cykl życia sesji:

• /new lub /reset (zresetuj sesję)
• /abort (przerwij aktywne uruchomienie)
• /settings
• /exit

Tylko tryb lokalny:

• /auth [provider] otwiera przepływ uwierzytelniania/logowania dostawcy w TUI.

Inne polecenia slash Gateway (na przykład /context) są przekazywane do Gateway i pokazywane jako wyjście systemowe. Zobacz Polecenia slash.

# Lokalne polecenia powłoki

• Poprzedź wiersz znakiem !, aby uruchomić lokalne polecenie powłoki na hoście TUI.
• TUI raz na sesję prosi o pozwolenie na lokalne wykonywanie; odmowa pozostawia ! wyłączone dla sesji.
• Polecenia uruchamiają się w świeżej, nieinteraktywnej powłoce w katalogu roboczym TUI (brak trwałego cd/env).
• Lokalne polecenia powłoki otrzymują w środowisku OPENCLAW_SHELL=tui-local.
• Samotny ! jest wysyłany jako normalna wiadomość; początkowe spacje nie uruchamiają lokalnego wykonywania.

# Naprawianie konfiguracji z lokalnego TUI

Użyj trybu lokalnego, gdy bieżąca konfiguracja już przechodzi walidację i chcesz, aby wbudowany agent sprawdził ją na tej samej maszynie, porównał z dokumentacją i pomógł naprawić rozbieżności bez zależności od działającego Gateway.

Jeśli openclaw config validate już kończy się błędem, najpierw zacznij od openclaw configure albo openclaw doctor --fix. openclaw chat nie omija blokady nieprawidłowej konfiguracji.

Typowa pętla:

1. Uruchom tryb lokalny:

openclaw chat

2. Zapytaj agenta, co chcesz sprawdzić, na przykład:

Compare my gateway auth config with the docs and suggest the smallest fix.

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

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

4. Zastosuj wąskie zmiany za pomocą openclaw config set albo 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.

Wskazówki:

• Preferuj openclaw config set albo openclaw configure zamiast ręcznego edytowania openclaw.json.
• openclaw docs "<query>" przeszukuje indeks dokumentacji na żywo z tej samej maszyny.
• openclaw config validate --json jest przydatne, gdy chcesz uzyskać ustrukturyzowane błędy schematu oraz błędy SecretRef/rozwiązywalności.

# Wyjście narzędzi

• Wywołania narzędzi są pokazywane jako karty z argumentami + wynikami.
• Ctrl+O przełącza między widokami zwiniętym i rozwiniętym.
• Gdy narzędzia działają, częściowe aktualizacje są strumieniowane do tej samej karty.

# Kolory terminala

• TUI utrzymuje tekst treści asystenta w domyślnym kolorze pierwszego planu Twojego terminala, aby terminale ciemne i jasne pozostały czytelne.
• Jeśli Twój terminal używa jasnego tła, a automatyczne wykrywanie jest błędne, ustaw OPENCLAW_THEME=light przed uruchomieniem openclaw tui.
• Aby wymusić oryginalną ciemną paletę, ustaw zamiast tego OPENCLAW_THEME=dark.

# Historia + strumieniowanie

• Po połączeniu TUI ładuje najnowszą historię (domyślnie 200 wiadomości).
• Odpowiedzi strumieniowane są aktualizowane w miejscu aż do finalizacji.
• TUI nasłuchuje również zdarzeń narzędzi agenta, aby wzbogacać karty narzędzi.

# Szczegóły połączenia

• TUI rejestruje się w Gateway jako mode: "tui".
• Ponowne połączenia pokazują komunikat systemowy; luki w zdarzeniach są sygnalizowane w dzienniku.

# Opcje

• --local: uruchom względem lokalnego wbudowanego środowiska uruchomieniowego agenta
• --url <url>: adres URL WebSocket Gateway (domyślnie z konfiguracji albo ws://127.0.0.1:<port>)
• --token <token>: token Gateway (jeśli wymagany)
• --password <password>: hasło Gateway (jeśli wymagane)
• --session <key>: klucz sesji (domyślnie: main, albo global, gdy zakres jest globalny)
• --deliver: dostarczaj odpowiedzi asystenta do dostawcy (domyślnie wyłączone)
• --thinking <level>: nadpisz poziom myślenia dla wysyłek
• --message <text>: wyślij początkową wiadomość po połączeniu
• --timeout-ms <ms>: limit czasu agenta w ms (domyślnie agents.defaults.timeoutSeconds)
• --history-limit <n>: wpisy historii do załadowania (domyślnie 200)

# Rozwiązywanie problemów

Brak wyjścia po wysłaniu wiadomości:

• Uruchom /status w TUI, aby potwierdzić, że Gateway jest połączony i bezczynny/zajęty.
• Sprawdź logi Gateway: openclaw logs --follow.
• Potwierdź, że agent może działać: openclaw status i openclaw models status.
• Jeśli oczekujesz wiadomości w kanale czatu, włącz dostarczanie (/deliver on lub --deliver).

# Rozwiązywanie problemów z połączeniem

• disconnected: upewnij się, że Gateway działa, a Twoje --url/--token/--password są poprawne.
• Brak agentów w selektorze: sprawdź openclaw agents list i konfigurację routingu.
• Pusty selektor sesji: możesz być w zakresie globalnym albo nie mieć jeszcze żadnych sesji.

# Powiązane

• Control UI — internetowy interfejs sterowania
• Konfiguracja — sprawdzaj, waliduj i edytuj openclaw.json
• Doctor — prowadzona naprawa i kontrole migracji
• Dokumentacja CLI — pełna dokumentacja poleceń CLI