创见博客
openclaw的日志查看
七崽爱吃小饼干2026/06/04阅读 3

一、核心日志命令（Gateway网关主日志，最常用）

bash
# 1.查看最近200行日志（默认limit=200）
openclaw logs

# 2.实时滚动日志（tail -f，Ctrl+C退出）【日常调试首选】
openclaw logs --follow

# 3.自定义读取最近500行再实时跟踪
openclaw logs --follow --limit 500

常用筛选参数组合

bash
# 只看错误日志 error/warn/info/debug/trace
openclaw logs --follow --level error

# 查看近1小时日志
openclaw logs --follow --last 1h

# JSON结构化输出（配合jq筛选）
openclaw logs --follow --json

# 关闭颜色、纯文本输出
openclaw logs --follow --plain --no-color

# 本地时区时间
openclaw logs --follow --local-time

二、渠道/插件单独日志（登录、IM通道报错）

bash
# 单个channel日志（lark/telegram等）
openclaw channels logs --channel lark --follow

三、前台启动Gateway，终端直接打印实时日志（最高verbose）

bash
# 前台运行，日志全量输出在终端
openclaw gateway --verbose
# trace全量调试日志
openclaw gateway --verbose --log-level trace

四、日志文件物理路径（mac三个日志目录）

  1. 网关滚动日志（按日期）：/tmp/openclaw/openclaw-YYYY-MM-DD.log
bash
# 直接原生tail文件
tail -f /tmp/openclaw/openclaw-$(date +%Y-%m-%d).log
  1. launchd服务启停日志：~/.openclaw/logs/gateway.log、~/.openclaw/logs/gateway.err.log
bash
tail -f ~/.openclaw/logs/gateway.log
  1. mac客户端APP诊断日志（需手动开启）：~/Library/Logs/OpenClaw/diagnostics.jsonl

五、修改全局日志等级（永久开启debug/trace）

编辑配置 ~/.openclaw/openclaw.json

json
{
  "logging": {
    "level": "trace" // info(default)/warn/error/debug/trace
  }
}

改完重启网关：

bash
openclaw gateway restart

六、快捷排查命令

bash
# 健康自检+日志报错汇总
openclaw doctor

# 查看网关运行状态
openclaw gateway status
评论
0/100