OPenClaw는 강력한 API 서비스 도구로, 점점 더 많은 개발자가 사용 방법에 주목하고 있습니다. 이 가이드에서는 계정 등록부터 API 키 설정까지의 전체 과정을 단계별로 안내하여 OPenClaw의 모든 기능을 빠르게 익힐 수 있도록 도와드립니다.
OPenClaw 계정 등록
OPenClaw 공식 웹사이트로 이동하여 오른쪽 상단의 '회원가입' 버튼을 클릭하세요. 유효한 이메일 주소를 입력하고 로그인 비밀번호를 설정해야 합니다. 비밀번호는 보안을 강화하기 위해 대소문자와 숫자를 포함하는 것이 좋습니다. 이메일 인증을 완료하면 시스템이 자동으로 콘솔 홈페이지로 안내하며, 이때 계정이 성공적으로 생성됩니다.
회원가입 중 인증 코드 로딩에 실패하는 경우 브라우저를 변경하거나 캐시를 삭제해 보세요. 일부 지역의 사용자는 안정적인 네트워크 환경이 필요할 수 있습니다.
API 키 획득 및 관리
콘솔에 로그인한 후 왼쪽 탐색 메뉴에서 'API Keys' 또는 '키 관리' 옵션을 찾으세요. '새 키 생성'을 클릭하면 시스템이 자동으로 고유한 API 키 문자열을 생성합니다. 반드시 즉시 복사하여 안전하게 보관하세요. 키는 페이지를 닫으면 다시 볼 수 없으며, 재생성만 가능합니다.
각 프로젝트나 용도별로 별도의 키를 생성하는 것이 좋습니다. 이렇게 하면 이상이 발생했을 때 다른 서비스에 영향을 주지 않고 해당 키만 비활성화할 수 있습니다. 키 목록에서 생성 시간, 호출 횟수 및 현재 상태를 확인할 수 있으며, 활성화, 비활성화 또는 삭제 작업을 수행할 수 있습니다.
개발 환경 구성 및 기본 호출
API 키를 획득한 후 코드에서 OPenClaw의 요청 헤더를 구성하면 됩니다. Python을 예로 들어, 요청 라이브러리에 Authorization: Bearer your_key 필드를 추가하고 API 엔드포인트를 공식 문서에서 제공하는 base URL로 설정하세요. 일부 기능은 요청 본문에 추가 파라미터를 전달해야 할 수 있으므로, 반드시 해당 인터페이스 설명을 확인하세요.
첫 번째 호출은 공식에서 제공하는 테스트 인터페이스를 사용하는 것이 좋습니다. 올바른 응답 코드가 반환되면 구성이 성공한 것입니다. 401 오류가 발생하면 키가 올바른지 또는 비활성화되지 않았는지 확인하세요. 429 오류는 요청 빈도가 제한을 초과했음을 의미하므로 호출 속도를 낮추거나 더 높은 할당량을 요청해야 합니다.
자주 묻는 질문 및 해결 방법
많은 사용자가 계정을 연결할 때 '권한 없음' 메시지를 접하게 됩니다. 이는 일반적으로 로그인 후 콘솔에서 실명 인증을 완료하지 않았거나 해당 서비스를 활성화하지 않았기 때문입니다. '계정 설정'으로 이동하여 현재 요금제와 권한 범위를 확인하세요. 일부 무료 플랜은 API 호출 횟수에 상한이 있으며, 초과 시 요금제를 업그레이드해야 계속 사용할 수 있습니다.
계정을 전환할 때 이전에 저장한 키가 작동하지 않는 경우, 다른 OPenClaw 하위 계정에 로그인한 것은 아닌지 확인하세요. 기본 계정으로 키를 통합 관리하고 정기적으로 키를 교체하여 보안을 높이는 것이 좋습니다. 공식 문서의 단계를 따르면 대부분의 문제를 해결할 수 있습니다.
