Gateway 日志配置

OpenClaw 有两个日志输出面：控制台输出（终端/Debug UI）和文件日志（JSON lines）。

文件日志

• 默认路径：/tmp/openclaw/openclaw-YYYY-MM-DD.log（按天滚动）
• 滚动阈值：logging.maxFileBytes（默认 100MB），保留最多 5 个归档
• 格式：每行一个 JSON 对象

配置项：

{
  logging: {
    file: "/custom/path/openclaw.log",
    level: "info",  // debug | trace | info | warn | error
    consoleLevel: "info",
    consoleStyle: "pretty",  // pretty | compact | json
  }
}

查看日志：

openclaw logs --follow

日志级别说明

• --verbose 只影响控制台详细度，不提升文件日志级别
• 要在文件日志中捕获 verbose 详情，需设置 logging.level: "debug" 或 "trace"
• Trace 级别包含热路径的诊断时序摘要

敏感信息脱敏

{
  logging: {
    redactSensitive: "tools",  // off | tools（默认）
    redactPatterns: ["regex1", "regex2"],  // 自定义脱敏正则
  }
}

脱敏规则：

• 匹配长度 ≥ 18 时保留前 6 + 后 4 字符，否则替换为 ***
• 默认覆盖：常见 key 赋值、CLI 参数、JSON 字段、Bearer header、PEM 块、常见 token 前缀、支付凭证字段

某些安全边界始终脱敏，不受 redactSensitive: "off" 影响：Control UI 工具调用事件、sessions_history 工具输出、诊断导出等。

Gateway WebSocket 日志

openclaw gateway                              # 仅错误/慢调用（>= 50ms）
openclaw gateway --verbose --ws-log compact   # 所有 WS 流量（配对格式）
openclaw gateway --verbose --ws-log full      # 所有 WS 流量（完整元数据）

--ws-log 选项：auto（默认）、compact、full

控制台格式

• 每行带子系统前缀（如 [gateway]、[canvas]、[tailscale]）
• 子系统颜色稳定，支持 NO_COLOR
• 前缀简化：去掉 gateway/ + channels/，保留最后 2 段
• WhatsApp 消息体在 debug 级别记录（需 --verbose 查看）

相关链接

• gateway-opentelemetry — OpenTelemetry 导出
• gateway-diagnostics — 诊断导出