ClawCN - OpenClaw 中文版

主题

日志记录 (macOS) ​

滚动诊断文件日志(调试面板) ​

OpenClaw 通过 swift-log 路由 macOS 应用程序日志(默认使用统一日志记录),并可在需要持久捕获时将本地滚动文件日志写入磁盘。

  • 详细程度:调试面板 → 日志 → 应用日志记录 → 详细程度
  • 启用:调试面板 → 日志 → 应用日志记录 → "写入滚动诊断日志 (JSONL)"
  • 位置:~/Library/Logs/OpenClaw/diagnostics.jsonl(自动滚动;旧文件后缀为 .1、.2 等)
  • 清除:调试面板 → 日志 → 应用日志记录 → "清除"

注意事项:

  • 此功能默认关闭。仅在主动调试时启用。
  • 将该文件视为敏感信息;未经审查请勿共享。

macOS 统一日志记录中的私有数据 ​

统一日志记录会隐藏大多数有效载荷,除非子系统选择加入 privacy -off。根据 Peter 关于 macOS 日志隐私问题(2025)的文章,这是通过 /Library/Preferences/Logging/Subsystems/ 中的 plist 按子系统名称控制的。只有新的日志条目才会采用该标志,因此在重现问题之前启用它。

为 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。

调试后禁用 ​

  • 删除覆盖:sudo rm /Library/Preferences/Logging/Subsystems/bot.molt.plist。
  • 可选择运行 sudo log config --reload 以强制 logd 立即删除覆盖。
  • 请记住,此界面可能包含电话号码和消息内容;仅在您实际需要额外详细信息时才保留该 plist。