메인 콘텐츠로 건너뛰기
OpenClaw는 버그 보고용 로컬 진단 zip을 만들 수 있습니다. 여기에는 정제된 Gateway 상태, 상태 점검, 로그, 구성 형태, 최근의 페이로드 없는 안정성 이벤트가 함께 포함됩니다. 진단 번들은 검토하기 전까지 비밀처럼 취급하세요. 페이로드와 자격 증명을 생략하거나 수정하도록 설계되어 있지만, 로컬 Gateway 로그와 호스트 수준의 런타임 상태는 여전히 요약합니다.

​
빠른 시작

openclaw gateway diagnostics export
이 명령은 작성된 zip 경로를 출력합니다. 경로를 선택하려면 다음을 사용하세요. 
openclaw gateway diagnostics export --output openclaw-diagnostics.zip
자동화의 경우: 
openclaw gateway diagnostics export --json

​
채팅 명령

소유자는 채팅에서 /diagnostics [note]를 사용해 로컬 Gateway 내보내기를 요청할 수 있습니다. 실제 대화에서 버그가 발생했고 지원을 위해 복사해 붙여 넣을 수 있는 보고서 하나가 필요할 때 사용하세요.
  1. 문제가 보인 대화에서 /diagnostics를 보내세요. 도움이 된다면 /diagnostics bad tool choice처럼 짧은 메모를 추가하세요.
  2. OpenClaw가 진단 서문을 보내고 명시적인 exec 승인 한 번을 요청합니다. 이 승인은 openclaw gateway diagnostics export --json을 실행합니다. 전체 허용 규칙으로 진단을 승인하지 마세요.
  3. 승인 후 OpenClaw는 로컬 번들 경로, 매니페스트 요약, 개인정보 보호 참고, 관련 세션 ID가 포함된 붙여 넣기 가능한 보고서로 답장합니다.
그룹 채팅에서도 소유자는 /diagnostics를 실행할 수 있지만, OpenClaw는 진단 세부 정보를 공유 채팅에 다시 게시하지 않습니다. 서문, 승인 프롬프트, Gateway 내보내기 결과, Codex 세션/스레드 분석을 비공개 승인 경로를 통해 소유자에게 보냅니다. 그룹에는 진단 흐름이 비공개로 전송되었다는 짧은 알림만 표시됩니다. OpenClaw가 비공개 소유자 경로를 찾을 수 없으면 명령은 안전하게 실패하고 소유자에게 DM에서 실행하라고 요청합니다. 활성 OpenClaw 세션이 네이티브 OpenAI Codex 하네스를 사용 중이면, 동일한 exec 승인이 OpenClaw가 알고 있는 Codex 런타임 스레드에 대한 OpenAI 피드백 업로드도 포함합니다. 이 업로드는 로컬 Gateway zip과 별개이며 Codex 하네스 세션에서만 나타납니다. 승인 전에 프롬프트는 진단을 승인하면 Codex 피드백도 전송된다고 설명하지만, Codex 세션 또는 스레드 ID는 나열하지 않습니다. 승인 후 채팅 답장에는 OpenAI 서버로 전송된 스레드의 채널, OpenClaw 세션 ID, Codex 스레드 ID, 로컬 재개 명령이 나열됩니다. 승인을 거부하거나 무시하면 OpenClaw는 내보내기를 실행하지 않고, Codex 피드백을 보내지 않으며, Codex ID를 출력하지 않습니다. 이렇게 하면 일반적인 Codex 디버깅 루프가 짧아집니다. Telegram, Discord 또는 다른 채널에서 잘못된 동작을 발견하고, /diagnostics를 실행하고, 한 번 승인하고, 보고서를 지원팀과 공유한 다음, 네이티브 Codex 스레드를 직접 검사하려면 출력된 codex resume <thread-id> 명령을 로컬에서 실행하면 됩니다. 해당 검사 워크플로는 Codex 하네스를 참조하세요.

​
내보내기에 포함되는 내용

zip에는 다음이 포함됩니다.
  • summary.md: 지원팀용 사람이 읽을 수 있는 개요.
  • diagnostics.json: 구성, 로그, 상태, 상태 점검, 안정성 데이터의 기계 판독 가능 요약.
  • manifest.json: 내보내기 메타데이터와 파일 목록.
  • 정제된 구성 형태와 비밀이 아닌 구성 세부 정보.
  • 정제된 로그 요약과 최근 수정된 로그 줄.
  • 최선 노력 방식의 Gateway 상태 및 상태 점검 스냅샷.
  • stability/latest.json: 사용 가능한 경우 가장 최신의 영속화된 안정성 번들.
Gateway가 비정상이어도 내보내기는 유용합니다. Gateway가 상태 또는 상태 점검 요청에 응답할 수 없더라도, 사용 가능한 경우 로컬 로그, 구성 형태, 최신 안정성 번들이 계속 수집됩니다.

​
개인정보 보호 모델

