OPenClaw는 효율적인 AI 프록시 도구이지만, 사용 중 로그인 실패, 요청 오류 또는 계정 잠금 같은 문제가 발생할 수 있습니다. 이 글은 사용자들이 가장 자주 문의하는 여러 예외 상황을 정리하고, 실제로 적용 가능한 해결 단계를 제시하여 작업 흐름이 지연되지 않도록 도와드립니다.
1. 로그인 실패 및 계정 접속 불가
로그인 실패는 주로 네트워크 환경, 자격 증명 만료 또는 계정 상태 이상으로 발생합니다. 먼저 네트워크 프록시가 안정적인지 확인하고, 일부 지역에서는 노드를 변경한 후 다시 시도해 보세요. '비밀번호 오류' 메시지가 표시되면 공식 비밀번호 찾기 기능을 통해 재설정하되, 대소문자와 특수 문자를 주의하세요.
계속 '로그인 시간 초과'가 나타난다면 OPenClaw 서버가 임시 유지보수 중일 수 있으므로 1~2시간 기다린 후 다시 시도하세요. '인증 코드 오류'가 자주 발생하면 브라우저 캐시를 삭제하거나 시크릿 모드로 로그인해 보세요. 오랫동안 사용하지 않은 계정은 시스템이 휴면 상태로 전환할 수 있으므로 고객센터에 문의하여 해제해야 합니다.
2. API 요청 오류 및 주요 오류 코드
OPenClaw 인터페이스를 호출할 때 400 Bad Request가 발생하면 일반적으로 요청 파라미터 형식에 문제가 있는 경우입니다. API 문서를 확인하여 필수 필드가 모두 포함되었는지, JSON 문법이 올바른지 점검하세요. 401 Unauthorized가 나타나면 API Key를 갱신해야 하며, 키가 유출된 경우 즉시 관리 페이지에서 새 키를 생성하여 교체하세요.
503 Service Unavailable은 대부분 서버 과부하로 인한 것이므로 자동 재시도 메커니즘을 활성화하고 5초 이상 간격을 두고 다시 요청하세요. 429 Too Many Requests를 자주 받는다면 속도 제한에 걸린 것이므로 요청 빈도를 낮추거나 프로페셔널 플랜으로 업그레이드하여 더 높은 할당량을 확보하는 것이 좋습니다.
3. 계정 잠금 및 해제 절차
OPenClaw 계정이 잠기는 것은 주로 여러 번의 로그인 실패 또는 비정상적인 위치에서의 접속으로 보안 메커니즘이 작동했기 때문입니다. 잠금이 발생하면 시스템이 일반적으로 이메일을 발송하므로, 이메일 내 링크를 통해 본인 인증을 완료하면 잠금이 해제됩니다. 이메일을 받지 못했다면 스팸 폴더를 확인하거나 공식 사이트에 직접 로그인하여 '계정 이의 제기'를 클릭하세요.
