诊断标志

诊断标志允许您启用针对特定目标的调试日志，而无需到处开启详细日志记录。标志是可选项，除非子系统检查它们，否则不会生效。

工作原理

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

多个标志：

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

更改标志后请重启网关。

OPENCLAW_DIAGNOSTICS=telegram.http,telegram.payload

禁用所有标志：

OPENCLAW_DIAGNOSTICS=0

标志会将日志输出到标准诊断日志文件中。默认情况下：

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

如果您设置了 logging.file，则改为使用该路径。日志采用 JSONL 格式（每行一个 JSON 对象）。根据 logging.redactSensitive 进行的编辑仍会生效。

选择最新的日志文件：

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

筛选 Telegram HTTP 诊断信息：

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

或者在重现问题时跟踪日志：

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

对于远程网关，您也可以使用 openclaw logs --follow（请参阅 /cli/logs）。