Interfejs sterowania

• Czat z modelem przez Gateway WS (chat.history, chat.send, chat.abort, chat.inject).
• Odświeżenia historii czatu żądają ograniczonego ostatniego okna z limitami tekstu na wiadomość, aby duże sesje nie zmuszały przeglądarki do renderowania pełnego ładunku transkrypcji, zanim czat stanie się użyteczny.
• Rozmowa przez sesje czasu rzeczywistego w przeglądarce. OpenAI używa bezpośredniego WebRTC, Google Live używa ograniczonego jednorazowego tokena przeglądarki przez WebSocket, a wtyczki głosu czasu rzeczywistego wyłącznie backendowe używają transportu przekaźnikowego Gateway. Sesje dostawcy należące do klienta zaczynają się od talk.client.create; sesje przekaźnika Gateway zaczynają się od talk.session.create. Przekaźnik utrzymuje poświadczenia dostawcy w Gateway, podczas gdy przeglądarka strumieniuje PCM mikrofonu przez talk.session.appendAudio, przekazuje wywołania narzędzi dostawcy openclaw_agent_consult przez talk.client.toolCall dla zasad Gateway i większego skonfigurowanego modelu OpenClaw oraz kieruje sterowanie głosem aktywnego uruchomienia przez talk.client.steer lub talk.session.steer.
• Strumieniowanie wywołań narzędzi + aktywne karty wyjścia narzędzi w Czacie (zdarzenia agenta).
• Karta Aktywność z lokalnymi dla przeglądarki, nastawionymi na redakcję podsumowaniami aktywności narzędzi na żywo z istniejącego dostarczania zdarzeń session.tool / narzędzi.

• Kanały: wbudowane oraz dołączone/zewnętrzne kanały Plugin, stan, logowanie QR i konfiguracja dla kanału (channels.status, web.login.*, config.patch).
• Odświeżenia sond kanałów utrzymują widoczny poprzedni zrzut, gdy kończą się powolne kontrole dostawcy, a częściowe zrzuty są oznaczane, gdy sonda lub audyt przekroczy budżet UI.
• Instancje: lista obecności + odświeżanie (system-presence).
• Sesje: domyślnie lista sesji skonfigurowanych agentów, przypinanie częstych sesji, zmiana ich nazw, archiwizowanie lub przywracanie nieaktywnych sesji, powrót ze starych kluczy sesji nieskonfigurowanych agentów oraz stosowanie nadpisań modelu/myślenia/trybu szybkiego/szczegółowości/śledzenia/rozumowania dla sesji (sessions.list, sessions.patch). Przypięte sesje sortują się nad ostatnimi nieprzypiętymi sesjami; zarchiwizowane sesje znajdują się w widoku zarchiwizowanych na stronie Sesje i zachowują swoje transkrypcje.
• Dreams: stan Dreaming, przełącznik włącz/wyłącz oraz czytnik Dream Diary (doctor.memory.status, doctor.memory.dreamDiary, config.patch).

• Zadania Cron: lista/dodawanie/edycja/uruchamianie/włączanie/wyłączanie + historia uruchomień (cron.*).
• Skills: stan, włączanie/wyłączanie, instalowanie, aktualizacje klucza API (skills.*).
• Węzły: lista + limity (node.list), tworzenie mobilnych kodów konfiguracji oraz zatwierdzanie parowania urządzeń (device.pair.*).
• Zatwierdzenia exec: edycja list dozwolonych gateway lub węzła + zasada pytania dla exec host=gateway/node (exec.approvals.*).

