Diagnostics 导读

用诊断标志精准抓日志,不刷屏

诊断标志是 opt-in 的调试开关,只在你指定的子系统里输出详细日志,不会全局刷屏。配置在 diagnostics.flags 数组里,支持通配符(如 telegram.*),改完必须重启网关。最容易忘的是:环境变量 OPENCLAW_DIAGNOSTICS=0 可以一键关闭所有标志,比改配置快。

先讲这一页到底在解决什么

用诊断标志精准抓日志,不刷屏

诊断标志是 opt-in 的调试开关,只在你指定的子系统里输出详细日志,不会全局刷屏。配置在 diagnostics.flags 数组里,支持通配符(如 telegram.*),改完必须重启网关。最容易忘的是:环境变量 OPENCLAW_DIAGNOSTICS=0 可以一键关闭所有标志,比改配置快。

原文共 9 节,先看 Start Here 路径:/diagnostics/flags 查看官方原文

第一站

💡 Flags 像开小灯,不像开探照灯

它们是大小写不敏感的字符串,带通配符。

1

telegram.http

像只照 Telegram 的 HTTP 小路。

2

telegram.*

像把 Telegram 这一整排灯都打开。

3

*

像整栋楼全亮,适合最后兜底,不适合日常。

一句话

Flags 是定点照明,不是全楼开大灯。

第二站

🧩 配置和环境变量,两条路都能点灯

官方给你的是“写进配置”或“临时从环境变量打开”,按场景选就行。

config

像在灯控面板上永久设定。

env override

像临时拿手电筒照一下。

OPENCLAW_DIAGNOSTICS=0

像立刻把灯全关掉。

第三站

🪵 灯亮了以后,日志会去标准日志文件里等你

再配合 `logging.file` 或默认路径,你就能把这盏灯照出的信息抓出来。

默认落点

还是那本滚动日志。

提取日志

像把当天那页日记拎出来单独看。

一句话

诊断标志的价值,是让你只照问题所在的那一小块。