Rejestrowanie zdarzeń

• Dzienniki plikowe (wiersze JSON) zapisywane przez Gateway.
• Dane wyjściowe konsoli w terminalu, w którym działa Gateway.

​

Gdzie znajdują się dzienniki

{
  "logging": {
    "file": "/path/to/openclaw.log"
  }
}

​

Jak odczytywać dzienniki

​

CLI: śledzenie na żywo (zalecane)

openclaw logs --follow

• Sesje TTY: czytelne, kolorowe i ustrukturyzowane wiersze dziennika.
• Sesje inne niż TTY: zwykły tekst.

• meta: metadane strumienia (plik, źródło, rodzaj źródła, usługa, kursor, rozmiar)
• log: przeanalizowany wpis dziennika
• notice: wskazówki dotyczące obcięcia lub rotacji
• raw: nieprzeanalizowany wiersz dziennika
• error: błędy połączenia z Gateway (zapisywane do stderr)

openclaw doctor

​

Interfejs sterowania (WWW)

​

Dzienniki tylko dla kanałów

openclaw channels logs --channel whatsapp

​

Formaty dzienników

​

Dzienniki plikowe (JSONL)

• hostname: nazwa hosta Gateway.
• message: spłaszczony tekst komunikatu dziennika do wyszukiwania pełnotekstowego.
• agent_id: identyfikator aktywnego agenta, gdy wywołanie dziennika zawiera kontekst agenta.
• session_id: identyfikator lub klucz aktywnej sesji, gdy wywołanie dziennika zawiera kontekst sesji.
• channel: aktywny kanał, gdy wywołanie dziennika zawiera kontekst kanału.

​

Dane wyjściowe konsoli

• Prefiksy podsystemów (np. gateway/channels/whatsapp)
• Kolorowanie poziomów (informacje/ostrzeżenia/błędy)
• Opcjonalny tryb kompaktowy lub JSON

​

Dzienniki WebSocket Gateway

• tryb normalny: tylko istotne wyniki (błędy, błędy analizy, wolne wywołania)
• --verbose: cały ruch żądań i odpowiedzi
• --ws-log auto|compact|full: wybór szczegółowego stylu wyświetlania
• --compact: alias dla --ws-log compact

openclaw gateway
openclaw gateway --verbose --ws-log compact
openclaw gateway --verbose --ws-log full

​

Konfigurowanie rejestrowania

{
  "logging": {
    "level": "info",
    "file": "/tmp/openclaw/openclaw-YYYY-MM-DD.log",
    "consoleLevel": "info",
    "consoleStyle": "pretty",
    "redactSensitive": "tools",
    "redactPatterns": ["sk-.*"]
  }
}

​

Poziomy dzienników

• logging.level: poziom dzienników plikowych (JSONL) (domyślnie: info).
• logging.consoleLevel: poziom szczegółowości konsoli.

​

Ukierunkowana diagnostyka transportu modelu

OPENCLAW_DEBUG_MODEL_TRANSPORT=1 openclaw gateway
OPENCLAW_DEBUG_MODEL_PAYLOAD=tools OPENCLAW_DEBUG_SSE=events openclaw gateway

• OPENCLAW_DEBUG_MODEL_TRANSPORT=1: emituje rozpoczęcie żądania, odpowiedź pobierania, nagłówki SDK, pierwsze zdarzenie strumieniowe, zakończenie strumienia i błędy transportu na poziomie info.
• OPENCLAW_DEBUG_MODEL_PAYLOAD=summary: uwzględnia ograniczone podsumowanie ładunku żądania w dziennikach żądań modelu.
• OPENCLAW_DEBUG_MODEL_PAYLOAD=tools: uwzględnia w podsumowaniu ładunku wszystkie nazwy narzędzi widoczne dla modelu.
• OPENCLAW_DEBUG_MODEL_PAYLOAD=full-redacted: uwzględnia zredagowaną, ograniczoną migawkę ładunku JSON. Używaj tylko podczas debugowania; sekrety są redagowane, ale monity i tekst wiadomości mogą nadal być obecne.
• OPENCLAW_DEBUG_SSE=events: emituje pomiary czasu pierwszego zdarzenia i zakończenia strumienia.
• OPENCLAW_DEBUG_SSE=peek: emituje również ładunki pierwszych pięciu zredagowanych zdarzeń SSE, z limitem dla każdego zdarzenia.
• OPENCLAW_DEBUG_CODE_MODE=1: emituje diagnostykę powierzchni modelu w trybie kodu, w tym informacje o ukrywaniu natywnych narzędzi dostawcy, ponieważ powierzchnia narzędzi należy do trybu kodu.