• Wyświetl/edytuj ~/.openclaw/openclaw.json (config.get, config.set).
• MCP ma dedykowaną stronę ustawień dla skonfigurowanych serwerów, włączania, podsumowań OAuth/filtrów/równoległości, typowych poleceń operatorskich oraz zakresowego edytora konfiguracji mcp.
• Zastosuj + uruchom ponownie z walidacją (config.apply) i wybudź ostatnią aktywną sesję.
• Zapisy obejmują zabezpieczenie base-hash, aby zapobiec nadpisaniu równoczesnych edycji.
• Zapisy (config.set/config.apply/config.patch) w ramach kontroli wstępnej rozpoznają aktywne SecretRef dla referencji w przesłanym ładunku konfiguracji; nierozwiązane aktywne przesłane referencje są odrzucane przed zapisem.
• Zapisy formularza odrzucają nieaktualne zredagowane symbole zastępcze, których nie można przywrócić z zapisanej konfiguracji, zachowując zredagowane wartości, które nadal mapują się na zapisane sekrety.
• Renderowanie schematu + formularza (config.schema / config.schema.lookup, w tym pola title / description, dopasowane wskazówki UI, podsumowania bezpośrednich elementów podrzędnych, metadane dokumentacji na zagnieżdżonych węzłach obiektów/wieloznaczników/tablic/kompozycji, a także schematy pluginów + kanałów, gdy są dostępne); edytor Raw JSON jest dostępny tylko wtedy, gdy migawka ma bezpieczny surowy round-trip.
• Jeśli migawka nie może bezpiecznie wykonać round-trip surowego tekstu, Control UI wymusza tryb formularza i wyłącza tryb Raw dla tej migawki.
• Edytor Raw JSON „Resetuj do zapisanej” zachowuje kształt utworzony w trybie surowym (formatowanie, komentarze, układ $include) zamiast ponownie renderować spłaszczoną migawkę, więc zewnętrzne edycje przetrwają reset, gdy migawka może bezpiecznie wykonać round-trip.
• Strukturalne wartości obiektów SecretRef są renderowane jako tylko do odczytu w tekstowych polach formularza, aby zapobiec przypadkowemu uszkodzeniu przez konwersję obiektu na ciąg znaków.

• Debugowanie: migawki statusu/kondycji/modeli + dziennik zdarzeń + ręczne wywołania RPC (status, health, models.list).
• Dziennik zdarzeń zawiera czasy odświeżania/RPC Control UI, czasy powolnego renderowania czatu/konfiguracji oraz wpisy responsywności przeglądarki dla długich klatek animacji lub długich zadań, gdy przeglądarka udostępnia te typy wpisów PerformanceObserver.
• Dzienniki: śledzenie na żywo dzienników plików gateway z filtrowaniem/eksportem (logs.tail).
• Aktualizacja: uruchom aktualizację pakietu/git + ponowne uruchomienie (update.run) z raportem ponownego uruchomienia, a następnie odpytuj update.status po ponownym połączeniu, aby zweryfikować działającą wersję gateway.

• Dla izolowanych zadań domyślnym dostarczaniem jest ogłaszanie podsumowania. Możesz przełączyć na brak, jeśli chcesz uruchomień wyłącznie wewnętrznych.
• Pola kanału/celu pojawiają się po wybraniu ogłaszania.
• Tryb Webhook używa delivery.mode = "webhook" z delivery.to ustawionym na prawidłowy URL webhooka HTTP(S).
• Dla zadań głównej sesji dostępne są tryby dostarczania webhook i brak.
• Zaawansowane kontrolki edycji obejmują usunięcie po uruchomieniu, wyczyszczenie nadpisania agenta, opcje dokładnego/rozłożonego Cron, nadpisania modelu/myślenia agenta oraz przełączniki dostarczania best-effort.
• Walidacja formularza jest wbudowana z błędami na poziomie pól; nieprawidłowe wartości wyłączają przycisk zapisu do czasu poprawienia.
• Ustaw cron.webhookToken, aby wysyłać dedykowany token bearer; jeśli zostanie pominięty, webhook zostanie wysłany bez nagłówka uwierzytelniania.
• Przestarzały mechanizm awaryjny: uruchom openclaw doctor --fix, aby zmigrować zapisane starsze zadania z notify: true z cron.webhook do jawnego webhooka dla zadania lub dostarczania po ukończeniu.

