跳转到主要内容

​
日志

有关面向用户的概述(CLI + Control UI + 配置),请参见 /zh/logging。 OpenClaw 有两个日志”表面”:
  • 控制台输出(您在终端/调试 UI 中看到的内容)。
  • 文件日志(JSON 行)由 gateway logger 写入。

​
基于文件的 logger

  • 默认滚动日志文件位于 /tmp/openclaw/ 下(每天一个文件):openclaw-YYYY-MM-DD.log
    • 日期使用 gateway 主机的本地时区。
  • 日志文件路径和级别可以通过 ~/.openclaw/openclaw.json 配置:
    • logging.file
    • logging.level
文件格式是每行一个 JSON 对象。 Control UI 日志选项卡通过 gateway 追踪此文件(logs.tail)。CLI 也可以这样做: 
openclaw logs --follow
Verbose vs. 日志级别
  • 文件日志仅由 logging.level 控制。
  • --verbose 仅影响控制台详细程度(和 WS 日志样式);它不会提高文件日志级别。
  • 要在文件日志中捕获仅 verbose 的详细信息,请将 logging.level 设置为 debug 或 trace。

​
控制台捕获

CLI 捕获 console.log/info/warn/error/debug/trace 并将它们写入文件日志,同时仍然打印到 stdout/stderr。 您可以通过以下方式独立调整控制台详细程度:
  • logging.consoleLevel(默认 info)
  • logging.consoleStyle(pretty | compact | json)

​
工具摘要脱敏

详细的工具摘要(例如 🛠️ Exec: ...)可以在进入控制台流之前屏蔽敏感令牌。这仅限工具,不会更改文件日志。
  • logging.redactSensitive:off | tools(默认:tools)
  • logging.redactPatterns:正则表达式字符串数组(覆盖默认值)
    • 使用原始正则表达式字符串(自动 gi),或如果需要自定义标志则使用 /pattern/flags。
    • 匹配项通过保留前 6 + 后 4 个字符(长度 >= 18)进行屏蔽,否则为 ***。
    • 默认值涵盖常见的密钥赋值、CLI 标志、JSON 字段、bearer 标头、PEM 块和流行的令牌前缀。

​
Gateway WebSocket 日志

Gateway 以两种模式打印 WebSocket 协议日志:
  • 正常模式(无 --verbose):仅打印”有趣的” RPC 结果:
    • 错误(ok=false)
    • 慢调用(默认阈值:>= 50ms)
    • 解析错误
  • Verbose 模式(--verbose):打印所有 WS 请求/响应流量。

​
WS 日志样式

openclaw gateway 支持每个 gateway 的样式开关:
  • --ws-log auto(默认):正常模式已优化;verbose 模式使用紧凑输出
  • --ws-log compact:verbose 时紧凑输出(配对的请求/响应)
  • --ws-log full:verbose 时完整的每帧输出
  • --compact:--ws-log compact 的别名
示例: 
# 优化(仅错误/慢)
openclaw gateway

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

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

​
控制台格式化(子系统日志)

控制台格式化器是 TTY 感知的,并打印一致的、带前缀的行。子系统 loggers 保持输出分组和可扫描。 行为:
  • 每行上的子系统前缀(例如 [gateway]、[canvas]、[tailscale])
  • 子系统颜色(每个子系统稳定)加上级别着色
  • 当输出是 TTY 或环境看起来像富终端时着色(TERM/COLORTERM/TERM_PROGRAM),尊重 NO_COLOR
  • 缩短的子系统前缀:删除前导 gateway/ + channels/,保留最后 2 个段(例如 whatsapp/outbound)
  • 按子系统的子 loggers(自动前缀 + 结构化字段 { subsystem })
  • logRaw() 用于 QR/UX 输出(无前缀,无格式化)
  • 控制台样式(例如 pretty | compact | json)
  • 控制台日志级别与文件日志级别分开(当 logging.level 设置为 debug/trace 时,文件保留完整细节)
  • WhatsApp 消息正文在 debug 级别记录(使用 --verbose 查看它们)
这使现有的文件日志保持稳定,同时使交互式输出可扫描。