OpenClawSkills
GitHub
平台 • 5 分钟阅读

macOS Logging

OpenClaw logging: rolling diagnostics file log + unified log privacy flags

Tutorial.step

滚动诊断文件日志（调试窗格）

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

- 详细程度：调试窗格 → 日志 → 应用程序日志 → 详细程度

- 启用：调试窗格 → 日志 → 应用程序日志 → "写入滚动诊断日志（JSONL）"

- 位置：''~/Library/Logs/OpenClaw/diagnostics.jsonl''（自动旋转；旧文件后缀为 ''.1''、''.2''、…）

- 清除：调试窗格 → 日志 → 应用程序日志 → "清除"

说明：

- 这默认关闭。仅在主动调试时启用。

- 将文件视为敏感；未经审查不要共享。

Tutorial.step

macOS 上的统一日志私有数据

统一日志会编辑大多数负载，除非子系统选择加入 ''privacy -off''。根据 Peter 在 macOS ''日志隐私恶作剧''（2025）上的写入，这由 ''/Library/Preferences/Logging/Subsystems/'' 中按子系统名称键入的 plist 控制。只有新的日志条目会获取标志，因此在重现问题之前启用它。

Tutorial.step

为 OpenClaw 启用（`bot.molt`）

- 首先将 plist 写入临时文件，然后以 root 用户身份原子安装它：

Bash
cat '<<''EOF'' >'/tmp/bot.molt.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/bot.molt.plist /Library/Preferences/Logging/Subsystems/bot.molt.plist

- 不需要重新启动；logd 会快速注意到文件，但只有新的日志行将包含私有负载。

- 使用现有的帮助程序查看更丰富的输出，例如 ''./scripts/clawlog.sh --category WebChat --last 5m''。

Tutorial.step

调试后禁用

- 删除覆盖：''sudo rm /Library/Preferences/Logging/Subsystems/bot.molt.plist''。

- 可选择运行 ''sudo log config --reload'' 以强制 logd 立即删除覆盖。

- 请记住，此表面可能包含电话号码和消息正文；仅在您主动需要额外详细信息时保留 plist。