診断フラグ（Diagnostics Flags）

診断フラグを使用すると、すべての場所で詳細ログを有効にすることなく、ターゲット指向のデバッグログを有効にできます。フラグはオプトインであり、サブシステムがチェックしない限り効果はありません。

仕組み

{
  "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 形式（1行に1つの 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 参照）。