OpenClaw macOS日志查看：右上角入口与实时监控
初次在 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，确认新日志持续写入即可。