很多人遇到 OpenClaw 问题时，第一反应是到处搜报错关键词，但其实最高效的做法往往是：先看日志。
OpenClaw 官方文档把日志系统拆得很清楚：Gateway 日志、Node 日志、Channel 日志、审计日志，每种日志看的地方和用法都不一样。如果你不知道现在该看哪一层，很容易在错误的方向上浪费时间。
这篇文章的目标就是帮你建立正确的日志排查思维：什么时候看哪层日志、用什么命令、关注哪些关键词、怎么从日志里定位真正的问题。
本文侧重点：OpenClaw 日志的分层查看方法与实战排查技巧。涵盖 Gateway、Node、Channel、审计日志的查看方式与关键词解读。如果你尚未完成基础安装，请先阅读 OpenClaw 安装失败怎么办？从环境到权限的完整排查；如果遇到报错需要分类定位，请参考 OpenClaw 常见报错总表：安装、模型、审批、权限一次看懂。
一、先理解日志分层：OpenClaw 的日志不是一锅粥
OpenClaw 官方架构里，日志至少分这几层：
| 日志类型 | 记录内容 | 查看方式 | |---------|---------|---------| | Gateway 日志 | Gateway 启动、运行、错误、RPC 通信 | openclaw logs --follow | | Node 日志 | Node 连接、命令执行、权限请求 | openclaw nodes logs --node <id> | | Channel 日志 | 渠道连接、消息收发、认证状态 | openclaw channels logs | | 审计日志 | 审批请求、安全事件、配置变更 | openclaw logs --audit | | 系统日志 | systemd/launchd 服务日志 | journalctl -u openclaw / log stream |
这意味着什么？
意味着你排查问题时，要先判断问题大概发生在哪一层，再去看对应的日志。而不是一上来就 grep 所有日志。
二、Gateway 日志：最常用的一层
基础查看命令
# 实时查看 Gateway 日志
openclaw logs --follow
# 查看最近 100 行
openclaw logs --lines 100
# 查看特定时间段
openclaw logs --since 1h
Gateway 日志关键信息
Gateway 日志通常包含：
- 启动信息：Gateway 版本、配置加载、端口绑定
- RPC 通信：Gateway 与 CLI、Node、Channel 的通信
- 错误信息：启动失败、配置错误、运行时异常
- 审计事件：审批请求、安全策略触发
常见关键词与含义
| 关键词 | 含义 | 排查方向 | |-------|------|---------| | Runtime: running | Gateway 正常运行 | 健康信号 | | RPC probe ok | RPC 通信正常 | 健康信号 | | bind: address already in use | 端口被占用 | 检查其他进程占用端口 | | config validation failed | 配置格式错误 | 检查 openclaw.json 语法 | | authentication failed | 认证失败 | 检查 API key 和 provider 配置 | | approval required | 审批策略拦截 | 检查 approvals 配置 |
三、Node 日志：工具调用失败时必看
查看 Node 日志
# 查看所有 Node 状态
openclaw nodes status
# 查看特定 Node 日志
openclaw nodes logs --node <node-id>
# 查看 Node 详细信息
openclaw nodes describe --node <node-id>
Node 日志关键信息
Node 日志通常包含：
- 连接信息：Node 与 Gateway 的连接、断开、重连
- 能力声明：Node 声明的 capabilities
- 命令执行：system.run、camera.、screen. 等命令的执行
- 权限请求：向 Gateway 申请执行权限
常见场景
场景 1：system.run 命令被拒绝
日志里会看到：
SYSTEM_RUN_DENIED: command requires approval
这意味着 exec approvals 策略拦截了命令执行。需要检查：
openclaw approvals get --node <node-id>
关于审批机制的详细说明，请参考 OpenClaw 审批机制全解：allow-once、allow-always、deny 到底该怎么选？。
场景 2：Node 显示 connected 但命令不响应
检查 Node 是否正确声明了对应 capability：
openclaw nodes describe --node <node-id> | grep capabilities
四、Channel 日志：消息问题必看
查看 Channel 日志
# 查看渠道状态
openclaw channels status --probe
# 查看渠道日志
openclaw channels logs
Channel 日志关键信息
- 连接状态：渠道账号是否在线
- 消息收发：消息是否到达 Gateway
- 认证状态：渠道 API key 是否有效
- 路由信息：消息被路由到哪个 Agent
常见场景
场景：消息发出去没反应
排查顺序：
# 1. 检查渠道是否在线
openclaw channels status --probe
# 2. 检查消息是否到达 Gateway
openclaw logs --follow | grep channel
# 3. 检查路由是否正确
openclaw agents list --bindings
如果是多 Agent 路由问题，请参考 OpenClaw 多 Agent 通信失败怎么办？消息路由、角色配置与上下文隔离排查。
五、审计日志：安全与合规
查看审计日志
# 查看审计日志
openclaw logs --audit
# 查看特定类型的审计事件
openclaw logs --audit --type approval
审计日志包含什么
- 审批请求：谁请求执行什么命令、结果如何
- 配置变更：谁修改了什么配置
- 安全事件：权限被拒绝、异常访问等
六、系统日志：Gateway 起不来时必看
macOS
# 查看 OpenClaw 服务日志
log stream --predicate 'process == "openclaw"'
# 或查看系统日志
log show --predicate 'process == "openclaw"' --last 1h
Linux (systemd)
# 查看 OpenClaw 服务日志
journalctl -u openclaw --follow
# 查看最近 100 行
journalctl -u openclaw -n 100
什么时候看系统日志
- Gateway 完全起不来
- 怀疑是系统级问题（端口、权限、资源）
- 需要查看 Gateway 启动前的日志
七、实战排查流程
通用排查顺序
遇到问题 → 判断问题类型
→ 安装问题 → 看 Gateway 日志 + 系统日志
→ 模型问题 → 看 Gateway 日志 + 运行 models status --probe
→ 工具问题 → 看 Node 日志 + approvals
→ 消息问题 → 看 Channel 日志 + Gateway 日志
→ 安全问题 → 看审计日志 + approvals
快速诊断命令组合
# 组合 1：基础健康检查
openclaw status
openclaw gateway status
openclaw doctor
# 组合 2：模型问题排查
openclaw models status
openclaw models status --probe
openclaw logs --follow | grep -i model
# 组合 3：Node 问题排查
openclaw nodes status
openclaw nodes describe --node <id>
openclaw approvals get --node <id>
# 组合 4：Channel 问题排查
openclaw channels status --probe
openclaw agents list --bindings
openclaw logs --follow | grep -i channel
八、日志关键词速查表
| 关键词 | 问题类型 | 排查方向 | |-------|---------|---------| | bind: address already in use | 端口冲突 | 检查端口占用 | | connection refused | 连接失败 | 检查服务是否运行 | | timeout | 超时 | 检查网络/provider | | authentication failed | 认证失败 | 检查 API key | | rate limit | 限流 | 降低请求频率 | | approval required | 审批拦截 | 检查 approvals 配置 | | capability not found | 能力缺失 | 检查 Node capabilities | | routing failed | 路由失败 | 检查 bindings 配置 | | session not found | 会话丢失 | 检查 session 配置 |
九、结语：日志是排障的望远镜
OpenClaw 的分层日志设计，本质上是在帮你快速定位问题发生在哪个环节。
真正高效的排障，不是记住所有报错，而是：
- 快速判断问题类型
- 选择正确的日志层查看
- 从日志中提取关键信息
- 结合官方文档定位根因
只要你建立起分层查看日志的思维，绝大多数问题都能在十分钟内找到方向。
延伸阅读
- OpenClaw 安装失败怎么办？从环境到权限的完整排查 - 安装问题深度排查
- OpenClaw 常见报错总表：安装、模型、审批、权限一次看懂 - 报错分类与快速定位
- OpenClaw provider 配置指南：OpenAI、Anthropic、OpenRouter 到底怎么接 - provider 认证配置
- OpenClaw 多 Agent 通信失败怎么办？消息路由、角色配置与上下文隔离排查 - 多 Agent 场景排障
- OpenClaw 审批机制全解：allow-once、allow-always、deny 到底该怎么选？ - 审批机制详解
问题求助
没能解决你的问题？直接问我
如果你遇到任何技术问题无法解决，可以在这里提交求助。我会尽快查看并回复你。
支持作者
如果这篇文章帮到了你，可以支持我
扫码打赏，支持我持续更新原创排障文章。
