診斷旗標

診斷旗標讓您能夠啟用針對性的偵錯日誌，而無需在所有地方開啟詳細日誌。旗標是選擇加入的，除非子系統檢查它們，否則不會產生任何效果。

運作方式

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

多個旗標：

{
  "diagnostics": {
    "flags": ["telegram.http", "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 追蹤：

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

對於遠端閘道，您也可以使用 openclaw logs --follow（請參閱 /cli/logs）。