記錄（macOS）

輪替診斷檔案記錄（偵錯窗格）

macOS 應用程式透過 swift-log 記錄（預設使用統一記錄），也可以寫入輪替的本機記錄檔，以便持久保存（DiagnosticsFileLog）。

• 啟用：Debug pane -> Logs -> App logging -> "Write rolling diagnostics log (JSONL)"（預設關閉）。
• 詳細程度：Debug pane -> Logs -> App logging -> Verbosity 選擇器。
• 位置：~/Library/Logs/OpenClaw/diagnostics.jsonl。
• 輪替：達到 5 MB 時輪替；最多保留 5 份備份，後綴為 .1....5（最舊者會被刪除）。
• 清除：Debug pane -> Logs -> App logging -> "Clear" 會刪除目前使用中的檔案及所有備份。

請將此檔案視為敏感資料；未經檢視請勿分享。

macOS 統一記錄中的私密資料

除非子系統選擇啟用 privacy -off，否則統一記錄會遮蔽大多數承載內容。此行為由 /Library/Preferences/Logging/Subsystems/ 中以子系統名稱為鍵的 plist 控制。只有新產生的記錄項目會套用此旗標，因此請在重現問題前啟用。背景資訊：macOS 記錄隱私機制解析。

為 OpenClaw（ai.openclaw）啟用

先將 plist 寫入暫存檔，再以 root 身分以不可分割方式安裝：

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

不需要重新啟動；logd 會很快讀取此檔案，但只有新的記錄行會包含私密承載內容。使用 ./scripts/clawlog.sh --category WebChat --last 5m 檢視內容更豐富的輸出（--last/-l 設定時間範圍，預設為 5m；--category/-c 依類別篩選）。

偵錯後停用

• 移除覆寫設定：sudo rm /Library/Preferences/Logging/Subsystems/ai.openclaw.plist。
• 可選擇執行 sudo log config --reload，強制 logd 立即停用覆寫設定。
• 此記錄介面可能包含電話號碼及訊息內容；僅在確實需要時保留此 plist。

相關內容

• macOS 應用程式
• 閘道記錄