刚装好 OpenClaw 并在 macOS 上运行，你是不是也遇到过这种情况？服务启动半天了，终端却干干净净，什么输出都没有。别担心，这并不是程序卡死，而是 OpenClaw 默认不会向终端打印日志。所有关键运行状态都保存在后台文件或右上角的小图标里——你需要主动开启监控入口，而不是干等着它弹出提示。

先从最基础的问题说起：如何判断 OpenClaw 是否正常运行？

通过右上角菜单栏实时查看运行状态

OpenClaw Security Monitor（macOS 安全监控版）安装完成后，系统菜单栏右侧会出现一个龙虾图标。点击该图标，实时安全评分与运行摘要便会清晰展开。

面板顶部显示的是当前安全分数——0 到 100 的区间一目了然。下方按时间倒序排列着最近 5 条安全事件，例如：“检测到 launchd 新增持久化项”“/usr/bin/python3 进程异常高 CPU 占用”“网络连接突增至 47 个”。每条事件前带有 ⚠️ 或 ✅ 标识，⚠️ 表示需要人工确认的潜在风险，✅ 则表示已自动熔断并隔离了关联进程。

如果龙虾图标根本没有出现，请先确认你安装的是 openclaw-security-monitor-mac 这个版本——网关版不包含菜单栏组件。

定位本地日志文件路径

如果你使用的是 OpenClaw 网关版（即 AI 智能体网关），macOS 下的日志默认写入项目根目录 logs/ 中。但具体路径有两条，取决于你的启动方式：

通过 npm start 或 python main.py 启动时，日志位于执行命令所在目录下的 logs/；
通过 openclaw gateway CLI 命令全局启动时，路径由配置文件决定，默认为 ~/.openclaw/logs/。

这里有一个常见问题：macOS 的 Spotlight 不会索引隐藏目录，~/.openclaw 需要在 Finder 中按 Cmd+Shift+G 并输入路径手动跳转。

在终端中实时跟踪 error.log

找到日志目录后，如何实时监控 error.log？操作步骤如下：

打开终端，进入日志目录，例如 cd ~/.openclaw/logs；
执行 tail -f error.log，即可实时监听 ERROR 级别的日志输出；
如果发现日志尚未生成，可以先制造一些请求——用 curl 调用一个不存在的 endpoint，触发一次失败请求，error.log 便会自动创建并写入第一条记录；
观察输出内容：正常的日志会包含堆栈信息、模块名称（如 Gateway、Skill）以及时间戳。如果只有空白或提示“no such file”，说明你进入了错误的目录，或者服务没有写入权限。

使用 CLI 命令快速筛选日志

这里提供几个实用的日志过滤方法：

方法一：仅查看警告和错误
openclaw logs --level warn

方法二：导出 JSON 格式，通过 jq 提取失败任务
openclaw logs --json " jq 'select(.level == "ERROR" and .task_id != null)'

方法三：实时过滤并高亮 ERROR 行，适合长期挂起监控
tail -f error.log | grep --line-buffered -E "(ERROR|Traceback|Exception)"

以上命令无需额外安装工具，直接复制粘贴到终端执行即可。

通过 doctor 命令诊断日志异常

有时日志始终无法写入，路径检查无误，权限也已确认，但仍然没有输出。此时可以运行 openclaw doctor 执行系统健康诊断：

执行 openclaw doctor，检查输出中是否包含 ✗️ 标记项，例如：
✗️ log rotation misconfigured: logs/ directory not writable by current user

遇到这类阻断性错误时，直接运行 openclaw doctor --repair，它会自动修正权限与路径配置。修复完成后再次执行 tail -f logs/error.log，确认新日志开始持续写入即可。