진단 플래그 (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 형식(줄당 하나의 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 참조).