Przejdź do głównej treści

​
Szybki start

​
Tryb Gateway

  1. Uruchom Gateway.
openclaw gateway
  1. Otwórz TUI.
openclaw tui
  1. 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 przez Gateway są niedostępne.
  • Po tym, jak plik konfiguracji będzie zawierał ustawienia, openclaw i openclaw crestodian również używają tej powłoki TUI, z Crestodian jako lokalnym backendem czatu do konfiguracji i napraw.

​
Co zobaczysz

  • Nagłówek: URL połączenia, bieżący agent, bieżąca sesja.
  • Dziennik czatu: wiadomości użytkownika, odpowiedzi asystenta, powiadomienia systemowe, karty narzędzi.
  • Wiersz statusu: stan połączenia/uruchomienia (łączenie, działanie, streaming, bezczynność, błąd).
  • Stopka: agent + sesja + model + stan celu + think/fast/verbose/trace/reasoning + liczba tokenów + dostarczanie. Gdy tui.footer.showRemoteHost jest włączone, zdalne połączenia Gateway pokazują też host połączenia.
  • Wejście: edytor tekstu z autouzupełnianiem.

​
Model mentalny: agenci + sesje

  • Agenci to unikalne slugi (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 rozszerzy to do agent:<currentAgent>:main.
    • Jeśli wpiszesz /session agent:other:main, jawnie przełączysz się 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.
  • Aby pokazywać host Gateway dla połączeń opartych na nielokalnym URL, włącz tę opcję: 
    openclaw config set tui.footer.showRemoteHost true
    Połączenia Loopback i wbudowane połączenia lokalne nigdy nie pokazują etykiety hosta.
  • Jeśli sesja ma cel, stopka pokazuje jego zwięzły stan, taki jak Pursuing goal, Goal paused (/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 jawne.

​
Wysyłanie + dostarczanie

  • Wiadomości są wysyłane do Gateway; dostarczanie do dostawców jest domyślnie wyłączone.
  • TUI jest wewnętrzną powierzchnią źródłową, taką jak WebChat, a nie ogólnym kanałem wychodzącym. Harnessy wymagające tools.message dla widocznych odpowiedzi mogą obsłużyć aktywną turę TUI za pomocą bezdocelowego message.send; jawne dostarczanie do dostawcy nadal używa normalnie skonfigurowanych kanałów i nigdy nie przechodzi awaryjnie na lastChannel.
  • Włącz dostarczanie:
    • /deliver on
    • albo w panelu Settings
    • 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 ostatnich 7 dniach. Użyj /session <key>, aby przejść do starszej znanej sesji.
  • Ustawienia: przełącz dostarczanie, rozwijanie danych wyjściowych 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 danych wyjściowych narzędzi
  • Ctrl+T: przełącz widoczność myślenia (ponownie ładuje historię)

​
Polecenia ukośnikiem

Podstawowe:
  • /help
  • /status
  • /agent <id> (lub /agents)
  • /session <key> (lub /sessions)
  • /model <provider/model> (lub /models)
Elementy sterujące sesją:
  • /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|reset> (reset/inherit/clear/default czyści nadpisanie sesji)
  • /goal [status] | /goal start <objective> | /goal pause|resume|complete|block|clear
  • /elevated <on|off|ask|full> (alias: /elev)
  • /activation <mention|always>
  • /deliver <on|off>
Cykl życia sesji:
  • /new lub /reset (resetuje sesję)
  • /abort (przerywa aktywne uruchomienie)
  • /settings
  • /exit
Tylko tryb lokalny:
  • /auth [provider] otwiera przepływ uwierzytelniania/logowania dostawcy wewnątrz TUI.
Inne polecenia ukośnikiem Gateway (na przykład /context) są przekazywane do Gateway i pokazywane jako wyjście systemowe. Zobacz Polecenia ukośnikiem.

​
Lokalne polecenia powłoki

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

​
Naprawa 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ć dryf bez zależności od działającego Gateway. Jeśli openclaw config validate już kończy się niepowodzeniem, zacznij od openclaw configure lub najpierw openclaw doctor --fix. openclaw chat nie omija zabezpieczenia przed nieprawidłową konfiguracją. Typowa pętla:
  1. Uruchom tryb lokalny:
openclaw chat
  1. Zapytaj agenta, co chcesz sprawdzić, na przykład:
Compare my gateway auth config with the docs and suggest the smallest fix.
  1. 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
  1. Zastosuj wąskie zmiany za pomocą openclaw config set lub openclaw configure, a następnie ponownie uruchom !openclaw config validate.
  2. Jeśli Doctor zaleca automatyczną migrację lub naprawę, przejrzyj ją i uruchom !openclaw doctor --fix.
Wskazówki:
  • Preferuj openclaw config set lub openclaw configure zamiast ręcznej edycji openclaw.json.
  • openclaw docs "<query>" przeszukuje indeks dokumentacji live z tej samej maszyny.
  • openclaw config validate --json jest przydatne, gdy potrzebujesz ustrukturyzowanych błędów schematu i rozwiązywalności SecretRef.

​
Dane wyjściowe 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.
  • Podczas działania narzędzi częściowe aktualizacje streamują do tej samej karty.

​
Kolory terminala

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

​
Historia + streaming

  • Po połączeniu TUI ładuje najnowszą historię (domyślnie 200 wiadomości).
  • Odpowiedzi streamingowe aktualizują się w miejscu do czasu finalizacji.
  • TUI nasłuchuje też zdarzeń narzędzi agenta, aby tworzyć bogatsze 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ą ujawniane w dzienniku.

​
Opcje

  • --local: Uruchom względem lokalnego wbudowanego środowiska uruchomieniowego agenta
  • --url <url>: URL WebSocket Gateway (domyślnie z konfiguracji lub 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, lub 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)
Gdy ustawisz --url, TUI nie przechodzi awaryjnie na poświadczenia z konfiguracji ani środowiska. Przekaż jawnie --token lub --password. Brak jawnych poświadczeń jest błędem. W trybie lokalnym nie przekazuj --url, --token ani --password.

​
Rozwiązywanie problemów

Brak danych wyjściowych po wysłaniu wiadomości:
  • Uruchom /status w TUI, aby potwierdzić, że Gateway jest połączony i bezczynny/zajęty.
  • Sprawdź dzienniki 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 — webowy interfejs sterowania
  • Config — sprawdzaj, waliduj i edytuj openclaw.json
  • Doctor — wspomagane kontrole naprawy i migracji
  • Dokumentacja CLI — pełna dokumentacja poleceń CLI