macOS 日志记录

日志记录 (macOS)

滚动诊断文件日志 (Debug 面板)

OpenClaw 通过 swift-log 路由 macOS 应用日志（默认使用统一日志记录），当你需要持久化捕获时，可以将日志写入磁盘上的本地轮转文件日志。

详细程度：Debug pane → Logs → App logging → Verbosity
启用：Debug pane → Logs → App logging → "Write rolling diagnostics log (JSONL)"
位置：~/Library/Logs/OpenClaw/diagnostics.jsonl（自动轮转；旧文件后缀为 .1、.2、…）
清除：Debug pane → Logs → App logging → "Clear"

注意：

此功能默认关闭。仅在积极调试时启用。
将此文件视为敏感文件；未经审查请勿分享。

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。

调试后禁用