💡 [2부] 한 줄 요약
1부에서 준비한 Node.js 22+와 제미나이 API 키로 윈도우 PC에 오픈클로(OpenClaw)를 직접 설치하고, 온보딩 마법사 설정을 거쳐 나만의 AI 비서를 완벽하게 연동해 봅니다!
🚀 실전 구축! 윈도우 명령어로 오픈클로 설치 및 제미나이 연결
[1부]에서 Node.js 22 이상 버전 설치와 구글 AI 스튜디오 제미나이 API 키 발급을 완료하셨다면, 이제 본격적인 오픈클로 설치 및 온보딩을 진행할 준비가 되었습니다.
윈도우 환경에서는 npm 명령어를 통해 오픈클로 패키지를 설치한 후 온보딩 마법사를 따라 항목별 답변을 선택해 주기만 하면 5분 만에 생태계 연결이 완료됩니다.
📊 2부: 온보딩 마법사 핵심 답변 요약 표
| 질문 항목 (Onboarding Question) | 선택할 답변 | 설명 및 꿀팁 |
|---|---|---|
| Security Disclaimer | Yes |
개인 전용 AI 에이전트 동작 보안 안내에 동의합니다. |
| Onboarding Mode | QuickStart |
기본 권장 설정으로 빠르게 환경을 구축합니다. |
| Gateway Location | Local |
현재 사용 중인 윈도우 내 컴퓨터에서 구동하도록 설정합니다. |
| Model / Auth Provider | Google 또는 Gemini CLI OAuth |
OpenAI(GPT) 대신 무료 고성능 구글 제미나이 모델을 선택합니다. |
| Default Model | gemini-2.5-flash (또는 권장 모델) |
속도가 빠르고 무료 할당량이 충분한 제미나이 2.5 플래시를 선택합니다. |
🛠️ Step-by-Step 2부 오픈클로 설치 및 실행 순서
1단계: 오픈클로(OpenClaw) 전역 설치
- 윈도우 키 + R을 누르고
cmd를 입력해 명령 프롬프트를 실행합니다. - 아래 설치 명령어를 입력하고 Enter를 누릅니다:
npm install -g openclaw@latest
- 설치가 완료된 후
openclaw --version을 입력하여 정상적으로 버전이 출력되는지 확인합니다.
2단계: 온보딩 마법사 실행 및 데몬(Daemon) 등록
- 명령 프롬프트에서 아래 명령어를 입력합니다:
openclaw onboard --install-daemon
*--install-daemon옵션을 포함하면 윈도우 부팅 시 오픈클로가 항상 백그라운드에서 구동되어 매우 편리합니다. - 화면에 나타나는 온보딩 마법사의 질문에 위 요약 표의 답변(Yes ➔ QuickStart ➔ Local ➔ Google ➔ gemini-2.5-flash)을 차례대로 선택합니다.
- API Key 입력 창이 나오면 [1부]에서 복사해 둔 Google Gemini API Key를 붙여넣고 제출합니다.
- 메시지 채널(Telegram 등) 연동 안내에 따라 Bot Token을 입력하면 모든 설치가 완료됩니다!
💡 초보자를 위한 바이브 코딩 실전 사용 예시
✨ 자주 쓰는 오픈클로 터미널 관리 명령어
# 오픈클로 상태 확인
openclaw status
# 오픈클로 설정 다시하기 (재온보딩)
openclaw onboard --install-daemon
# 최신 버전으로 업데이트
npm install -g openclaw@latest
📋 팁 및 트러블슈팅
- 온보딩 중 선택지를 잘못 입력했다면
Ctrl + C를 눌러 강제 종료한 후 다시openclaw onboard를 실행하시면 됩니다. - 제미나이 API는 강력한 성능과 빠른 속도를 제공하므로 윈도우 환경에서도 가볍고 쾌적하게 AI 비서를 구동할 수 있습니다.
🎯 AI 에디터 한줄평
이제 윈도우 PC에서도 나만의 제미나이 기반 오픈클로 AI 비서가 부팅과 동시에 나이트런/백그라운드에서 든든하게 동작합니다!
🔗 원본 설치 공식 가이드
