OPenClaw 사용 중 API 호출 오류나 로그인 문제로 작업이 중단되는 경우가 있습니다. 이 글에서는 가장 자주 발생하는 오류 유형과 그에 대한 해결책을 모아, 빠르게 정상 상태로 돌아갈 수 있도록 안내합니다.
API 호출 오류: 403, 429, 500 코드 처리
API 요청 시 403 오류가 반환되면 일반적으로 권한이 부족하다는 의미입니다. 가장 흔한 원인은 API 키가 올바르게 설정되지 않았거나 만료된 경우입니다. 설정 패널에서 키가 활성화되어 있는지 확인하고, IP 화이트리스트가 현재 네트워크를 제한하고 있지 않은지 점검하세요. 429 오류는 요청이 너무 빈번하여 속도 제한에 걸린 경우로, 최소 60초 후에 재시도하거나 요청 빈도를 낮추면 됩니다. 500 오류는 서버 내부 오류로, 일시적인 장애인 경우가 많으므로 몇 분 후 다시 요청하면 대부분 해결됩니다. 500 오류가 지속되면 고객 지원팀에 연락하여 서비스 상태를 확인하는 것이 좋습니다.
로그인 인증 실패: 비밀번호 오류 및 계정 잠금
비밀번호를 잊어버린 경우, 등록한 이메일로 '비밀번호 찾기' 링크를 통해 재설정할 수 있습니다. '계정이 잠겼습니다'라는 메시지가 표시되면 일반적으로 여러 번 잘못된 비밀번호를 입력하여 보안 보호 기능이 작동한 것입니다. 15분 후 자동으로 잠금이 해제되거나, 공식 고객 지원팀에 문의하여 수동 해제를 요청할 수 있습니다. 또한 일부 사용자는 프록시 사용으로 인해 IP가 비정상적으로 감지되어 시스템에서 위험으로 간주하는 경우가 있으므로, 프록시를 끄거나 자주 사용하는 네트워크 환경으로 전환한 후 다시 시도해 보세요.
