macOS Logging

OpenClaw 在苹果电脑上，平时会把它的“悄悄话”（我们叫它“日志”）用一种统一的方式小声说。但当你需要仔细听它说什么来找问题时，你可以让它把话写在一个本地的文件里。

第一部分：打开一个会转圈圈的日志文件

你可以把它想成一个会自动换页的日记本，写满一页就开新的一页，旧的会标上数字收好。

1. 要做什么：先告诉软件，你想听多详细的话。

   • 怎么做：在软件的 Debug pane（调试面板）里，找到 Logs（日志），再点 App logging（应用日志），然后调整 Verbosity（详细程度）这个选项。

2. 要做什么：打开那个会自己转圈圈的日记本。

   • 怎么做：还是在 App logging 那里，找到并打开 “Write rolling diagnostics log (JSONL)”（写入滚动诊断日志）这个开关。

3. 要做什么：知道日记本放在哪里了。

   • 怎么做：日记本文件叫 diagnostics.jsonl，放在你电脑的 ~/Library/Logs/OpenClaw/ 这个文件夹里。旧的日记本会加上 .1、.2 这样的数字尾巴。

4. 要做什么：把日记本擦干净（清空）。

   • 怎么做：在 App logging 那里，点一下 “Clear”（清除）按钮就可以了。

这里要小心哦：

• 这个日记本功能默认是关着的，只有在你需要找问题时才打开它。
• 日记本里可能写了些小秘密，所以不要没检查就把它发给别人看。

第二部分：让日志说出更多秘密

苹果电脑的“统一日志”系统，为了保护你的隐私，会自动把一些重要信息（比如电话号码、聊天内容）藏起来，变成“***”。为了让 OpenClaw 在日志里说出这些秘密，我们需要给它一个特别的“许可证”。

1. 要做什么：制作一张“许可证”（一个叫 plist 的配置文件），告诉系统允许 OpenClaw（它的代号是 ai.openclaw）说出秘密。

   • 怎么做：我们需要在电脑的终端（一个可以打字给电脑下命令的地方）里，输入一段长长的命令。这段命令会先创建一个临时文件，然后把文件放到正确的位置。因为要放到系统的重要文件夹，所以需要 sudo（超级用户）权限，就像需要大人密码才能进某些房间一样。你只要把原文里从 cat <<'EOF' >/tmp/ai.openclaw.plist 开始，到 EOF 结束，再到最后那行 sudo install... 的命令，完整地复制粘贴到终端里执行就可以了。

2. 要做什么：看看日志是不是开始说秘密了。

   • 怎么做：放好“许可证”后，不需要重启电脑。你可以用 OpenClaw 自带的一个小帮手脚本（比如 ./scripts/clawlog.sh --category WebChat --last 5m）来查看最近5分钟更详细的日志。

这里要小心哦：

• 这张“许可证”只对放好之后新写的日志有效。所以，记得要在你重现问题之前就把它放好。
• 日志里现在可能包含电话号码和消息内容了，这些都是私人信息。

第三部分：用完以后要记得关掉

问题解决后，记得把“许可证”收走，保护隐私。

1. 要做什么：把“许可证”文件删掉。

   • 怎么做：在终端里输入命令：sudo rm /Library/Preferences/Logging/Subsystems/ai.openclaw.plist

2. 要做什么：（可选）立刻告诉系统“许可证”没了。

   • 怎么做：在终端里输入命令：sudo log config --reload。这样系统会马上知道变化。

记住啦：这个能让日志说秘密的功能，只在真正需要详细检查问题时才打开，用完了要记得关掉哦！