개요
OpenClaw Gateway는 클라이언트와 핵심 서비스를 연결하는 핵심 컴포넌트입니다. Gateway에 문제가 발생하면 모든 채널의 메시지 처리가 영향을 받습니다.
진단 첫 단계: Doctor 실행
openclaw doctor
네트워크 문제 해결
포트 점유, 방화벽 차단, DNS 해석 실패, SSL/TLS 문제 등을 점검합니다.
설정 문제 해결
설정 파일 문법 오류, 환경 변수 미설정, 모델 설정 오류를 점검합니다.
openclaw configure --validate
openclaw secrets list
openclaw doctor --provider openai --model gpt-4o
런타임 문제 해결
메모리 누수, 높은 지연, 빈번한 재시작을 점검합니다.
채널 연결 문제
Webhook 접근 불가, WebSocket 연결 해제를 점검합니다.
복구 단계
openclaw stop
openclaw cache clear
openclaw configure --validate
openclaw start
정리
Gateway 장애 해결의 핵심 사고방식은: 먼저 Doctor 명령으로 문제 유형을 빠르게 파악하고, 로그와 전문 검사를 통해 근본 원인을 심층적으로 파악하는 것입니다.