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

# 診断フラグ

> 診断フラグを使用すると、システム全体で詳細な（verbose）ログを有効にすることなく、特定の箇所に絞ってデバッグログを出力させることができます。フラグはオプトイン方式であり、サブシステム側でチェックが行われない限り、パフォーマンスに影響を与えることはありません。

診断フラグを使用すると、システム全体で詳細な（verbose）ログを有効にすることなく、特定の箇所に絞ってデバッグログを出力させることができます。フラグはオプトイン方式であり、サブシステム側でチェックが行われない限り、パフォーマンスに影響を与えることはありません。

## 仕組み

* フラグは文字列として扱われ、大文字と小文字を区別しません。
* 構成ファイルまたは環境変数の上書きによって有効化できます。
* ワイルドカード（`*`）をサポートしています:
  * `telegram.*` は `telegram.http` や `telegram.payload` に一致します。
  * `*` はすべての診断フラグを有効にします。

## 構成ファイルによる有効化

`openclaw.json` で設定します:

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "diagnostics": {
    "flags": ["telegram.http"]
  }
}
```

複数のフラグを指定する場合:

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "diagnostics": {
    "flags": ["telegram.http", "gateway.*"]
  }
}
```

フラグを変更した後は、ゲートウェイを再起動してください。

## 環境変数の上書き (一時的な利用)

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
OPENCLAW_DIAGNOSTICS=telegram.http,telegram.payload
```

すべてのフラグを無効にする場合:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
OPENCLAW_DIAGNOSTICS=0
```

## ログの出力先

診断フラグによるログは、標準の診断ログファイルに出力されます。デフォルトのパスは以下の通りです:

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

`logging.file` で出力先を変更している場合は、そのパスを確認してください。ログは 1 行 1 オブジェクトの JSONL 形式です。機密情報の伏せ字（redaction）は、`logging.redactSensitive` の設定に基づいて適用されます。

## ログの抽出と確認

最新のログファイルを見つける:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
ls -t /tmp/openclaw/openclaw-*.log | head -n 1
```

Telegram の HTTP エラーに関連するログをフィルタリングする:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
rg "telegram http error" /tmp/openclaw/openclaw-*.log
```

リアルタイムで監視（tail）しながら問題を再現させる:

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

リモートゲートウェイの場合は、`openclaw logs --follow` コマンドも利用可能です（詳細は [/cli/logs](/cli/logs) を参照）。

## 補足事項

* `logging.level` が `warn` より高いレベル（`error` など）に設定されている場合、これらの診断ログが抑制される可能性があります。デフォルトの `info` であれば問題ありません。
* フラグを有効にしたままにしても基本的には安全です。影響を受けるのは、指定した特定のサブシステムのログ出力ボリュームのみです。
* ログの出力先、レベル、および伏せ字設定を変更するには、[/logging](/logging) を参照してください。