首页
开始 安装引导快速开始文档总览
文档 渠道接入模型与 APIGateway 运维Tools 与 Skills
更多 精选文章资源导航帮助中心
开始安装
文档导航 Gateway 运维
Gateway 运维 3 个部分

Logging

日志

OpenClaw 有两套日志面:一套是你在终端 / Debug UI 看到的控制台输出,另一套是 Gateway 写到磁盘上的 JSONL 文件日志。调试时最常见的误解是把 --verbose 当成了“提高文件日志等级”。

日志面

控制台输出:终端 / Debug UI 中看到的内容,受 logging.consoleLevellogging.consoleStyle 控制。

文件日志:默认位于 /tmp/openclaw/,按天滚动,格式是每行一个 JSON 对象。

openclaw logs --follow 与 Control UI 的 Logs 标签页,本质上都是在追这份文件日志。

常见设置

跟踪日志

openclaw logs --follow

WS 日志样式

openclaw gateway --verbose --ws-log compact
openclaw gateway --verbose --ws-log full

常见误解

--verbose 会提高文件日志等级吗

不会。--verbose 只提高控制台详细度;真正决定文件日志内容的是 logging.level

敏感 token 会不会出现在工具摘要里

默认会启用 logging.redactSensitive: "tools",专门对工具摘要里的常见敏感串做遮罩。