OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

macOS companion app

Pencatatan log macOS

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:

bash
cat <<'EOF' >/tmp/ai.openclaw.plist<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"><plist version="1.0"><dict>    <key>DEFAULT-OPTIONS</key>    <dict>        <key>Enable-Private-Data</key>        <true/>    </dict></dict></plist>EOFsudo install -m 644 -o root -g wheel /tmp/ai.openclaw.plist /Library/Preferences/Logging/Subsystems/ai.openclaw.plist

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

Was this useful?
On this page

On this page