OPenClaw 자주 묻는 질문: 회원가입, API 키, 오류 처리 완벽 가이드

OPenClaw는 인기 있는 AI 도구로, 신규 사용자가 회원가입 및 API 호출 시 다양한 문제를 겪곤 합니다. 이 글에서는 가장 자주 묻는 질문들을 모아 계정 생성부터 키 관리, 오류 처리까지 삽질 없이 빠르게 해결할 수 있도록 도와드립니다.

회원가입 시 인증 메일이 오지 않을 때

인증 메일이迟迟 도착하지 않는 이유는 크게 두 가지입니다. 첫째, 이메일 주소를 잘못 입력했거나 도메인에서 차단된 경우입니다. Google, Outlook 같은 국제 이메일을 사용하고 회사 필터가 적용된 주소는 피하세요. 스팸함도 꼭 확인하세요. 둘 다 이상이 없다면 서버 캐시 지연 때문일 수 있으니 10~15분 기다린 후 다시 보내기를 시도해보세요. 여러 번 시도해도 안 되면 고객센터에 가입한 사용자명과 대체 이메일을 알려주는 것이 가장 빠릅니다.

API 키 관련 자주 발생하는 오류 및 해결 방법

가장 흔한 오류는 "401 Unauthorized"입니다. 이는 키가 유효하지 않거나 만료되었음을 의미합니다. 키를 복사할 때 앞뒤에 공백이 없는지 확인하고, OPenClaw 콘솔에서 키 상태가 "Active"인지 "Revoked"인지 확인하세요. Revoked 상태라면 "API Keys" 페이지에서 새로 생성하세요. 또 다른 자주 발생하는 오류는 "429 Too Many Requests"입니다. 이는 일시적인 속도 제한에 걸린 것으로, 호출 빈도를 낮추고 백오프 지연(Backoff Delay)을 추가하거나 더 높은 할당량 요금제로 업그레이드하세요.

계정 로그인 시 '잠김' 또는 '비활성화' 메시지가 나타날 때

계정이 잠기는 가장 흔한 원인은 비밀번호를 여러 번 연속으로 잘못 입력하거나 비정상적인 로그인(예: 다른 지역 IP)이 감지된 경우입니다. 먼저 비밀번호 재설정을 진행하면 등록된 이메일로 잠금 해제 링크가 발송됩니다. 재설정 후에도 비활성화 메시지가 계속 뜬다면 서비스 이용약관을 위반했는지 확인하세요(예: 대량 가입, API 남용). 이런 경우 사용 목적과 신분 증명 자료를 첨부하여 티켓을 제출해야 하며, 보통 1~3 영업일 내에 답변이 옵니다. 2단계 인증(2FA)을 활성화하면 잠금 위험을 줄일 수 있습니다.

구독 결제 실패 및 청구 문제

구독 결제 시 카드가 거절되면 먼저 해당 카드가 국제 결제를 지원하는지 확인하세요(Visa/Mastercard 권장). 잔액도 충분한지 확인하세요. 일부 은행은 해외 결제를 차단하므로 사전에 고객센터에 연락해 제한을 해제하는 것이 좋습니다. 이미 결제가 완료되었지만 구독이 활성화되지 않았다면 결제 화면 캡처를 OPenClaw 지원팀에 보내면 수동으로 확인 후 권한을 활성화해줍니다. 또한 무료 크레딧이 소진된 후 자동으로 유료 전환되는 안내가 다소 눈에 띄지 않아 예상치 못한 결제가 발생하는 경우가 많습니다. "Billing"에서 지출 한도를 설정하거나 자동 갱신을 해제하세요.