Skip to main content

​
Pencatatan Log

Untuk ringkasan yang ditujukan bagi pengguna (CLI + UI Kontrol + konfigurasi), lihat /logging. OpenClaw memiliki dua media log:
  • Keluaran konsol - yang Anda lihat di terminal / UI Debug.
  • Log file - baris JSON yang ditulis oleh pencatat log Gateway.
Saat dimulai, Gateway mencatat model agen bawaan yang telah ditetapkan beserta bawaan mode yang memengaruhi sesi baru:
thinking berasal dari agen bawaan, parameter model, atau bawaan agen global; jika tidak ditetapkan, nilainya ditampilkan sebagai medium. fast berasal dari agen bawaan atau parameter fastMode model.

​
Pencatat log berbasis file

  • File log bergulir bawaan berada di bawah /tmp/openclaw/ (satu file per hari): openclaw-YYYY-MM-DD.log, dengan tanggal berdasarkan zona waktu lokal hos Gateway. Jika direktori tersebut tidak aman atau tidak dapat ditulisi (pemilik salah, dapat ditulisi semua pengguna, atau merupakan symlink), OpenClaw beralih ke jalur os.tmpdir()/openclaw-<uid> yang tercakup bagi pengguna; pada Windows, OpenClaw selalu menggunakan jalur cadangan direktori sementara OS tersebut.
  • File log aktif dirotasi saat mencapai logging.maxFileBytes (bawaan: 100 MB), dengan mempertahankan hingga lima arsip bernomor (.1 hingga .5) dan melanjutkan penulisan ke file aktif baru.
  • Konfigurasikan jalur dan tingkat file log melalui ~/.openclaw/openclaw.json: logging.file, logging.level.
  • Format file berisi satu objek JSON per baris.
Jalur kode percakapan, suara waktu nyata, dan ruang terkelola menggunakan pencatat log file bersama untuk catatan siklus hidup terbatas yang ditujukan bagi penelusuran kesalahan operasional dan ekspor log OTLP. Teks transkrip, muatan audio, ID giliran, ID panggilan, dan ID item penyedia tidak pernah disalin ke dalam catatan log. Tab Log di UI Kontrol mengikuti file ini melalui Gateway (logs.tail). CLI melakukan hal yang sama:

​
Verbose dibandingkan dengan tingkat log

  • Log file dikendalikan secara eksklusif oleh logging.level.
  • --verbose hanya memengaruhi tingkat detail konsol (dan gaya log WS) - opsi ini tidak menaikkan tingkat log file.
  • Untuk merekam detail yang hanya tersedia dalam mode verbose ke log file, tetapkan logging.level ke debug atau trace.
  • Pencatatan log trace juga menyertakan ringkasan waktu diagnostik untuk jalur penting tertentu, seperti persiapan pabrik alat Plugin. Lihat /tools/plugin#slow-plugin-tool-setup.

​
Perekaman konsol

CLI merekam console.log/info/warn/error/debug/trace, menuliskannya ke log file, dan tetap mencetaknya ke stdout/stderr. Sesuaikan tingkat detail konsol secara terpisah:
  • logging.consoleLevel (bawaan info)
  • logging.consoleStyle (pretty | compact | json; bawaannya pretty pada TTY, dan compact jika bukan)

​
Redaksi

OpenClaw menyamarkan token sensitif sebelum keluaran log atau transkrip meninggalkan proses. Kebijakan redaksi ini berlaku pada konsol, log file, catatan log OTLP, dan tujuan teks transkrip sesi, sehingga nilai rahasia yang cocok disamarkan sebelum baris JSONL atau pesan ditulis ke disk.
  • logging.redactSensitive: off | tools (bawaan: tools)
  • logging.redactPatterns: larik string regex (menggantikan bawaan)
    • Gunakan string regex mentah (gi otomatis), atau /pattern/flags untuk flag khusus.
    • Kecocokan disamarkan dengan mempertahankan 6 karakter pertama + 4 karakter terakhir (untuk nilai >= 18 karakter); nilai yang lebih pendek menjadi ***.
    • Bawaan mencakup penetapan kunci umum, flag CLI, kolom JSON, header bearer, blok PEM, prefiks token vendor populer, serta nama kolom kredensial pembayaran (nomor kartu, CVC/CVV, token pembayaran bersama, kredensial pembayaran).
Beberapa batas keamanan selalu melakukan redaksi terlepas dari logging.redactSensitive: peristiwa pemanggilan alat UI Kontrol, keluaran alat sessions_history, ekspor dukungan diagnostik, pengamatan kesalahan penyedia, tampilan perintah persetujuan exec, dan log protokol WebSocket Gateway. Media ini tetap menerapkan logging.redactPatterns sebagai pola tambahan, tetapi redactSensitive: "off" tidak membuatnya mengeluarkan rahasia mentah.

​
Log WebSocket Gateway

Gateway mencetak log protokol WebSocket dalam dua mode:
  • Mode normal (tanpa --verbose): hanya hasil RPC yang “menarik” yang dicetak - kesalahan (ok=false), panggilan lambat (ambang bawaan: >= 50ms), dan kesalahan penguraian.
  • Mode verbose (--verbose): mencetak semua lalu lintas permintaan/respons WS.

​
Gaya log WS

openclaw gateway mendukung pengalihan gaya per Gateway:
  • --ws-log auto (bawaan): mode normal dioptimalkan; mode verbose menggunakan keluaran ringkas.
  • --ws-log compact: keluaran ringkas (permintaan/respons berpasangan) saat verbose.
  • --ws-log full: keluaran lengkap per bingkai saat verbose.
  • --compact: alias untuk --ws-log compact.

​
Pemformatan konsol (pencatatan log subsistem)

Pemformat konsol mengenali TTY dan mencetak baris konsisten dengan prefiks. Pencatat log subsistem menjaga keluaran tetap terkelompok dan mudah dipindai:
  • Prefiks subsistem pada setiap baris (misalnya [gateway], [canvas], [tailscale]).
  • Warna subsistem (stabil per subsistem, di-hash dari namanya) beserta pewarnaan tingkat.
  • Warna saat keluaran merupakan TTY atau lingkungan tampak seperti terminal kaya fitur (TERM/COLORTERM/TERM_PROGRAM); mematuhi NO_COLOR dan FORCE_COLOR.
  • Prefiks subsistem yang dipersingkat: menghapus segmen awal gateway/, channels/, atau providers/, lalu mempertahankan paling banyak 2 segmen terakhir yang tersisa (misalnya channels/turn/kernel ditampilkan sebagai turn/kernel). Subsistem saluran yang dikenal (telegram, whatsapp, slack, dan sebagainya) selalu diringkas menjadi nama saluran saja.
  • Pencatat log turunan berdasarkan subsistem (prefiks otomatis + kolom terstruktur { subsystem }).
  • logRaw() untuk keluaran QR/UX (tanpa prefiks, tanpa pemformatan).
  • Gaya konsol: pretty | compact | json.
  • Tingkat log konsol terpisah dari tingkat log file (file mempertahankan detail lengkap ketika logging.level bernilai debug/trace).
  • Isi pesan WhatsApp dicatat pada tingkat debug (gunakan --verbose untuk melihatnya).
Hal ini menjaga kestabilan log file sekaligus membuat keluaran interaktif mudah dipindai.

​
Terkait