• chat.send jest nieblokujące: natychmiast potwierdza z { runId, status: "started" }, a odpowiedź jest strumieniowana przez zdarzenia chat. Zaufani klienci Control UI mogą również otrzymywać opcjonalne metadane czasu ACK do lokalnej diagnostyki.
• Przesyłanie w czacie akceptuje obrazy oraz pliki inne niż wideo. Obrazy zachowują natywną ścieżkę obrazu; pozostałe pliki są przechowywane jako zarządzane media i pokazywane w historii jako linki załączników.
• Ponowne wysłanie z tym samym idempotencyKey zwraca { status: "in_flight" } podczas działania oraz { status: "ok" } po ukończeniu.
• Odpowiedzi chat.history mają ograniczony rozmiar dla bezpieczeństwa UI. Gdy wpisy transkrypcji są zbyt duże, Gateway może skracać długie pola tekstowe, pomijać ciężkie bloki metadanych i zastępować zbyt duże wiadomości symbolem zastępczym ([chat.history omitted: message too large]).
• Gdy widoczna wiadomość asystenta została skrócona w chat.history, boczny czytnik może na żądanie pobrać pełny wpis transkrypcji znormalizowany do wyświetlenia przez chat.message.get, używając sessionKey, aktywnego agentId w razie potrzeby oraz messageId transkrypcji. Jeśli Gateway nadal nie może zwrócić więcej, czytnik pokazuje jawny stan niedostępności zamiast po cichu powtarzać skrócony podgląd.
• Obrazy asystenta/wygenerowane są utrwalane jako zarządzane referencje mediów i zwracane przez uwierzytelnione adresy URL mediów Gateway, więc przeładowania nie zależą od pozostawania surowych ładunków obrazów base64 w odpowiedzi historii czatu.
• Podczas renderowania chat.history Control UI usuwa z widocznego tekstu asystenta wyłącznie wyświetleniowe tagi dyrektyw inline (na przykład [[reply_to_*]] i [[audio_as_voice]]), tekstowe ładunki XML wywołań narzędzi (w tym <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, <function_calls>...</function_calls> i skrócone bloki wywołań narzędzi) oraz ujawnione tokeny sterujące modelu ASCII/full-width, a także pomija wpisy asystenta, których cały widoczny tekst to tylko dokładny cichy token NO_REPLY / no_reply albo token potwierdzenia heartbeat HEARTBEAT_OK.
• Podczas aktywnego wysyłania i końcowego odświeżenia historii widok czatu zachowuje widoczne lokalne optymistyczne wiadomości użytkownika/asystenta, jeśli chat.history krótko zwróci starszą migawkę; kanoniczna transkrypcja zastępuje te lokalne wiadomości, gdy historia Gateway nadrobi zaległość.
• Zdarzenia chat na żywo są stanem dostarczania, podczas gdy chat.history jest odbudowywane z trwałej transkrypcji sesji. Po zdarzeniach finalizacji narzędzi Control UI przeładowuje historię i scala tylko niewielką optymistyczną końcówkę; granica transkrypcji jest udokumentowana w WebChat.
• chat.inject dołącza notatkę asystenta do transkrypcji sesji i rozgłasza zdarzenie chat dla aktualizacji wyłącznie UI (bez uruchomienia agenta, bez dostarczania kanałem).
• Pasek boczny wyświetla ostatnie sesje z akcją Nowa sesja, linkiem Wszystkie sesje oraz przyciskiem wyszukiwania sesji, który otwiera pełny selektor sesji (zakresowy według wybranego agenta, z wyszukiwaniem i paginacją). Przełączanie agentów pokazuje tylko sesje powiązane z tym agentem i przechodzi awaryjnie do głównej sesji tego agenta, gdy nie ma on jeszcze zapisanych sesji pulpitu.
• Każdy wiersz selektora sesji może zmienić nazwę, przypiąć lub zarchiwizować sesję. Aktywne uruchomienie i główna sesja agenta nie mogą zostać zarchiwizowane. Zarchiwizowanie aktualnie wybranej sesji przełącza czat z powrotem na główną sesję tego agenta.
• Na szerokościach desktopowych kontrolki czatu pozostają w jednym kompaktowym wierszu i zwijają się podczas przewijania w dół transkrypcji; przewinięcie w górę, powrót na początek lub dojście do końca przywraca kontrolki.
• Kolejne zduplikowane wiadomości zawierające tylko tekst renderują się jako jeden dymek z plakietką liczby. Wiadomości zawierające obrazy, załączniki, wyjście narzędzi lub podglądy canvas pozostają niezwinięte.
• Selektory modelu i myślenia w nagłówku czatu natychmiast aktualizują aktywną sesję przez sessions.patch; są trwałymi nadpisaniami sesji, a nie opcjami wysyłania tylko dla jednej tury.
• Jeśli wyślesz wiadomość, gdy zmiana selektora modelu dla tej samej sesji nadal się zapisuje, kompozytor czeka na tę aktualizację sesji przed wywołaniem chat.send, aby wysyłka użyła wybranego modelu.
• Wpisanie /new w Control UI tworzy i przełącza na tę samą świeżą sesję pulpitu co Nowy czat, z wyjątkiem sytuacji, gdy skonfigurowano session.dmScope: "main" i bieżący rodzic jest główną sesją agenta; wtedy resetuje główną sesję na miejscu. Wpisanie /reset zachowuje jawny reset bieżącej sesji na miejscu w Gateway.
• Selektor modelu czatu żąda skonfigurowanego widoku modeli Gateway. Jeśli obecne jest agents.defaults.models, ta lista dozwolonych wartości steruje selektorem, w tym wpisami provider/*, które utrzymują dynamiczne katalogi w zakresie dostawcy. W przeciwnym razie selektor pokazuje jawne wpisy models.providers.*.models oraz dostawców z użytecznym uwierzytelnianiem. Pełny katalog pozostaje dostępny przez debugujące RPC models.list z view: "all".
• Gdy świeże raporty użycia sesji Gateway zawierają bieżące tokeny kontekstu, pasek narzędzi kompozytora czatu pokazuje mały pierścień użycia kontekstu z procentem użycia; pełne szczegóły tokenów znajdują się w jego podpowiedzi. Pierścień przełącza się na styl ostrzegawczy przy wysokim obciążeniu kontekstu i, przy zalecanych poziomach Compaction, pokazuje kompaktowy przycisk uruchamiający normalną ścieżkę Compaction sesji. Nieaktualne migawki tokenów są ukryte, dopóki Gateway ponownie nie zgłosi świeżego użycia.

Tryb rozmowy używa zarejestrowanego dostawcy głosu realtime. Skonfiguruj OpenAI z talk.realtime.provider: "openai" oraz profilem uwierzytelniania kluczem API openai, talk.realtime.providers.openai.apiKey albo OPENAI_API_KEY; profile OAuth OpenAI nie konfigurują głosu Realtime. Skonfiguruj Google z talk.realtime.provider: "google" oraz talk.realtime.providers.google.apiKey. Przeglądarka nigdy nie otrzymuje standardowego klucza API dostawcy. OpenAI otrzymuje efemeryczny sekret klienta Realtime dla WebRTC. Google Live otrzymuje jednorazowy ograniczony token uwierzytelniania Live API dla sesji WebSocket przeglądarki, z instrukcjami i deklaracjami narzędzi zablokowanymi w tokenie przez Gateway. Dostawcy, którzy udostępniają wyłącznie backendowy most realtime, działają przez transport przekaźnika Gateway, więc poświadczenia i gniazda dostawców pozostają po stronie serwera, podczas gdy dźwięk z przeglądarki przechodzi przez uwierzytelnione RPC Gateway. Prompt sesji Realtime jest składany przez Gateway; talk.client.create nie akceptuje nadpisań instrukcji dostarczonych przez wywołującego.

Kompozytor Chatu zawiera przycisk opcji Rozmowy obok przycisku start/stop Rozmowy. Opcje dotyczą następnej sesji Rozmowy i mogą nadpisywać dostawcę, transport, model, głos, wysiłek rozumowania, próg VAD, czas ciszy oraz dopełnienie prefiksu. Gdy opcja jest pusta, Gateway używa skonfigurowanych wartości domyślnych, jeśli są dostępne, albo wartości domyślnej dostawcy. Wybranie przekaźnika Gateway wymusza ścieżkę przekaźnika backendu; wybranie WebRTC utrzymuje sesję po stronie klienta i powoduje błąd zamiast cichego przełączenia na przekaźnik, jeśli dostawca nie może utworzyć sesji przeglądarkowej.

W kompozytorze Chatu kontrolka Rozmowy to przycisk z falami obok przycisku dyktowania mikrofonem. Po rozpoczęciu Rozmowy w wierszu stanu kompozytora pojawia się Connecting Talk..., następnie Talk live, gdy audio jest połączone, albo Asking OpenClaw..., gdy wywołanie narzędzia czasu rzeczywistego konsultuje skonfigurowany większy model przez talk.client.toolCall.

Smoke test live dla maintainerów: OPENAI_API_KEY=... GEMINI_API_KEY=... node --import tsx scripts/dev/realtime-talk-live-smoke.ts weryfikuje most WebSocket backendu OpenAI, wymianę SDP WebRTC przeglądarki OpenAI, konfigurację przeglądarkowego WebSocket Google Live z ograniczonym tokenem oraz adapter przeglądarkowego przekaźnika Gateway z fałszywym nośnikiem mikrofonu. Polecenie wypisuje tylko status dostawcy i nie loguje sekretów.

• Kliknij Zatrzymaj (wywołuje chat.abort).
• Gdy uruchomienie jest aktywne, zwykłe kolejne wiadomości trafiają do kolejki. Kliknij Steruj przy wiadomości w kolejce, aby wstrzyknąć tę kolejną wiadomość do trwającej tury.
• Wpisz /stop (albo samodzielne frazy przerwania, takie jak stop, stop action, stop run, stop openclaw, please stop), aby przerwać poza pasmem.
• chat.abort obsługuje { sessionKey } (bez runId), aby przerwać wszystkie aktywne uruchomienia dla tej sesji.

• Po przerwaniu uruchomienia częściowy tekst asystenta nadal może być widoczny w UI.
• Gateway zapisuje przerwany częściowy tekst asystenta w historii transkrypcji, gdy istnieją zbuforowane dane wyjściowe.
• Zapisane wpisy zawierają metadane przerwania, dzięki czemu konsumenci transkrypcji mogą odróżnić częściowe wyniki po przerwaniu od zwykłego wyniku ukończenia.

{  gateway: {    controlUi: { allowInsecureAuth: true },    bind: "tailnet",    auth: { mode: "token", token: "replace-me" },  },}

allowInsecureAuth to wyłącznie lokalny przełącznik zgodności:

• Pozwala sesjom Control UI na localhost kontynuować bez tożsamości urządzenia w niezabezpieczonych kontekstach HTTP.
• Nie omija kontroli parowania.
• Nie rozluźnia wymagań tożsamości urządzenia dla zdalnych (nie-localhost) połączeń.

• Skuteczne uwierzytelnianie trusted-proxy może dopuścić sesje Control UI operatora bez tożsamości urządzenia.
• Nie rozszerza się to na sesje Control UI w roli węzła.
• Reverse proxy local loopback na tym samym hoście nadal nie spełniają warunków uwierzytelniania trusted-proxy; zobacz Uwierzytelnianie trusted proxy.

• gatewayUrl jest przechowywane w localStorage po załadowaniu i usuwane z adresu URL.
• Jeśli przekazujesz pełny punkt końcowy ws:// lub wss:// przez gatewayUrl, zakoduj wartość gatewayUrl w adresie URL, aby przeglądarka poprawnie sparsowała ciąg zapytania.
• token powinien być przekazywany przez fragment adresu URL (#token=...), gdy tylko jest to możliwe. Fragmenty nie są wysyłane na serwer, co pozwala uniknąć wycieku w dziennikach żądań i nagłówku Referer. Starsze parametry zapytania ?token= nadal są importowane jednorazowo ze względu na zgodność, ale tylko jako mechanizm awaryjny, i są usuwane natychmiast po bootstrapie.
• password jest przechowywane wyłącznie w pamięci.
• Gdy gatewayUrl jest ustawione, UI nie wraca do poświadczeń z konfiguracji ani środowiska. Podaj token (lub password) jawnie. Brak jawnych poświadczeń jest błędem.
• Używaj wss://, gdy Gateway znajduje się za TLS (Tailscale Serve, proxy HTTPS itd.).
• gatewayUrl jest akceptowane tylko w oknie najwyższego poziomu (nie osadzone), aby zapobiec clickjackingowi.
• Publiczne wdrożenia Control UI poza pętlą zwrotną muszą jawnie ustawić gateway.controlUi.allowedOrigins (pełne źródła). Prywatne ładowania LAN/Tailnet z tego samego źródła z local loopback, RFC1918/link-local, .local, .ts.net lub hostów Tailscale CGNAT są akceptowane bez włączania mechanizmu awaryjnego nagłówka Host.
• Uruchomienie Gateway może zainicjować lokalne źródła, takie jak http://localhost:<port> i http://127.0.0.1:<port>, na podstawie efektywnego wiązania i portu środowiska uruchomieniowego, ale zdalne źródła przeglądarki nadal wymagają jawnych wpisów.
• Nie używaj gateway.controlUi.allowedOrigins: ["*"] poza ściśle kontrolowanymi testami lokalnymi. Oznacza to zezwolenie na dowolne źródło przeglądarki, a nie „dopasuj dowolny host, którego używam”.
• gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback=true włącza tryb mechanizmu awaryjnego źródła z nagłówka Host, ale jest to niebezpieczny tryb zabezpieczeń.