诊断标志

诊断标志让你可以启用定向调试日志，而无需在所有地方开启详细日志。标志是可选启用的，除非子系统检查它们，否则不会生效。

工作原理

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

多个标志：

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

更改标志后重启 Gateway 网关。

CODERCLAW_DIAGNOSTICS=telegram.http,telegram.payload

禁用所有标志：

CODERCLAW_DIAGNOSTICS=0

标志将日志输出到标准诊断日志文件。默认位置：

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

如果你设置了 logging.file，则使用该路径。日志为 JSONL 格式（每行一个 JSON 对象）。脱敏仍然根据 logging.redactSensitive 应用。

选择最新的日志文件：

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

过滤 Telegram HTTP 诊断：

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

或在复现时使用 tail：

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

对于远程 Gateway 网关，你也可以使用 coderclaw logs --follow（参见 /cli/logs）。