💡 한 줄 요약
맥북(macOS)과 GPT 기준 설명서 때문에 망설이셨나요? 윈도우(Windows) 환경에서 Node.js 설치부터 구글 제미나이(Gemini) API 연동까지 오픈클로(OpenClaw)를 가장 쉽게 설치하는 단계를 정리해 드립니다!
💻 윈도우(Windows) & 구글 제미나이(Gemini) 맞춤형 설치 배경
공식 홈페이지나 대부분의 교재에서는 맥북(macOS) 터미널과 OpenAI(GPT) 기준으로 오픈클로 설치법이 설명되어 있어 윈도우 사용자가 따라 하기 다소 까다로울 수 있습니다.
하지만 걱정하지 마세요! 오픈클로는 자바스크립트 기반(Node.js)으로 동작하므로 윈도우에서도 명령 프롬프트(CMD)나 파워셸(PowerShell)을 통해 손쉽게 설치할 수 있으며, OpenAI 대신 구글 제미나이(Gemini) API를 연결하면 매우 경제적이고 빠르게 AI 비서를 구동할 수 있답니다.
📊 맥북/GPT 방식 대비 윈도우/Gemini 설정 비교 표
| 구분 / 단계 | 기존 교재 방식 (Mac + GPT) | 윈도우 + Gemini 맞춤 변경점 |
|---|---|---|
| 실행 터미널 | macOS 터미널 / Homebrew (brew) | 윈도우 명령 프롬프트(CMD) 또는 PowerShell |
| Node.js 설치 | `brew install node` 또는 pkg 설치 | `nodejs.org`에서 윈도우용 LTS (.msi) 다운로드 후 설치 |
| OpenClaw 설치 | `curl -fsSL https://openclaw.ai/install.sh | bash` | PowerShell에서 `npm install -g openclaw@latest` 실행 |
| AI Provider 선택 | OpenAI / OpenAI Codex (GPT-5.4) | Google / Gemini CLI OAuth (Gemini 2.5 Flash) |
🛠️ 윈도우 환경 오픈클로(OpenClaw) Step-by-Step 설치 순서
1단계: Node.js 22 버전 이상 설치 및 확인
- 공식 웹사이트 nodejs.org/ko/download에 접속하여 윈도우용 LTS 버전 설치 파일을 다운로드합니다.
- 설치 완료 후 윈도우 키 + R을 누르고
cmd를 입력해 명령 프롬프트를 엽니다. node -v를 입력해v22.x.x이상의 숫자가 나오는지 확인합니다.
2단계: Google Gemini API 키 발급
- 구글 AI 스튜디오(aistudio.google.com)에 구글 계정으로 로그인합니다.
- Get API Key 버튼을 눌러 나만의 제미나이 API 키(API Key)를 생성하고 복사해 둡니다.
3단계: 오픈클로(OpenClaw) 설치 및 온보딩
- 명령 프롬프트(CMD) 또는 PowerShell 창에 아래 명령어를 입력하여 오픈클로를 전역 설치합니다.
npm install -g openclaw@latest
- 설치가 완료되면 온보딩 마법사를 실행합니다:
openclaw onboard --install-daemon
4단계: 온보딩 마법사 핵심 답변 설정 (Gemini 기준)
- Security Disclaimer:
Yes선택 - Onboarding mode:
QuickStart선택 - Gateway location:
Local선택 - Model/auth provider:
Google또는Gemini CLI OAuth선택 - Default model:
gemini-2.5-flash(또는 권장 모델) 선택 - API Key 입력: 아까 발급받은 Google Gemini API Key 입력
- Channel 선택: Telegram, Discord 등 원하는 수단 선택 후 완료
💡 초보자를 위한 바이브 코딩 실전 사용 예시
✨ 윈도우 터미널 설치 확인 명령어 모음
# Node.js 버전 확인
node -v
# 오픈클로 버전 및 설치 확인
openclaw --version
# 오픈클로 온보딩 마법사 재실행
openclaw onboard --install-daemon
📋 팁 및 유의사항
--install-daemon옵션을 붙여서 온보딩하면 윈도우 부팅 시 오픈클로가 자동 실행되어 더욱 편리합니다.- 구글 제미나이 API는 처리 속도가 매우 빠르고 무료 할당량이 충분하여 개인 AI 에이전트 구동에 최적화되어 있습니다.
🎯 AI 에디터 한줄평
맥북이나 GPT 구독이 없어도 윈도우 PC와 무료 제미나이 API 조합으로 나만의 백그라운드 AI 에이전트를 완벽하게 구축할 수 있습니다!
🔗 원본 설치 공식 가이드
