日志（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。根据 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。

提示：调试完"我的龙虾"的行为后，记得及时关闭私有日志，避免意外泄露敏感信息。