日志（macOS）

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

OpenClaw 的 macOS 应用日志通过 swift-log 路由（默认走统一日志系统），在需要持久化记录时可以写入本地滚动文件日志。

• 详细程度：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 统一日志的隐私数据

统一日志默认会脱敏大部分载荷，除非某个 subsystem 选择了 privacy -off。按 Peter 关于 macOS 日志隐私问题（2025）的文章，这通过 /Library/Preferences/Logging/Subsystems/ 中的 plist 按 subsystem 名称控制。只有新的日志条目才会受此标记影响，所以要在复现问题前启用。

为 OpenClaw 启用（ai.openclaw）

• 先写入临时文件，然后以 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。