日志

• ✦控制台输出（你在终端 / Debug UI 中看到的内容）。
• ✦文件日志（JSON 行）由 Gateway 网关日志记录器写入。

基于文件的日志记录器

• ✦默认滚动日志文件位于 /tmp/openclaw/ 下（每天一个文件）：openclaw-YYYY-MM-DD.log
  • ✦日期使用 Gateway 网关主机的本地时区。
• ✦日志文件路径和级别可以通过 ~/.openclaw/openclaw.json 配置：
  • ✦logging.file
  • ✦logging.level

bash
openclaw logs --follow

• ✦文件日志完全由 logging.level 控制。
• ✦--verbose 仅影响控制台详细程度（和 WS 日志样式）；它不会提高文件日志级别。
• ✦要在文件日志中捕获仅 verbose 的详细信息，请将 logging.level 设置为 debug 或 trace。

控制台捕获

• ✦logging.consoleLevel（默认 info）
• ✦logging.consoleStyle（pretty | compact | json）

工具摘要脱敏

• ✦logging.redactSensitive：off | tools（默认：tools）
• ✦logging.redactPatterns：正则表达式字符串数组（覆盖默认值）
  • ✦使用原始正则字符串（自动 gi），或如果你需要自定义标志则使用 /pattern/flags。
  • ✦匹配项通过保留前 6 个 + 后 4 个字符（长度 >= 18）来屏蔽，否则为 ***。
  • ✦默认值涵盖常见的键赋值、CLI 标志、JSON 字段、bearer 头、PEM 块和流行的令牌前缀。

Gateway 网关 WebSocket 日志

• ✦普通模式（无 --verbose）：仅打印"有趣的"RPC 结果：
  • ✦错误（ok=false）
  • ✦慢调用（默认阈值：>= 50ms）
  • ✦解析错误
• ✦详细模式（--verbose）：打印所有 WS 请求/响应流量。

WS 日志样式

• ✦--ws-log auto（默认）：普通模式已优化；详细模式使用紧凑输出
• ✦--ws-log compact：详细时使用紧凑输出（配对的请求/响应）
• ✦--ws-log full：详细时使用完整的每帧输出
• ✦--compact：--ws-log compact 的别名

bash
# 优化的（仅错误/慢调用）
openclaw gateway

# 显示所有 WS 流量（配对）
openclaw gateway --verbose --ws-log compact

# 显示所有 WS 流量（完整元数据）
openclaw gateway --verbose --ws-log full

控制台格式化（子系统日志）

• ✦每行都有子系统前缀（例如 [gateway]、[canvas]、[tailscale]）
• ✦子系统颜色（每个子系统稳定）加上级别着色
• ✦当输出是 TTY 或环境看起来像富终端时着色（TERM/COLORTERM/TERM_PROGRAM），遵守 NO_COLOR
• ✦缩短的子系统前缀：删除前导 gateway/ + channels/，保留最后 2 个段（例如 whatsapp/outbound）
• ✦按子系统的子日志记录器（自动前缀 + 结构化字段 { subsystem }）
• ✦logRaw() 用于 QR/UX 输出（无前缀，无格式化）
• ✦控制台样式（例如 pretty | compact | json）
• ✦控制台日志级别与文件日志级别分开（当 logging.level 设置为 debug/trace 时，文件保留完整详情）
• ✦WhatsApp 消息正文以 debug 级别记录（使用 --verbose 查看它们）