> ## Documentation Index
> Fetch the complete documentation index at: https://cryptoclawdocs.termix.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 诊断标志

# 诊断标志

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

## 工作原理

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

## 通过配置启用

```json theme={null}
{
  "diagnostics": {
    "flags": ["telegram.http"]
  }
}
```

多个标志：

```json theme={null}
{
  "diagnostics": {
    "flags": ["telegram.http", "gateway.*"]
  }
}
```

更改标志后重启 Gateway 网关。

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

```bash theme={null}
OPENCLAW_DIAGNOSTICS=telegram.http,telegram.payload
```

禁用所有标志：

```bash theme={null}
OPENCLAW_DIAGNOSTICS=0
```

## 日志存储位置

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

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

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

## 提取日志

选择最新的日志文件：

```bash theme={null}
ls -t /tmp/openclaw/openclaw-*.log | head -n 1
```

过滤 Telegram HTTP 诊断：

```bash theme={null}
rg "telegram http error" /tmp/openclaw/openclaw-*.log
```

或在复现时使用 tail：

```bash theme={null}
tail -f /tmp/openclaw/openclaw-$(date +%F).log | rg "telegram http error"
```

对于远程 Gateway 网关，你也可以使用 `openclaw logs --follow`（参见 [/cli/logs](/cli/logs)）。

## 注意事项

* 如果 `logging.level` 设置为高于 `warn`，这些日志可能会被抑制。默认的 `info` 级别即可。
* 标志可以安全地保持启用状态；它们只影响特定子系统的日志量。
* 使用 [/logging](/logging) 更改日志目标、级别和脱敏设置。