> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Logi

# `openclaw logs`

Śledź logi plikowe Gateway przez RPC (działa w trybie zdalnym).

Powiązane:

* Omówienie logowania: [Logowanie](/pl/logging)
* CLI Gateway: [gateway](/pl/cli/gateway)

## Opcje

* `--limit <n>`: maksymalna liczba wierszy logów do zwrócenia (domyślnie `200`)
* `--max-bytes <n>`: maksymalna liczba bajtów do odczytania z pliku logu (domyślnie `250000`)
* `--follow`: śledź strumień logów
* `--interval <ms>`: interwał odpytywania podczas śledzenia (domyślnie `1000`)
* `--json`: emituj zdarzenia JSON rozdzielane wierszami
* `--plain`: zwykłe wyjście tekstowe bez stylizowanego formatowania
* `--no-color`: wyłącz kolory ANSI
* `--local-time`: renderuj znaczniki czasu w lokalnej strefie czasowej (domyślnie)
* `--utc`: renderuj znaczniki czasu w UTC

## Współdzielone opcje RPC Gateway

`openclaw logs` akceptuje także standardowe flagi klienta Gateway:

* `--url <url>`: URL WebSocket Gateway
* `--token <token>`: token Gateway
* `--timeout <ms>`: limit czasu w ms (domyślnie `30000`)
* `--expect-final`: czekaj na końcową odpowiedź, gdy wywołanie Gateway jest obsługiwane przez agenta

Gdy przekażesz `--url`, CLI nie stosuje automatycznie poświadczeń z konfiguracji ani środowiska. Dołącz jawnie `--token`, jeśli docelowy Gateway wymaga uwierzytelniania.

## Przykłady

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw logs
openclaw logs --follow
openclaw logs --follow --interval 2000
openclaw logs --limit 500 --max-bytes 500000
openclaw logs --json
openclaw logs --plain
openclaw logs --no-color
openclaw logs --limit 500
openclaw logs --local-time
openclaw logs --utc
openclaw logs --follow --local-time
openclaw logs --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"
```

## Uwagi

* Znaczniki czasu są domyślnie renderowane w lokalnej strefie czasowej. Użyj `--utc`, aby uzyskać wyjście w UTC.
* Jeśli niejawny lokalny Gateway local loopback poprosi o parowanie, zamknie połączenie podczas łączenia albo przekroczy limit czasu, zanim `logs.tail` odpowie, `openclaw logs` automatycznie przełączy się na skonfigurowany plik logu Gateway. Jawne cele `--url` nie używają tego przełączenia awaryjnego.
* `openclaw logs --follow` nie śledzi skonfigurowanych plikowych przełączeń awaryjnych po niepowodzeniach niejawnego lokalnego RPC Gateway. W systemie Linux używa aktywnego dziennika Gateway user-systemd według PID, gdy jest dostępny, i wypisuje wybrane źródło logów; w przeciwnym razie ponawia próby połączenia z działającym Gateway zamiast śledzić potencjalnie nieaktualny plik obok.
* Podczas używania `--follow` przejściowe rozłączenia gateway (zamknięcie WebSocket, limit czasu, zerwanie połączenia) wyzwalają automatyczne ponowne połączenie z wykładniczym wycofywaniem (do 8 ponowień, z limitem 30 s między próbami). Przy każdej ponownej próbie ostrzeżenie jest wypisywane do stderr, a po udanym odpytywaniu wypisywane jest powiadomienie `[logs] gateway reconnected`. W trybie `--json` zarówno ostrzeżenie o ponownej próbie, jak i przejście po ponownym połączeniu są emitowane jako rekordy `{"type":"notice"}` na stderr. Błędy nienaprawialne (niepowodzenie uwierzytelniania, zła konfiguracja) nadal powodują natychmiastowe zakończenie.
* W trybie `--follow --json` przejścia źródła logów są emitowane jako rekordy `{"type":"meta"}`. Konsumenci powinni śledzić kursory osobno dla każdego `sourceKind`: strumień może przejść z wyjścia plikowego Gateway (`sourceKind: "file"`) do lokalnego przełączenia awaryjnego na dziennik (`sourceKind: "journal"`, `localFallback: true`, z `service.pid`/`service.unit`) i z powrotem do wyjścia plikowego Gateway po odzyskaniu działania. Nie zakładaj jednego stabilnego źródła ani kursora dla całej sesji śledzenia i toleruj nakładające się wiersze, gdy odzyskiwanie odtwarza kursor pliku Gateway.

## Powiązane

* [Dokumentacja CLI](/pl/cli)
* [Logowanie Gateway](/pl/gateway/logging)