OpenClaw 日志与调试配置

日志配置

在 openclaw.json 中通过 logging 字段配置日志行为：

{
  logging: {
    level: "info",                // 日志级别
    file: "/tmp/openclaw/openclaw.log",  // 日志文件路径
    consoleLevel: "info",         // 控制台输出级别
    consoleStyle: "pretty",       // 控制台样式
    redactSensitive: "tools"      // 敏感信息脱敏范围
  }
}

参数说明

level：日志级别，可选 debug、info、warn、error
file：日志文件保存路径，留空则不写文件
consoleLevel：控制台输出的日志级别，可独立于文件级别
consoleStyle：控制台输出格式，pretty 为带颜色的可读格式
redactSensitive：敏感信息脱敏，tools 表示在工具调用日志中隐藏 API Key 等敏感数据

常用调试场景

模型请求调试

将日志级别设为 debug 可以看到发送给模型的完整请求和响应：

{
  logging: {
    level: "debug",
    consoleLevel: "debug"
  }
}

频道连接排查

如果某个频道连接异常，可以只调高特定日志：

openclaw gateway --log-level debug

生产环境推荐

{
  logging: {
    level: "warn",
    file: "~/.openclaw/logs/openclaw.log",
    consoleLevel: "info",
    consoleStyle: "pretty",
    redactSensitive: "tools"
  }
}

生产环境建议：

文件级别设为 warn 或 info，减少磁盘占用
控制台保持 info 方便实时观察
务必启用 redactSensitive 防止 Key 泄露到日志

环境变量调试

检查 OpenClaw 实际加载了哪些环境变量：

openclaw doctor

doctor 命令会检查配置文件、环境变量、模型连接等状态，输出诊断报告。