Skip to main content

Pencatatan log (macOS)

Log file diagnostik bergulir (panel Debug)

Aplikasi macOS mencatat log melalui swift-log (secara default menggunakan pencatatan log terpadu) dan juga dapat menulis log file lokal bergulir untuk perekaman yang tahan lama (DiagnosticsFileLog).
  • Aktifkan: Debug pane -> Logs -> App logging -> “Write rolling diagnostics log (JSONL)” (secara default nonaktif).
  • Tingkat detail: pemilih Debug pane -> Logs -> App logging -> Verbosity.
  • Lokasi: ~/Library/Logs/OpenClaw/diagnostics.jsonl.
  • Rotasi: dirotasi pada ukuran 5 MB; hingga 5 cadangan dengan akhiran .1.5 (yang paling lama dihapus).
  • Hapus: Debug pane -> Logs -> App logging -> “Clear” menghapus file aktif dan semua cadangan.
Perlakukan file tersebut sebagai data sensitif; jangan membagikannya tanpa peninjauan.

Data privat pencatatan log terpadu di macOS

Pencatatan log terpadu menyunting sebagian besar muatan kecuali suatu subsistem mengaktifkan privacy -off. Hal ini dikendalikan oleh plist di /Library/Preferences/Logging/Subsystems/ yang menggunakan nama subsistem sebagai kunci. Hanya entri log baru yang menerapkan tanda tersebut, jadi aktifkan sebelum mereproduksi masalah. Latar belakang: seluk-beluk privasi pencatatan log macOS.

Aktifkan untuk OpenClaw (ai.openclaw)

Tulis plist terlebih dahulu ke file sementara, lalu instal secara atomik sebagai root:
Tidak perlu memulai ulang; logd segera mendeteksi file tersebut, tetapi hanya baris log baru yang menyertakan muatan privat. Lihat keluaran yang lebih lengkap dengan ./scripts/clawlog.sh --category WebChat --last 5m (--last/-l menetapkan rentang waktu, default 5m; --category/-c memfilter berdasarkan kategori).

Nonaktifkan setelah melakukan debug

  • Hapus penggantian: sudo rm /Library/Preferences/Logging/Subsystems/ai.openclaw.plist.
  • Secara opsional, jalankan sudo log config --reload untuk memaksa logd segera membuang penggantian tersebut.
  • Bagian ini dapat mencakup nomor telepon dan isi pesan; pertahankan plist hanya saat benar-benar diperlukan.

Terkait