本页内容
本页内容
macOS 配套应用程序
macOS 日志
日志(macOS)
滚动诊断文件日志(调试面板)
macOS 应用通过 swift-log(默认使用统一日志)进行日志记录,并且还可以写入轮转的本地文件日志,以便持久保存捕获内容(DiagnosticsFileLog)。
- 启用:调试面板 -> 日志 -> 应用日志 -> “写入滚动诊断日志(JSONL)”(默认关闭)。
- Verbosity:调试窗格 -> 日志 -> 应用程序日志记录 -> Verbosity 选择器。更改立即应用于现有的应用程序记录器;无需重新启动。
- 位置:
~/Library/Logs/OpenClaw/diagnostics.jsonl。 - 轮转:在 5 MB 时轮转;最多保留 5 个备份,后缀为
.1....5(最旧的会被删除)。 - 清除:调试面板 -> 日志 -> 应用日志 -> “清除” 会删除当前文件及所有备份。
文件日志是一个单独的、显式的选择加入。启用它不会禁用应用程序的插值编辑,如下所述。它仍然包括公共和未注释的消息、元数据和直接诊断记录,其中可能包含敏感数据。仅在调试时启用它,之后将其关闭,并在共享之前查看活动文件和备份。
导出统一日志为JSON
运行 ./scripts/clawlog.sh --json 将最近的统一日志事件作为一个 JSON 数组写入标准输出,或添加 --output logs.json 将数组写入文件而不打印它。默认输出包含最近50条日志记录;使用 --lines 1 作为最近的记录,或使用 --all 作为每个匹配的记录。 --lines 在 JSON 模式下统计完整记录,而不是物理行。
JSON 导出不能与 --follow 或 --list-categories 组合。使用这些选项而不使用 --json。
App 记录器编辑
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)启用
仅当您需要 native OSLog 事件的私有值时才使用此选项。首先检查现有的 ai.openclaw.plist 并保留它,以便您可以在以后恢复之前的设置。将 plist 写入临时文件,然后以 root 身份自动安装:
在重现问题之前启用覆盖:它会影响新的本机 OSLog 事件,而不是已收集的条目。使用./scripts/clawlog.sh --category WebChat --last 5m检查输出(--last/-l设置时间范围,默认5m;--category/-c按类别过滤)。
调试后禁用
- 如果您为此捕获创建了 plist,请将其删除:
sudo rm /Library/Preferences/Logging/Subsystems/ai.openclaw.plist。如果之前存在,则恢复保存的版本。 - 覆盖可以在本机事件中公开电话号码和消息正文。仅在需要时才启用它;删除它不会删除已捕获的数据。
- 如果启用了滚动文件捕获,请单独关闭它。 macOS 覆盖不控制该接收器。