跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

诊断标志允许你启用有针对性的调试日志，而不必在所有地方开启详细日志。标志是选择性启用的，除非某个子系统检查它们，否则不会产生任何影响。

​
工作原理

  • 标志是字符串（不区分大小写）。
  • 你可以在配置中启用标志，也可以通过环境变量覆盖启用。
  • 支持通配符：
    • telegram.* 匹配 telegram.http
    • * 启用所有标志

​
通过配置启用

{
  "diagnostics": {
    "flags": ["telegram.http"]
  }
}
多个标志： 
{
  "diagnostics": {
    "flags": ["telegram.http", "brave.http", "gateway.*"]
  }
}
更改标志后重启 Gateway 网关。

​
环境变量覆盖（一次性）

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

​
时间线构件

timeline 标志会为外部 QA harness 写入结构化的启动和运行时计时事件： 
OPENCLAW_DIAGNOSTICS=timeline \
OPENCLAW_DIAGNOSTICS_TIMELINE_PATH=/tmp/openclaw-timeline.jsonl \
openclaw gateway run
你也可以在配置中启用它： 
{
  "diagnostics": {
    "flags": ["timeline"]
  }
}
时间线文件路径仍然来自 OPENCLAW_DIAGNOSTICS_TIMELINE_PATH。当 timeline 仅从配置中启用时，最早的配置加载 span 不会被发出，因为 OpenClaw 尚未读取配置；后续启动 span 会使用配置标志。 OPENCLAW_DIAGNOSTICS=1、OPENCLAW_DIAGNOSTICS=all 和 OPENCLAW_DIAGNOSTICS=* 也会启用时间线，因为它们会启用所有诊断标志。当你只需要 JSONL 计时构件时，优先使用 timeline。 时间线记录使用 openclaw.diagnostics.v1 信封。事件可以包含进程 ID、阶段名称、span 名称、持续时间、插件 ID、依赖项数量、事件循环延迟样本、提供商操作名称、子进程退出状态，以及启动错误名称/消息。将时间线文件视为本地诊断构件；在分享给你的机器外部之前，请先审阅它们。

​
日志位置

标志会将日志发出到标准诊断日志文件。默认情况下： 
/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
筛选 Brave Search HTTP 诊断： 
rg "brave http" /tmp/openclaw/openclaw-*.log
或在复现时跟踪： 
tail -f /tmp/openclaw/openclaw-$(date +%F).log | rg "telegram http error"
对于远程 Gateway 网关，你也可以使用 openclaw logs --follow（参见 /cli/logs）。

​
注意事项

  • 如果 logging.level 设置得高于 warn，这些日志可能会被抑制。默认的 info 没问题。
  • brave.http 会记录 Brave Search 请求 URL/查询参数、响应状态/计时，以及缓存命中/未命中/写入事件。它不会记录 API 密钥或响应正文，但搜索查询可能包含敏感信息。
  • 标志可以安全地保持启用；它们只会影响特定子系统的日志量。
  • 使用 /logging 更改日志目标位置、级别和脱敏设置。

​
相关