诊断标志

诊断标志允许您启用定向调试日志,而无需在所有地方打开详细日志记录。标志是可选的,除非子系统检查它们,否则不会产生任何效果。

工作原理

json

{
  "diagnostics": {
    "flags": ["telegram.http"]
  }
}

多个标志:

json

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

更改标志后需重启网关。

bash

OPENCLAW_DIAGNOSTICS=telegram.http,telegram.payload

禁用所有标志:

bash

OPENCLAW_DIAGNOSTICS=0

标志将日志发送到标准诊断日志文件。默认位置:

/tmp/openclaw/openclaw-YYYY-MM-DD.log

如果您设置了 logging.file,请改用该路径。日志为 JSONL 格式(每行一个 JSON 对象)。脱敏处理仍基于 logging.redactSensitive 应用。

选择最新的日志文件:

bash

ls -t /tmp/openclaw/openclaw-*.log | head -n 1

过滤 Telegram HTTP 诊断信息:

bash

rg "telegram http error" /tmp/openclaw/openclaw-*.log

或在重现问题时实时查看:

bash

tail -f /tmp/openclaw/openclaw-$(date +%F).log | rg "telegram http error"

对于远程网关,您也可以使用 openclaw logs --follow(参见 /cli/logs)。