​

Korelacja śladów

​

Rozmiar i czas wywołania modelu

• requestPayloadBytes: rozmiar końcowego ładunku żądania modelu w bajtach UTF-8
• responseStreamBytes: rozmiar ładunków fragmentów strumieniowej odpowiedzi modelu w bajtach UTF-8. Częste zdarzenia różnicowe tekstu, rozumowania i wywołań narzędzi zliczają wyłącznie przyrostowe bajty delta, a nie pełne migawki partial.
• timeToFirstByteMs: czas, który upłynął przed pierwszym zdarzeniem odpowiedzi strumieniowej
• durationMs: całkowity czas trwania wywołania modelu

​

Style konsoli

• pretty: czytelny dla człowieka, kolorowy, ze znacznikami czasu.
• compact: bardziej zwięzłe dane wyjściowe (najlepsze dla długich sesji).
• json: jeden obiekt JSON na wiersz (dla procesorów dzienników).

​

Redagowanie

• logging.redactSensitive: off | tools (domyślnie: tools)
• logging.redactPatterns: lista ciągów wyrażeń regularnych zastępująca domyślny zestaw dla danych wyjściowych dzienników i transkrypcji. W przypadku ładunków narzędzi interfejsu sterowania niestandardowe wzorce są stosowane dodatkowo do wbudowanych wartości domyślnych, więc dodanie wzorca nigdy nie osłabia redagowania wartości już wykrywanych przez ustawienia domyślne.

​

Diagnostyka i OpenTelemetry

• Eksport OpenTelemetry — wysyłanie metryk, śladów i dzienników przez OTLP/HTTP do dowolnego kolektora lub zaplecza zgodnego z OpenTelemetry (Datadog, Grafana, Honeycomb, New Relic, Tempo itp.). Pełna konfiguracja, katalog sygnałów, nazwy metryk i segmentów, zmienne środowiskowe oraz model prywatności znajdują się na osobnej stronie: Eksport OpenTelemetry.
• Flagi diagnostyczne — ukierunkowane flagi dzienników debugowania, które kierują dodatkowe wpisy do logging.file bez podnoszenia poziomu logging.level. Wielkość liter we flagach nie ma znaczenia, a flagi obsługują symbole wieloznaczne (telegram.*, *). Skonfiguruj je w diagnostics.flags lub za pomocą nadpisania przez zmienną środowiskową OPENCLAW_DIAGNOSTICS=.... Pełny przewodnik: Flagi diagnostyczne.

​

Wskazówki dotyczące rozwiązywania problemów

• Brak dostępu do Gateway? Najpierw uruchom openclaw doctor.
• Dzienniki są puste? Sprawdź, czy Gateway działa i zapisuje dane w ścieżce pliku określonej w logging.file.
• Potrzebujesz więcej szczegółów? Ustaw logging.level na debug lub trace i spróbuj ponownie.

​

Powiązane materiały

• Eksport OpenTelemetry — eksport OTLP/HTTP, katalog metryk i segmentów, model prywatności
• Flagi diagnostyczne — ukierunkowane flagi dzienników debugowania
• Wewnętrzne mechanizmy rejestrowania Gateway — style dzienników WS, prefiksy podsystemów i przechwytywanie konsoli
• Dokumentacja konfiguracji — pełna dokumentacja pól diagnostics.*