诊断标志允许针对特定子系统启用调试日志,无需提升全局日志级别。标志为字符串,大小写不敏感,支持通配符。

启用方式

通过 Config:

{
  "diagnostics": {
    "flags": ["telegram.http", "brave.http", "gateway.*"]
  }
}

修改后重启 Gateway 生效。

通过环境变量(一次性):

OPENCLAW_DIAGNOSTICS=telegram.http,telegram.payload
# 禁用所有标志:
OPENCLAW_DIAGNOSTICS=0

Timeline 产物

timeline 标志写入结构化启动和运行时计时事件:

OPENCLAW_DIAGNOSTICS=timeline \
OPENCLAW_DIAGNOSTICS_TIMELINE_PATH=/tmp/openclaw-timeline.jsonl \
openclaw gateway run

Timeline 记录使用 openclaw.diagnostics.v1 信封,包含进程 ID、阶段名、span 名、持续时间、插件 ID 等。

日志位置

默认:/tmp/openclaw/openclaw-YYYY-MM-DD.log(JSONL 格式)

# 查看最新日志文件
ls -t /tmp/openclaw/openclaw-*.log | head -n 1
 
# 实时过滤
tail -f /tmp/openclaw/openclaw-$(date +%F).log | rg "telegram http error"

注意事项

  • brave.http 记录请求 URL/查询参数、响应状态/耗时,不记录 API key 或响应体,但搜索查询可能敏感
  • 标志可安全保持启用,仅影响特定子系统的日志量
  • 如果 logging.level 高于 warn,这些日志可能被抑制

相关页面