Console output
像现场广播喇叭。你盯着终端时，耳朵先听到的是这一面。
Gateway 导读
日志分两路：终端看什么，文件记什么，各自怎么调
这一页把日志拆成“控制台输出”和“文件日志”两条线，各自独立控制级别和格式。最该先看的是 `logging.file` 和 `logging.consoleLevel` 两个配置，一个管文件路径和级别，一个管终端啰嗦程度。容易搞错的是：敏感信息脱敏只影响控制台，不碰文件日志；文件日志默认在 `/tmp/openclaw/`，别去别处找。
先讲这一页到底在解决什么
日志分两路：终端看什么，文件记什么，各自怎么调
这一页把日志拆成“控制台输出”和“文件日志”两条线，各自独立控制级别和格式。最该先看的是 `logging.file` 和 `logging.consoleLevel` 两个配置，一个管文件路径和级别，一个管终端啰嗦程度。容易搞错的是：敏感信息脱敏只影响控制台，不碰文件日志；文件日志默认在 `/tmp/openclaw/`，别去别处找。
先分家
📣 控制台是现场广播，📦 文件日志是黑匣子
只要先把这两面分开，后面所有“为什么我明明开了 verbose 还是没写进文件”之类的问题就不绕了。
File logs
像黑匣子，按天一行一行地记在文件里，适合事后翻。
默认位置
官方默认把滚动日志放在 /tmp/openclaw/ 下面，每天一份。
一句话
一个给眼前看，一个给事后查。别把两本账混成一本。
最容易误会
🔊 --verbose 不是“全世界都更详细”，它只是把现场喇叭拧大声
官方这里说得非常直接，但很多人还是会误会。
--verbose像把现场广播喇叭音量调大，让你听到更多 WebSocket 来来回回的碎话。
logging.level像告诉黑匣子“你到底要记到多细”。如果不把它调到 debug 或 trace，文件里还是不会多出那些细碎细节。
两套旋钮
一个旋钮管现场喇叭，一个旋钮管黑匣子录音，别以为拧一个就全都变。
🎈 记一句
--verbose 是“我现在想多听点”，不是“以后文件自动全记下来”。
命令翻译
👀 这些查看动作，就像不同的看监控方式
你是在站在现场看，还是调回放，要用的动作不一样。
openclaw logs --follow像站在监控室里盯着屏幕，看新的日志一条条滚出来。不是翻旧档案，而是看“现在正在发生什么”。
openclaw gateway --verbose --ws-log compact像让前台接线员把每次来电和回电成对地念给你听，但尽量别啰嗦到一帧一帧都念。
openclaw gateway --verbose --ws-log full像你真的想看逐帧回放，于是把每一张小票都摊开检查。
Control UI Logs tab
像把黑匣子尾巴接到网页里，不用一直守终端也能看。
格式和样式
🎨 控制台样式、级别、子系统前缀，像“广播员穿什么衣服、用什么嗓门”
官方这里其实是在帮日志变得更容易扫读。
logging.consoleLevel
像决定广播员平时说多大声，哪些小声嘀咕要不要放出来。
pretty | compact | json
像决定广播稿是彩色读稿、紧凑播报，还是直接交机器看得懂的原始格式。
Subsystem prefixes
像每条广播前都先喊一句“我是 gateway 组”或“我是 tailscale 组”，免得你听半天不知道谁在说话。
TTY-aware colors
像在真终端里给不同广播员穿不同颜色马甲，更好扫。
敏感信息
🕶 Redaction 像“上镜前先给钥匙打码”
官方这里很谨慎：某些 verbose 工具摘要在去控制台前可以先打码，但这不等于文件日志也会一起改写。
logging.redactSensitive: tools像规定“工具台上拿出来晃的钥匙，先戴个墨镜再上镜”。
logging.redactPatterns像自己再补一张“哪些号码和票据上镜前必须遮住”的名单。
只影响 tools-only console stream
像只给直播画面打码，不是回头把原始胶片也抹掉。
⚠️ 记一句
控制台打码不等于黑匣子自动打码。查问题时别把这两件事混掉。
最后总结
🎈 把这页压成一句最短的话
Logging 就像 Gateway 的现场广播和黑匣子：--verbose 只会让你眼前听得更细，真正写进文件多少，要看 logging.level 这只黑匣子旋钮。
如果你想看“整座 Gateway 的网络和门路到底怎么布”，下一页就去 /gateway/network-model。