QClaw 终端openclaw logs命令实时监控教程:操作

openclaw logs命令支持实时流式日志输出，含--follow持续滚动、--level过滤级别、--json结构化导出、--module按模块筛选及--list-modules查看模块列表，全部纯命令行操作。

你想在终端里实时看到QClaw（即OpenClaw）正在干啥、卡在哪、报了什么错，而不是等它彻底挂了再翻日志文件——这时候用openclaw logs命令最直接，不用开浏览器、不依赖微信、不碰配置文件，纯命令行流式输出，秒级响应。

基础实时监控：持续滚动最新日志

这一步操作起来很简单，直接在终端里敲命令就行，适合刚部署完想确认服务有没有真正跑起来。

1、打开终端（Linux/macOS）或 PowerShell（Windows），确保已添加openclaw到系统PATH，或切换至安装目录执行。

2、运行命令：openclaw logs --follow。

3、终端将开始持续输出新日志，每条含时间戳、模块名（如gateway、agent）、日志等级（INFO/WARN/ERROR）和具体消息。若服务刚启动，你会立刻看到Gateway listening on :18789这类关键行。

4、按 Ctrl+C 可随时中断输出，返回命令提示符——别误以为要等它自己停，它不会自动结束。

聚焦问题：只看警告与错误日志

当QClaw运行一段时间后，INFO级日志刷屏严重，人工扫一眼根本找不到异常线索，这时候必须过滤掉噪音。

方法一：只显示WARN及以上级别日志
执行：openclaw logs --level warn。这条命令会跳过所有INFO，只保留WARN和ERROR，大幅压缩信息量。

方法二：精准锁定ERROR
执行：openclaw logs --level error。这比--level warn更激进，连WARN都过滤掉，只剩真正的崩溃信号——比如panic: failed to load model或connection refused这种致命错误。

注意：--level参数必须紧接logs子命令，写成openclaw --level error logs会报错且无输出。

结构化导出：JSON格式日志用于分析

如果你后续要用脚本解析、做告警规则、或者把日志喂给ELK，那原始文本格式太难处理，必须转成JSON。

1、先停止当前正在运行的openclaw logs --follow进程（如果有），避免端口冲突或重复读取。

2、执行命令：openclaw logs --json。输出是标准JSON数组，每条日志为一个对象，字段包括time、level、module、msg、trace_id等。

3、配合jq工具提取特定内容，例如只看ERROR并高亮消息体：
openclaw logs --json | jq -r 'select(.level == "ERROR") | "(.time) (.module): (.msg)"'。

这一步不需要提前安装jq，但如果没有，openclaw logs --json仍能正常输出原始JSON，只是没法做字段筛选。

按模块筛选日志流

OpenClaw由Gateway、Agent、Skills多个组件协同工作，不同模块出问题时表现差异很大——比如Gateway挂了就打不开网页控制台，Agent挂了则任务完全不动。按模块切片排查，效率翻倍。

第一步：列出所有可用模块
执行：openclaw logs --list-modules。输出类似gateway, agent, memory, skill.http, skill.wechat。

第二步：盯住某一个模块的实时日志
例如只看微信通道是否连通：openclaw logs --module skill.wechat --follow。

第三步：组合过滤，定位复合问题
比如发现微信收不到消息，同时Agent日志里有模型调用超时，可并行观察：
新开一个终端，执行：openclaw logs --module agent --level error --follow。

【模块名必须完全匹配--list-modules输出结果，大小写敏感，多词模块名不含空格】