跳转至

日志记录(macOS)

滚动诊断文件日志(调试窗格)

macOS 应用通过 swift-log 记录日志(默认使用统一日志),也可以写入一个可轮转的本地文件日志以进行持久捕获(DiagnosticsFileLog)。

  • 启用:调试窗格 -> 日志 -> 应用日志 -> “写入滚动诊断日志 (JSONL)”(默认关闭)。
  • 详细程度:调试窗格 -> 日志 -> 应用日志 -> 详细程度 选择器。更改会立即应用于现有应用日志记录器;无需重启。
  • 位置:~/Library/Logs/OpenClaw/diagnostics.jsonl。
  • 轮转:达到 5 MB 时轮转;最多保留 5 个备份,后缀为 .1....5(最旧的会被删除)。
  • 清除:调试窗格 -> 日志 -> 应用日志 -> “清除” 会删除当前活动文件和所有备份。

文件日志是单独的、显式选择加入的功能。启用它不会禁用下文描述的应用插值脱敏。它仍会包含公开和未标注的消息、元数据以及直接诊断记录,其中可能包含敏感数据。仅在调试期间启用,之后关闭,并在共享前检查活动文件和备份。

将统一日志导出为 JSON

运行 ./scripts/clawlog.sh --json 可将最近的统一日志事件作为一个 JSON 数组写入 stdout,或添加 --output logs.json 将数组写入文件而不打印。默认输出包含最近 50 条日志记录;使用 --lines 1 获取最近一条记录,或使用 --all 获取所有匹配记录。在 JSON 模式下,--lines 统计完整记录数,而不是物理行数。

JSON 导出不能与 --follow 或 --list-categories 一起使用。使用这些选项时请勿添加 --json。

应用日志记录器脱敏

macOS 应用的 swift-log 桥接会在将消息交给统一日志或可选文件日志之前,将消息渲染为文本。其插值注释是应用端规则,而不是原生 OSLog 隐私元数据:

  • privacy: .private 会在任一接收端收到值之前,将该值替换为 <private>。
  • privacy: .private(mask: .hash) 会将值替换为带密钥的哈希。相等值在同一个应用进程内可以关联;应用重启后哈希会变化。
  • privacy: .public、未标注的插值以及 swift-log 元数据不会自动脱敏。不要仅因为日志来自统一日志就认为它可以安全共享。

这也会保护在记录前已拼接字符串中的私有插值。详细程度更改、文件捕获以及 macOS 私有数据覆盖都无法恢复已被应用桥接移除的值。

macOS 上的统一日志私有数据

某些共享组件直接使用原生 OSLog,而不是应用的 swift-log 桥接。原生 OSLog 通常会脱敏私有值;显式公开的值仍可见。对于这些原生事件,/Library/Preferences/Logging/Subsystems/ 中的子系统 plist 可以启用私有数据捕获。这不是用来显示桥接的 <private> 占位符或哈希的方法。背景:macOS 日志隐私把戏。

为 OpenClaw (ai.openclaw) 启用

仅当需要从 原生 OSLog 事件中获取私有值时使用此方法。先检查是否已存在 ai.openclaw.plist,并保留它,以便之后恢复先前的设置。将 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

在复现问题之前启用覆盖:它影响新的原生 OSLog 事件,而不是已收集的条目。使用 ./scripts/clawlog.sh --category WebChat --last 5m 检查输出(--last/-l 设置时间范围,默认 5m;--category/-c 按类别过滤)。

调试后禁用

  • 如果你为本次捕获创建了 plist,请删除它:sudo rm /Library/Preferences/Logging/Subsystems/ai.openclaw.plist。如果它之前已存在,请改为恢复保存的版本。
  • 该覆盖可能会在原生事件中暴露电话号码和消息正文。仅在需要时保持启用;删除它不会擦除已捕获的数据。
  • 如果你启用了滚动文件捕获,请单独关闭它。macOS 覆盖不控制该接收端。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw