日志记录（macOS）

适用范围

在以下情况使用此页面：

• 捕获 macOS 日志或调查私人数据日志记录
• 调试语音唤醒/会话生命周期问题

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

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

• 详细程度：调试窗格 → 日志 → 应用日志记录 → 详细程度
• 启用：调试窗格 → 日志 → 应用日志记录 →“写入滚动诊断日志（JSONL）”
• 位置：~/Library/Logs/Clawdbot/diagnostics.jsonl（自动旋转；旧文件后缀为 .1、.2、…）
• 清除：调试窗格 → 日志 → 应用日志记录 →“清除”

注意事项：

• 这默认关闭。仅在主动调试时启用。
• 将文件视为敏感；未经审查不要共享。

macOS 上的统一日志私人数据

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

为 Clawdbot 启用（com.clawdbot）

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

cat <<'EOF' >/tmp/com.clawdbot.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/com.clawdbot.plist /Library/Preferences/Logging/Subsystems/com.clawdbot.plist

• 无需重启；logd 会快速注意到文件，但只有新的日志行将包含私人负载。
• 使用现有的帮助程序查看更丰富的输出，例如 ./scripts/clawlog.sh --category WebChat --last 5m。

调试后禁用

• 删除覆盖：sudo rm /Library/Preferences/Logging/Subsystems/com.clawdbot.plist。
• 可选地运行 sudo log config --reload 以强制 logd 立即删除覆盖。
• 请记住，此表面可以包括电话号码和消息正文；仅在你主动需要额外详细信息时保留 plist。