진단은 공유 가능하도록 설계되었습니다. 내보내기는 디버깅에 도움이 되는 운영 데이터를 유지합니다. 예를 들면 다음과 같습니다.
  • 하위 시스템 이름, Plugin ID, 공급자 ID, 채널 ID, 구성된 모드
  • 상태 코드, 지속 시간, 바이트 수, 큐 상태, 메모리 수치
  • 정제된 로그 메타데이터와 수정된 운영 메시지
  • 구성 형태와 비밀이 아닌 기능 설정
내보내기는 다음을 생략하거나 수정합니다.
  • 채팅 텍스트, 프롬프트, 지침, Webhook 본문, 도구 출력
  • 자격 증명, API 키, 토큰, 쿠키, 비밀 값
  • 원시 요청 또는 응답 본문
  • 계정 ID, 메시지 ID, 원시 세션 ID, 호스트 이름, 로컬 사용자 이름
로그 메시지가 사용자, 채팅, 프롬프트 또는 도구 페이로드 텍스트처럼 보이면, 내보내기는 메시지가 생략되었다는 사실과 바이트 수만 유지합니다.

​
안정성 기록기

Gateway는 진단이 활성화되어 있을 때 기본적으로 제한된 페이로드 없는 안정성 스트림을 기록합니다. 이는 콘텐츠가 아니라 운영 사실을 위한 것입니다. 동일한 진단 Heartbeat는 Gateway가 계속 실행 중이지만 Node.js 이벤트 루프 또는 CPU가 포화된 것으로 보일 때 활성 상태 샘플을 기록합니다. 이러한 diagnostic.liveness.warning 이벤트에는 이벤트 루프 지연, 이벤트 루프 사용률, CPU 코어 비율, 활성/대기/큐에 있는 세션 수, 알려진 경우 현재 시작/런타임 단계, 최근 단계 구간, 제한된 활성/큐 작업 라벨이 포함됩니다. 유휴 샘플은 info 수준의 텔레메트리에 남습니다. 활성 상태 샘플은 작업이 대기 중이거나 큐에 있거나, 활성 작업이 지속적인 이벤트 루프 지연과 겹칠 때만 Gateway 경고가 됩니다. 그 외에는 정상적인 백그라운드 작업 중 일시적인 최대 지연 급증은 디버그 로그에 남습니다. 이 이벤트만으로 Gateway가 다시 시작되지는 않습니다. 시작 단계도 벽시계 시간과 CPU 타이밍이 포함된 diagnostic.phase.completed 이벤트를 내보냅니다. 중단된 임베디드 실행 진단은 마지막 브리지 진행 상황이 원시 응답 항목이나 응답 완료 이벤트처럼 터미널 상태로 보였지만 Gateway가 여전히 임베디드 실행을 활성 상태로 간주할 때 terminalProgressStale=true로 표시합니다. 라이브 기록기를 검사합니다. 
openclaw gateway stability
openclaw gateway stability --type payload.large
openclaw gateway stability --json
치명적 종료, 종료 시간 초과 또는 재시작 시작 실패 후 가장 최신의 영속화된 안정성 번들을 검사합니다. 
openclaw gateway stability --bundle latest
가장 최신의 영속화된 번들에서 진단 zip을 만듭니다. 
openclaw gateway stability --bundle latest --export
영속화된 번들은 이벤트가 있을 때 ~/.openclaw/logs/stability/ 아래에 저장됩니다.

​
유용한 옵션

openclaw gateway diagnostics export \
  --output openclaw-diagnostics.zip \
  --log-lines 5000 \
  --log-bytes 1000000
  • --output <path>: 특정 zip 경로에 씁니다.
  • --log-lines <count>: 포함할 정제된 로그 줄의 최대 개수입니다.
  • --log-bytes <bytes>: 검사할 최대 로그 바이트입니다.
  • --url <url>: 상태 및 상태 점검 스냅샷용 Gateway WebSocket URL입니다.
  • --token <token>: 상태 및 상태 점검 스냅샷용 Gateway 토큰입니다.
  • --password <password>: 상태 및 상태 점검 스냅샷용 Gateway 비밀번호입니다.
  • --timeout <ms>: 상태 및 상태 점검 스냅샷 제한 시간입니다.
  • --no-stability-bundle: 영속화된 안정성 번들 조회를 건너뜁니다.
  • --json: 기계 판독 가능 내보내기 메타데이터를 출력합니다.

​
진단 비활성화

진단은 기본적으로 활성화되어 있습니다. 안정성 기록기와 진단 이벤트 수집을 비활성화하려면: 
{
  diagnostics: {
    enabled: false,
  },
}
진단을 비활성화하면 버그 보고 세부 정보가 줄어듭니다. 일반 Gateway 로깅에는 영향을 주지 않습니다. 중요한 메모리 압박 스냅샷은 기본적으로 꺼져 있습니다. 진단 이벤트를 유지하고 OOM 전 안정성 스냅샷도 캡처하려면: 
{
  diagnostics: {
    memoryPressureSnapshot: true,
  },
}
중요한 메모리 압박 중 추가 파일 시스템 스캔과 스냅샷 쓰기를 감당할 수 있는 호스트에서만 사용하세요. 스냅샷이 꺼져 있어도 일반 메모리 압박 이벤트는 RSS, 힙, 임계값, 증가 사실을 계속 기록합니다.

​
관련 항목