> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# macOS 日誌記錄

# 記錄（macOS）

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

macOS app 透過 swift-log 記錄（預設使用統一記錄），也可以寫入輪替的本機檔案記錄，以便持久擷取（`DiagnosticsFileLog`）。

* 啟用：**除錯窗格 -> 記錄 -> App logging -> "Write rolling diagnostics log (JSONL)"**（預設關閉）。
* 詳細程度：**除錯窗格 -> 記錄 -> App logging -> Verbosity** 選擇器。
* 位置：`~/Library/Logs/OpenClaw/diagnostics.jsonl`。
* 輪替：達到 5 MB 時輪替；最多 5 份備份，後綴為 `.1`...`.5`（最舊的會被丟棄）。
* 清除：**除錯窗格 -> 記錄 -> App logging -> "Clear"** 會刪除作用中的檔案和所有備份。

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

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

除非子系統選擇加入 `privacy -off`，否則統一記錄會遮蔽大多數酬載。這是由 `/Library/Preferences/Logging/Subsystems/` 中的 plist 控制，並以子系統名稱作為鍵。只有新的記錄項目會套用此旗標，因此請在重現問題前啟用。背景：[macOS logging privacy shenanigans](https://steipete.me/posts/2025/logging-privacy-shenanigans)。

## 為 OpenClaw 啟用（`ai.openclaw`）

先將 plist 寫入暫存檔，然後以 root 身分原子式安裝：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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` 查看更豐富的輸出（`--last`/`-l` 設定時間範圍，預設為 `5m`；`--category`/`-c` 依類別篩選）。

## 除錯後停用

* 移除覆寫：`sudo rm /Library/Preferences/Logging/Subsystems/ai.openclaw.plist`。
* 可選擇執行 `sudo log config --reload`，強制 logd 立即捨棄覆寫。
* 這個介面可能包含電話號碼和訊息內文；只有在主動需要時才保留 plist。

## 相關

* [macOS app](/zh-TW/platforms/macos)
* [閘道記錄](/zh-TW/gateway/logging)