# 記錄（macOS）

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

OpenClaw 會透過 swift-log 路由 macOS 應用程式記錄（預設為統一記錄），並可在你需要可保留擷取內容時，將本機輪替檔案記錄寫入磁碟。

• 詳細程度：偵錯窗格 → 記錄 → 應用程式記錄 → 詳細程度
• 啟用：偵錯窗格 → 記錄 → 應用程式記錄 →「寫入輪替式診斷記錄（JSONL）」
• 位置：~/Library/Logs/OpenClaw/diagnostics.jsonl（會自動輪替；舊檔案會加上 .1、.2、… 後綴）
• 清除：偵錯窗格 → 記錄 → 應用程式記錄 →「清除」

注意事項：

• 這項功能預設關閉。只在主動偵錯時啟用。
• 請將此檔案視為敏感資料；未審閱前請勿分享。

# macOS 上統一記錄的私有資料

除非某個子系統選擇加入 privacy -off，否則統一記錄會遮蔽大多數酬載。根據 Peter 關於 macOS logging privacy shenanigans（2025）的文章，這是由 /Library/Preferences/Logging/Subsystems/ 中以子系統名稱為鍵的 plist 控制。只有新的記錄項目會套用該旗標，因此請在重現問題之前啟用它。

# 為 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>
EOF
sudo 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。

# 偵錯後停用

• 移除覆寫：sudo rm /Library/Preferences/Logging/Subsystems/ai.openclaw.plist。
• 也可以執行 sudo log config --reload，強制 logd 立即捨棄覆寫。
• 請記得此表面可能包含電話號碼和訊息本文；只有在你主動需要額外細節時，才保留該 plist。

# 相關

• macOS 應用程式
• Gateway 記錄