5676a6b38d
What: switch to 你/你的 tone; standardize Skills/Gateway网关/local loopback/私信 wording Why: align zh-CN docs with issue 6995 feedback + idiomatic tech style Tests: pnpm docs:build
2.3 KiB
2.3 KiB
read_when, summary, title, x-i18n
| read_when | summary | title | x-i18n | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
用于定向调试日志的诊断标志 | 诊断标志 |
|
诊断标志
诊断标志允许你在不开启全局详细日志的情况下启用定向调试日志。标志为可选启用，除非相关子系统检查了它们，否则不会产生任何效果。
工作原理
- 标志为字符串（不区分大小写）。
- 你可以在配置中或通过环境变量覆盖来启用标志。
- 支持通配符：
telegram.*匹配telegram.http*启用所有标志
通过配置启用
{
"diagnostics": {
"flags": ["telegram.http"]
}
}
多个标志：
{
"diagnostics": {
"flags": ["telegram.http", "gateway.*"]
}
}
更改标志后需重启 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"
对于远程 Gateway网关，你也可以使用 openclaw logs --follow（参见 /cli/logs）。
注意事项
- 如果
logging.level设置为高于warn的级别，这些日志可能会被抑制。默认的info级别即可。 - 标志可以安全地保持启用状态；它们只会影响特定子系统的日志量。
- 使用 /logging 更改日志输出目标、级别和脱敏设置。