诊断标志允许针对特定子系统启用调试日志,无需提升全局日志级别。标志为字符串,大小写不敏感,支持通配符。
启用方式
通过 Config:
{
"diagnostics": {
"flags": ["telegram.http", "brave.http", "gateway.*"]
}
}修改后重启 Gateway 生效。
通过环境变量(一次性):
OPENCLAW_DIAGNOSTICS=telegram.http,telegram.payload
# 禁用所有标志:
OPENCLAW_DIAGNOSTICS=0Timeline 产物
timeline 标志写入结构化启动和运行时计时事件:
OPENCLAW_DIAGNOSTICS=timeline \
OPENCLAW_DIAGNOSTICS_TIMELINE_PATH=/tmp/openclaw-timeline.jsonl \
openclaw gateway runTimeline 记录使用 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,这些日志可能被抑制