English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Gateway

진단 정보 내보내기

OpenClaw은 버그 보고를 위한 로컬 진단 zip을 만들 수 있습니다. 이 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 로깅에는 영향을 주지 않습니다.

관련 항목