Titikey
유용한 팁OpenClawOPenClaw 초보자 사용 가이드: 계정 등록 및 API 키 연동 완전 정복

OPenClaw 초보자 사용 가이드: 계정 등록 및 API 키 연동 완전 정복

2026. 5. 14.
OpenClaw

OPenClaw를 처음 접하는 분들은 계정 등록과 API 키 연동이 막막하게 느껴질 수 있습니다. 하지만 과정은 생각보다 간단하며, 이 튜토리얼을 따라 한 단계씩 진행하면 10분이면 충분합니다. 본 글은 초보자 전용으로 OPenClaw의 계정 등록, 로그인, 그리고 키 연동의 전체 흐름을 처음부터 설명합니다.

OPenClaw 계정 등록 두 가지 방법

OPenClaw 공식 사이트에 접속하면 등록 페이지에서 이메일과 Google 계정 두 가지 방식을 지원합니다. 이메일 등록 시 사용 중인 이메일 주소를 입력하고 비밀번호를 설정한 후, 인증 메일을 확인하고 링크를 클릭하면 활성화됩니다. Google 계정으로 로그인하면 더 빠르며, 권한을 부여하면 자동으로 등록이 완료되어 이메일 인증 과정이 생략됩니다. Google 계정 로그인을 우선 추천하며, 이후 다른 서비스를 연동할 때도 더 편리합니다.

등록 시 비밀번호는 최소 8자리 이상, 대문자와 소문자, 숫자를 포함해야 합니다. 인증 메일이 계속 오지 않는다면 스팸함을 확인하거나 다른 이메일 주소를 사용해 보세요. 하나의 이메일은 하나의 계정만 등록할 수 있으므로 중복 등록하지 마십시오.

로그인 및 보안 인증 설정

등록이 완료되면 로그인 페이지로 돌아가 계정 정보를 입력해 콘솔에 접속합니다. 최초 로그인 시 2단계 인증(2FA) 설정이 요구되며, 이는 계정 보안을 강화하기 위한 조치입니다. Google Authenticator나 Authy 같은 무료 앱을 사용해 QR 코드를 스캔하고 동적 인증 코드를 생성하는 것을 권장합니다. 설정 완료 후 매 로그인마다 인증 코드를 입력해야 하지만, 한 단계가 추가되는 것만으로 계정 도용을 효과적으로 방지할 수 있습니다.

매번 인증 코드를 입력하기 번거롭다면 보안 설정에서 '이 기기 신뢰' 옵션을 선택해 자주 사용하는 PC에서는 인증 코드 없이 로그인할 수 있습니다. 단, 공용 PC에서는 절대 이 옵션을 활성화하지 마세요. 로그인 후에는 기본 닉네임을 즉시 변경하고 개인 정보를 완성해 향후 팀 협업 시 신원을 쉽게 식별할 수 있도록 하세요.

API 키 생성 및 연동

API 키는 OPenClaw 인터페이스를 호출할 때 사용하는 핵심 자격 증명입니다. 콘솔 왼쪽 메뉴에서 'API Keys' 옵션을 찾아 '새 키 생성'을 클릭하세요. 시스템이 무작위 문자열을 생성하며, 이 키는 한 번만 표시되므로 반드시 복사하여 안전한 곳에 저장하세요. 분실 시에는 기존 키가 즉시 만료되고 새 키를 다시 생성해야 합니다.

키를 연동할 때는 사용 중인 개발 환경에 따라 다른 방식을 선택합니다. 명령줄 도구의 경우 config 파일에 키를 직접 입력하면 됩니다. 웹 애플리케이션의 경우 OPenClaw가 제공하는 SDK를 통해 설정해야 합니다. 일반적인 실수는 키 앞뒤에 공백이나 줄바꿈이 포함되는 것으로, 붙여넣을 때 반드시 확인하세요. 연동이 성공하면 콘솔에 '키가 활성화되었습니다'라는 메시지가 표시되며, 이때부터 API를 정상적으로 호출할 수 있습니다.

계정 전환 및 로그아웃

하나의 OPenClaw 계정은 동시에 하나의 단말기에서만 로그인할 수 있습니다. 계정을 전환하려면 먼저 현재 로그인을 종료해야 합니다. 설정 페이지 하단에 '계정 로그아웃' 옵션이 있으며, 클릭 후 확인하면 됩니다. 로그아웃은 데이터를 삭제하지 않고 현재 세션만 종료합니다. 다시 로그인할 때는 새 계정의 이메일과 비밀번호를 입력하면 됩니다.

여러 개의 API 키를 관리해야 한다면 콘솔에서 각 프로젝트별로 독립적인 키를 생성하고, 해당 권한 범위를 설정하는 것이 좋습니다. 이렇게 하면 특정 키가 유출되더라도 해당 프로젝트에만 영향이 미치고 계정 전체가 노출되지 않습니다. 키를 전환할 때는 코드에서 키 문자열만 교체하면 되며, 계정에 다시 로그인할 필요가 없습니다.

상품주문