CLI commands

Log

`openclaw logs`

Ikuti log file Gateway melalui RPC (berfungsi dalam mode jarak jauh).

Terkait:

Ikhtisar pencatatan: Pencatatan
CLI Gateway: gateway

Opsi

--limit <n>: jumlah maksimum baris log yang akan dikembalikan (default 200)
--max-bytes <n>: byte maksimum yang akan dibaca dari file log (default 250000)
--follow: ikuti aliran log
--interval <ms>: interval polling saat mengikuti (default 1000)
--json: hasilkan peristiwa JSON berbatas baris
--plain: keluaran teks biasa tanpa pemformatan bergaya
--no-color: nonaktifkan warna ANSI
--local-time: render stempel waktu dalam zona waktu lokal Anda (default)
--utc: render stempel waktu dalam UTC

Opsi RPC Gateway Bersama

openclaw logs juga menerima flag klien Gateway standar:

--url <url>: URL WebSocket Gateway
--token <token>: token Gateway
--timeout <ms>: batas waktu dalam ms (default 30000)
--expect-final: tunggu respons final saat panggilan Gateway didukung agen

Saat Anda meneruskan --url, CLI tidak menerapkan kredensial konfigurasi atau lingkungan secara otomatis. Sertakan --token secara eksplisit jika Gateway target memerlukan autentikasi.

Contoh

bash

openclaw logsopenclaw logs --followopenclaw logs --follow --interval 2000openclaw logs --limit 500 --max-bytes 500000openclaw logs --jsonopenclaw logs --plainopenclaw logs --no-coloropenclaw logs --limit 500openclaw logs --local-timeopenclaw logs --utcopenclaw logs --follow --local-timeopenclaw logs --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"

Catatan

Stempel waktu dirender dalam zona waktu lokal Anda secara default. Gunakan --utc untuk keluaran UTC.
Jika Gateway local loopback implisit meminta pairing, tertutup saat tersambung, atau kehabisan waktu sebelum logs.tail menjawab, openclaw logs secara otomatis beralih ke log file Gateway yang dikonfigurasi. Target --url eksplisit tidak menggunakan fallback ini.
openclaw logs --follow tidak mengikuti fallback file yang dikonfigurasi setelah kegagalan RPC Gateway lokal implisit. Di Linux, ini menggunakan jurnal Gateway user-systemd aktif berdasarkan PID jika tersedia dan mencetak sumber log yang dipilih; jika tidak, ini terus mencoba ulang Gateway langsung alih-alih mengikuti file berdampingan yang berpotensi kedaluwarsa.
Saat menggunakan --follow, pemutusan gateway sementara (penutupan WebSocket, batas waktu, koneksi terputus) memicu penyambungan ulang otomatis dengan backoff eksponensial (hingga 8 percobaan ulang, dibatasi 30 dtk antarpercobaan). Peringatan dicetak ke stderr pada setiap percobaan ulang, dan pemberitahuan [logs] gateway reconnected dicetak setelah polling berhasil. Dalam mode --json, baik peringatan percobaan ulang maupun transisi penyambungan ulang dipancarkan sebagai record {"type":"notice"} pada stderr. Kesalahan yang tidak dapat dipulihkan (kegagalan autentikasi, konfigurasi buruk) tetap keluar segera.
Dalam mode --follow --json, transisi sumber log dipancarkan sebagai record {"type":"meta"}. Konsumen harus melacak kursor per sourceKind: sebuah aliran dapat berpindah dari keluaran file Gateway (sourceKind: "file") ke fallback jurnal lokal (sourceKind: "journal", localFallback: true, dengan service.pid/service.unit) dan kembali ke keluaran file Gateway setelah pemulihan. Jangan mengasumsikan satu sumber atau kursor stabil untuk seluruh sesi follow, dan toleransi baris yang tumpang tindih saat pemulihan memutar ulang kursor file Gateway.

Terkait

Was this useful?

Log