跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
記錄（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。

​
相關