macOS 日志

概述

OpenClaw macOS 应用通过 swift-log 路由日志（默认使用 unified logging），支持写入本地滚动文件日志。

滚动诊断文件日志

• 开启路径：Debug 面板 → Logs → App logging → “Write rolling diagnostics log (JSONL)”
• 日志位置：~/Library/Logs/OpenClaw/diagnostics.jsonl（自动轮转，旧文件加 .1、.2 后缀）
• 清除：Debug 面板 → Logs → App logging → “Clear”
• 默认关闭，仅在调试时启用；文件含敏感信息，分享前需审查

Unified Logging 私有数据

macOS unified logging 默认隐藏大多数 payload。启用私有数据：

# 写入 plist 并安装
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 会快速识别，但只有新日志行才包含私有 payload
• 查看日志：./scripts/clawlog.sh --category WebChat --last 5m

调试后关闭

sudo rm /Library/Preferences/Logging/Subsystems/ai.openclaw.plist
# 可选：立即生效
sudo log config --reload

注意：私有数据可能包含电话号码和消息内容，调试完成后立即移除。

相关链接

• platform-macos — macOS 伴侣应用
• platform-mac-bundled-gateway — Gateway 日志路径