<h2>OpenClaw 자주 묻는 질문: API 키, 결제 및 계정 보안 가이드</h2>

API 키 관련 자주 묻는 질문

질문: API 키가 갑자기 비활성화되어 모델 호출이 되지 않습니다. 어떻게 해야 하나요?
OpenClaw의 API 키는 만료, 수동 취소 또는 보안 제한 트리거로 인해 비활성화될 수 있습니다. 먼저 OpenClaw 콘솔에 로그인하여 "API Keys" 페이지에서 키 상태를 확인하세요. "Inactive"로 표시되면 새 키를 생성하고 기존 키를 교체하십시오. 참고: 계정당 최대 5개의 유효 키를 생성할 수 있으며, 자주 교체할 경우 사용하지 않는 이전 키는 반드시 삭제하세요.

질문: API 호출 시 401 오류가 발생합니다. 어떻게 확인하나요?
401은 인증 실패를 의미합니다. 요청 헤더의 "Authorization" 필드 형식이 "Bearer <your_api_key>"인지, 키에 불필요한 공백이 포함되지 않았는지 확인하세요. 환경 변수에 키를 저장한 경우 변수명 철자가 정확한지 점검하십시오. 또한, 무료 평가판 계정의 키는 평가판 종료 후 자동으로 비활성화될 수 있으므로 유료 플랜으로 업그레이드해야 계속 사용할 수 있습니다.

결제 및 청구 문제

질문: 청구 금액이 예상보다 높은 이유는 무엇인가요?
OpenClaw는 토큰 기준으로 과금되며, 모델마다 가격이 다릅니다. 예상보다 높은 금액은 다음과 같은 원인일 수 있습니다. 1) 고정밀 모델(예: Claw-4)을 사용했지만 단가를 확인하지 않은 경우, 2) 요청에 많은 시스템 프롬프트 또는 대화 기록이 포함되어 실제 소비 토큰 수가 높은 경우. API 요청에 "max_tokens" 제한을 설정하고, 콘솔의 "Usage" 페이지에서 일별/시간별 소비 내역을 확인하는 것이 좋습니다. 이상 피크가 발견되면 코드에 루프 오류가 있는지 점검하세요.

질문: 구독 후 세금 계산서를 어떻게 신청하나요?
OpenClaw 계정 설정에서 "Billing" 섹션으로 이동한 후 "Invoice History"를 클릭하고 청구할 내역을 선택하세요. 회사명, 사업자등록번호, 등록 주소를 입력할 수 있습니다. 참고: 개인 계정은 개인 명의 계산서만 발급 가능하며, 기업 인증 후 기업 계산서를 선택할 수 있습니다. 계산서는 신청 후 3~5영업일 이내에 등록된 이메일로 발송됩니다.

계정 보안 및 권한 관리

질문: API 키가 타인에게 오용되는 것을 방지하려면 어떻게 해야 하나요?
OpenClaw는 "IP 화이트리스트" 기능을 제공하며, "Security" 화면에서 API 호출을 허용할 IP 범위를 설정할 수 있습니다. IP가 불확실한 경우 유효 기간(예: 1시간)을 설정할 수 있는 "임시 키" 메커니즘을 사용하세요. 또한, API 키를 프론트엔드 코드에 직접 작성하지 말고 백엔드 프록시를 통해 전달하는 것이 좋습니다. 콘솔의 "API Logs"를 정기적으로 확인하면 비정상적인 호출 출처를 발견할 수 있습니다.

질문: 계정이 잠겼을 때 어떻게 해제하나요?
계정 잠금은 일반적으로 로그인 실패가 반복되거나 API 호출 빈도 제한을 초과했을 때 발생합니다. 다음 단계를 시도해 보세요. 1) 15~30분 기다리면 자동 해제됩니다(단기 잠금). 2) 비밀번호를 재설정한 후 다시 로그인합니다. 3) "Suspended"로 표시되면 OpenClaw 고객센터에 문의하여 등록된 이메일을 알리고 상황을 설명하세요. 참고: 서비스 약관 위반(예: 대량 계정 생성, 악성 크롤링)은 영구 차단으로 이어질 수 있으며, 이의 제기가 불가능합니다.