Gateway

Rejestrowanie zdarzeń Gateway

Rejestrowanie

Omówienie przeznaczone dla użytkowników (CLI + interfejs Control UI + konfiguracja) znajduje się na stronie /logging.

OpenClaw udostępnia dwa rodzaje dzienników:

Dane wyjściowe konsoli — informacje widoczne w terminalu lub interfejsie Debug UI.
Dzienniki plikowe — wiersze JSON zapisywane przez rejestrator Gateway.

Podczas uruchamiania Gateway rejestruje określony domyślny model agenta oraz domyślne tryby wpływające na nowe sesje:

text

agent model: openai/gpt-5.6-sol (thinking=medium, fast=on)

Wartość thinking pochodzi z konfiguracji domyślnego agenta, parametrów modelu lub globalnej wartości domyślnej agenta; jeśli jej nie ustawiono, wyświetlana jest wartość medium. Wartość fast pochodzi z konfiguracji domyślnego agenta lub parametrów fastMode modelu.

Rejestrator plikowy

Domyślny rotacyjny plik dziennika znajduje się w katalogu /tmp/openclaw/ (jeden plik dziennie): openclaw-YYYY-MM-DD.log, datowany zgodnie z lokalną strefą czasową hosta Gateway. Jeśli katalog jest niezabezpieczony lub nie można w nim zapisywać (niewłaściwy właściciel, możliwość zapisu przez wszystkich albo dowiązanie symboliczne), OpenClaw używa zamiast niego ścieżki os.tmpdir()/openclaw-<uid> o zakresie ograniczonym do użytkownika; w systemie Windows zawsze używana jest ta ścieżka zastępcza w katalogu tymczasowym systemu operacyjnego.
Aktywne pliki dziennika są rotowane po osiągnięciu rozmiaru logging.maxFileBytes (domyślnie 100 MB). Zachowywanych jest maksymalnie pięć numerowanych archiwów (od .1 do .5), a dalszy zapis odbywa się w nowym aktywnym pliku.
Ścieżkę i poziom rejestrowania pliku skonfiguruj w ~/.openclaw/openclaw.json za pomocą ustawień logging.file i logging.level.
Format pliku to jeden obiekt JSON w każdym wierszu.

Ścieżki kodu rozmów, głosu w czasie rzeczywistym i zarządzanych pokojów używają współdzielonego rejestratora plikowego do zapisywania ograniczonych rekordów cyklu życia przeznaczonych do diagnostyki operacyjnej i eksportowania dzienników OTLP. Tekst transkrypcji, dane audio, identyfikatory tur, identyfikatory połączeń i identyfikatory elementów dostawcy nigdy nie są kopiowane do rekordu dziennika.

Karta dzienników w interfejsie Control UI śledzi ten plik za pośrednictwem Gateway (logs.tail). CLI działa tak samo:

bash

openclaw logs --follow

Tryb szczegółowy a poziomy rejestrowania

Dzienniki plikowe są kontrolowane wyłącznie przez logging.level.
Opcja --verbose wpływa tylko na szczegółowość konsoli (oraz styl dzienników WS) — nie podnosi poziomu rejestrowania w pliku.
Aby zapisywać w dziennikach plikowych szczegóły dostępne tylko w trybie szczegółowym, ustaw logging.level na debug lub trace.
Rejestrowanie na poziomie trace obejmuje również diagnostyczne podsumowania czasów dla wybranych często wykonywanych ścieżek, takich jak przygotowanie fabryki narzędzi Pluginu. Zobacz /tools/plugin#slow-plugin-tool-setup.

Przechwytywanie konsoli

CLI przechwytuje wywołania console.log/info/warn/error/debug/trace, zapisuje je w dziennikach plikowych, a jednocześnie nadal wyświetla je w strumieniu stdout/stderr.

Szczegółowość konsoli można dostosować niezależnie:

logging.consoleLevel (domyślnie info)
logging.consoleStyle (pretty | compact | json; domyślnie pretty w TTY, a w pozostałych przypadkach compact)

Redagowanie

OpenClaw maskuje poufne tokeny, zanim dane wyjściowe dziennika lub transkrypcji opuszczą proces. Ta zasada redagowania dotyczy konsoli, dzienników plikowych, rekordów dziennika OTLP oraz tekstowych miejsc docelowych transkrypcji sesji, dlatego pasujące wartości tajne są maskowane przed zapisaniem wierszy JSONL lub komunikatów na dysku.

