// dokumentacja openclaw

Control UI — panel kontrolny OpenClaw w przegladarce

Czym jest Control UI

Control UI to wbudowany panel zarządzania OpenClaw, dostępny bezpośrednio w przeglądarce internetowej. Jest to aplikacja typu SPA (Single Page Application) zbudowana na frameworkach Vite i Lit, która komunikuje się z Gateway przez lokalne API.

Control UI pozwala na zarządzanie wszystkimi aspektami OpenClaw bez konieczności edytowania plików konfiguracyjnych czy używania CLI.

Architektura

Control UI jest serwowane bezpośrednio przez Gateway OpenClaw na porcie 18789. Nie wymaga osobnego serwera webowego ani instalacji dodatkowego oprogramowania.

  • Frontend — Vite + Lit SPA, ładowane z lokalnych plików statycznych
  • Backend — REST API Gateway, nasłuchujące na tym samym porcie
  • Komunikacja — WebSocket dla aktualizacji w czasie rzeczywistym (logi, sesje, czat)

Uruchomienie panelu:

openclaw dashboard

Lub bezpośrednio w przeglądarce: http://localhost:18789

Dostęp lokalny i zdalny

Dostęp lokalny

Domyślnie Control UI jest dostępne tylko z maszyny, na której działa Gateway (localhost). Jest to najbezbezpieczniejsza konfiguracja — nie wymaga żadnego uwierzytelniania.

Dostęp zdalny przez Tailscale

OpenClaw ma wbudowaną integrację z Tailscale, która pozwala na bezpieczny zdalny dostęp bez otwierania portów:

{
  gateway: {
    tailscale: {
      enabled: true,
      hostname: "openclaw-home",
      funnel: false,  // true = dostępne publicznie
    }
  }
}

Po włączeniu Tailscale możesz uzyskać dostęp do Control UI z dowolnego urządzenia w Twojej sieci Tailscale pod adresem http://openclaw-home:18789.

Parowanie urządzeń

Aby uzyskać dostęp do Control UI z nowego urządzenia (lub przeglądarki), musisz je sparować:

  1. Wygeneruj kod parowania na serwerze: openclaw pair
  2. Otwórz Control UI w przeglądarce na nowym urządzeniu
  3. Wprowadź wyświetlony kod parowania
  4. Urządzenie zostanie zarejestrowane i zapisane — kolejne logowania będą automatyczne

Kody parowania są jednorazowe i wygasają po 15 minutach. Lista sparowanych urządzeń jest widoczna w ustawieniach Control UI.

Obsługiwane języki

Control UI obsługuje wiele języków, w tym polski! Interfejs jest przetłumaczony na następujące języki:

  • Angielski (domyślny)
  • Polski
  • Niemiecki
  • Francuski
  • Hiszpański
  • Portugalski
  • Japoński
  • Chiński (uproszczony)
  • Koreański

Język jest wykrywany automatycznie na podstawie ustawień przeglądarki. Możesz go też zmienić ręcznie w ustawieniach panelu.

Funkcje czatu

Control UI zawiera wbudowany interfejs czatu, który pozwala na bezpośrednią rozmowę z agentem:

  • Czat tekstowy — wpisuj wiadomości i otrzymuj odpowiedzi w czasie rzeczywistym (streaming)
  • Wysyłanie plików — przeciągnij i upuść pliki (obrazy, dokumenty) do okna czatu
  • Historia rozmów — przeglądaj i przeszukuj wcześniejsze sesje
  • Podgląd narzędzi — widzisz, jakie narzędzia agent wywołuje podczas rozmowy (np. wyszukiwanie, przeglądanie stron)
  • Markdown rendering — odpowiedzi agenta renderowane są z pełnym wsparciem Markdown (nagłówki, listy, kod, tabele)

Zarządzanie systemem

Control UI oferuje kompleksowe narzędzia zarządzania:

Konfiguracja

  • Edytor konfiguracji z podświetlaniem składni JSON5
  • Walidacja w czasie rzeczywistym — błędy są podkreślane przed zapisaniem
  • Podpowiedzi i dokumentacja inline dla każdego pola
  • Historia zmian z możliwością przywracania poprzednich wersji

Sesje i użytkownicy

  • Lista aktywnych sesji ze statystykami (liczba wiadomości, czas trwania)
  • Podgląd rozmów w czasie rzeczywistym
  • Możliwość zamknięcia sesji lub zresetowania kontekstu
  • Zarządzanie sparowanymi użytkownikami i urządzeniami

Logi

  • Strumień logów w czasie rzeczywistym (WebSocket)
  • Filtrowanie po poziomie (debug, info, warn, error)
  • Filtrowanie po module (gateway, agent, channel, tool)
  • Wyszukiwanie tekstowe w logach
  • Eksport logów do pliku

Crony

Sekcja cronów w Control UI pozwala na zarządzanie zaplanowanymi zadaniami:

  • Przeglądanie listy cronów z ich harmonogramami
  • Dodawanie i edycja cronów przez formularz (bez edycji JSON)
  • Ręczne uruchamianie crona (przycisk „Uruchom teraz")
  • Historia wykonań z wynikami i logami
  • Włączanie/wyłączanie poszczególnych cronów

HTTPS i bezpieczeństwo

W środowisku lokalnym Control UI działa przez HTTP, co jest akceptowalne, ponieważ ruch nie opuszcza maszyny. Dla dostępu zdalnego:

  • Tailscale — szyfruje cały ruch automatycznie (WireGuard). Nie wymaga konfiguracji certyfikatów.
  • Reverse proxy z TLS — skonfiguruj Nginx lub Caddy przed Gateway, aby obsługiwać HTTPS.
  • Certyfikat self-signed — OpenClaw może wygenerować certyfikat self-signed: openclaw gateway tls --self-signed

Uwaga: Nigdy nie wystawiaj Control UI bezpośrednio do internetu bez warstwy uwierzytelniania. Nawet jeśli parowanie jest wymagane, sam panel powinien być za VPN lub reverse proxy z dodatkowym uwierzytelnianiem.

Wróc do dokumentacji