日志系统（macOS）

滚动诊断文件日志（Debug 面板）

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

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

注意事项

• 此功能默认关闭。仅在主动调试时启用。
• 将该文件视为敏感信息；不要在未审查的情况下分享。

macOS 上的统一日志隐私数据

统一日志默认会编辑大多数负载，除非子系统选择启用 privacy -off。根据 Peter 关于 macOS 日志隐私机制（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。