logging.redactSensitive: off | tools (domyślnie tools)
logging.redactPatterns: tablica ciągów wyrażeń regularnych (zastępuje wartości domyślne)
- Użyj nieprzetworzonych ciągów wyrażeń regularnych (automatycznie z flagami gi) albo składni /pattern/flags, aby określić niestandardowe flagi.
- Dopasowania są maskowane z zachowaniem pierwszych 6 i ostatnich 4 znaków (dla wartości mających co najmniej 18 znaków); krótsze wartości są zastępowane przez ***.
- Domyślne wzorce obejmują typowe przypisania kluczy, flagi CLI, pola JSON, nagłówki typu bearer, bloki PEM, popularne prefiksy tokenów dostawców oraz nazwy pól danych uwierzytelniających płatności (numer karty, CVC/CVV, współdzielony token płatności i dane uwierzytelniające płatności).

Niektóre granice bezpieczeństwa zawsze stosują redagowanie niezależnie od ustawienia logging.redactSensitive: zdarzenia wywołań narzędzi w Control UI, dane wyjściowe narzędzia sessions_history, eksporty pomocy diagnostycznej, obserwacje błędów dostawcy, wyświetlanie poleceń zatwierdzania wykonania oraz dzienniki protokołu WebSocket Gateway. Te powierzchnie nadal uwzględniają logging.redactPatterns jako dodatkowe wzorce, ale ustawienie redactSensitive: "off" nie powoduje ujawniania przez nie nieprzetworzonych wartości tajnych.

Dzienniki WebSocket Gateway

Gateway wyświetla dzienniki protokołu WebSocket w dwóch trybach:

Tryb normalny (bez --verbose): wyświetlane są tylko „istotne” wyniki RPC — błędy (ok=false), wolne wywołania (domyślny próg: >= 50ms) i błędy analizy składniowej.
Tryb szczegółowy (--verbose): wyświetla cały ruch żądań i odpowiedzi WS.

Styl dzienników WS

Polecenie openclaw gateway obsługuje przełącznik stylu dla poszczególnych instancji Gateway:

--ws-log auto (domyślnie): tryb normalny jest zoptymalizowany, a tryb szczegółowy używa zwartego formatu danych wyjściowych.
--ws-log compact: zwarty format danych wyjściowych (sparowane żądania i odpowiedzi) w trybie szczegółowym.
--ws-log full: pełne dane wyjściowe poszczególnych ramek w trybie szczegółowym.
--compact: alias opcji --ws-log compact.

bash

# zoptymalizowane (tylko błędy/wolne wywołania)openclaw gateway # pokaż cały ruch WS (sparowany)openclaw gateway --verbose --ws-log compact # pokaż cały ruch WS (pełne metadane)openclaw gateway --verbose --ws-log full

Formatowanie konsoli (rejestrowanie podsystemów)

Program formatujący konsolę rozpoznaje TTY i wyświetla spójne wiersze z prefiksami. Rejestratory podsystemów grupują dane wyjściowe i ułatwiają ich przeglądanie:

Prefiksy podsystemów w każdym wierszu (np. [gateway], [canvas], [tailscale]).
Kolory podsystemów (stałe dla każdego podsystemu, wyznaczane skrótem nazwy) wraz z kolorami poziomów.
Kolory, gdy dane wyjściowe trafiają do TTY lub środowisko przypomina rozbudowany terminal (TERM/COLORTERM/TERM_PROGRAM); uwzględniane są ustawienia NO_COLOR i FORCE_COLOR.
Skrócone prefiksy podsystemów: usuwany jest początkowy segment gateway/, channels/ lub providers/, a następnie zachowywane są najwyżej 2 ostatnie pozostałe segmenty (np. channels/turn/kernel jest wyświetlane jako turn/kernel). Znane podsystemy kanałów (telegram, whatsapp, slack itd.) są zawsze skracane wyłącznie do nazwy kanału.
Rejestratory podrzędne według podsystemu (automatyczny prefiks + ustrukturyzowane pole { subsystem }).
logRaw() do danych wyjściowych QR/UX (bez prefiksu i formatowania).
Style konsoli: pretty | compact | json.
Poziom rejestrowania konsoli jest niezależny od poziomu rejestrowania w pliku (plik zachowuje wszystkie szczegóły, gdy logging.level ma wartość debug lub trace).
Treści wiadomości WhatsApp są rejestrowane na poziomie debug (użyj --verbose, aby je zobaczyć).

Dzięki temu dzienniki plikowe pozostają stabilne, a interaktywne dane wyjściowe są łatwe do przeglądania.

Powiązane materiały

Was this useful?