[IT] (초보자용) OpenClaw 설치 및 Gemini/GPT 연결 완벽 가이드

안녕하세요! 오늘은 내 컴퓨터에서 실행하는 인공지능 비서, OpenClaw를 설치하고 구글의 Gemini나 오픈AI의 GPT를 연결하는 방법을 아주 쉽게 알려드리겠습니다. 컴퓨터를 잘 몰라도 아래 '복붙' 가이드만 따라오시면 됩니다!

1. 사전 준비 (이것만 설치하세요)

프로그램을 돌리기 위한 최소한의 도구입니다. (이미 있다면 건너뛰셔도 됩니다.)

• Node.js 설치: 공식 홈페이지에서 LTS 버전을 받아 설치하세요. (그냥 'Next'만 누르면 끝!)
• Git 설치: 공식 홈페이지에서 윈도우용을 설치해 주세요.

---

2. OpenClaw 설치하기 (복붙 구간)

윈도우 검색창에 cmd를 입력해 '명령 프롬프트'를 켜고 아래 코드를 한 줄씩 복사해서 붙여넣으세요.

Bash

 

# 1. 프로그램 소스코드 다운로드
git clone https://github.com/openclaw/openclaw.git

# 2. 프로그램 폴더로 이동
cd openclaw

# 3. 필요한 실행 부품 설치 (약 1~2분 소요)
npm install

---

3. API 키 설정 (Gemini / GPT / Claude)

AI의 '두뇌'를 연결하는 과정입니다. openclaw 폴더 안에 있는 .env.example 파일을 복사해서 **.env**로 이름을 바꾼 뒤, 메모장으로 열어주세요.

원하는 AI 모델에 맞춰 아래 내용을 수정하세요:

• OpenAI (GPT) 사용 시

  OPENAI_API_KEY=sk-여러분의_GPT_키_입력
  DEFAULT_MODEL=gpt-4o  (또는 gpt-3.5-turbo)
  

  
  
• Google (Gemini) 사용 시

  GEMINI_API_KEY=여러분의_제미나이_키_입력
  DEFAULT_MODEL=gemini-1.5-pro
  

  
  
• Anthropic (Claude) 사용 시

  CLAUDE_API_KEY=여러분의_클로드_키_입력
  DEFAULT_MODEL=claude-3-5-sonnet-latest
  

💡 Tip: 각 공식 홈페이지(AI/ML API, Google AI Studio 등)에서 키를 발급받아 붙여넣으시면 됩니다.

---

4. 원클릭 실행 파일 만들기 (.bat 코드)

매번 명령어를 치기 번거로우니, 바탕화면에서 더블 클릭만 하면 실행되는 파일을 만들어 보겠습니다.

1. 메모장을 열고 아래 코드를 붙여넣으세요.
2. 파일을 저장할 때 이름을 **AI_시작하기.bat**로 하고, '모든 파일' 형식으로 openclaw 폴더 안에 저장하세요.

 

@echo off
title OpenClaw Multi-AI Launcher
echo [시스템] OpenClaw 서비스를 시작합니다...
cd /d %~dp0

REM 서버 실행 (백그라운드)
start /b npm start

echo [완료] 서버가 활성화되었습니다.
echo 5초 뒤에 AI 채팅 화면으로 연결합니다...
timeout /t 5 /nobreak > nul

REM 브라우저 열기 (기본 주소: 3000번 포트)
start http://localhost:3000

echo.
echo 창을 닫으면 프로그램이 종료됩니다.
pause

---

5. 실행 및 확인

1. 방금 만든 **AI_시작하기.bat**를 더블 클릭합니다.
2. 잠시 기다리면 브라우저 창이 뜨면서 AI와 대화할 수 있는 화면이 나타납니다.
3. 설정한 API 키에 맞는 모델이 정상적으로 작동하는지 말을 걸어보세요!

---

🔍 자주 발생하는 문제 해결법

• "포트가 사용 중입니다": 이미 다른 프로그램이 3000번 포트를 쓰고 있는 경우입니다. 컴퓨터를 재부팅하거나 .env 파일에서 포트 번호를 수정하세요.
• 대답이 오지 않음: API 키에 잔액이 있는지, 혹은 .env 파일의 변수명(GEMINI_API_KEY 등)이 정확한지 다시 확인해 보세요.

---

도움이 되셨다면 공감과 댓글 부탁드립니다! 여러분의 응원이 더 좋은 튜토리얼을 만듭니다. 😊

안녕하세요! 오늘은 내 컴퓨터에서 실행하는 인공지능 비서, OpenClaw를 설치하고 구글의 Gemini나 오픈AI의 GPT를 연결하는 방법을 아주 쉽게 알려드리겠습니다. 컴퓨터를 잘 몰라도 아래 '복붙' 가이드만 따라오시면 됩니다!

1. 사전 준비 (이것만 설치하세요)

프로그램을 돌리기 위한 최소한의 도구입니다. (이미 있다면 건너뛰셔도 됩니다.)

• Node.js 설치: 공식 홈페이지에서 LTS 버전을 받아 설치하세요. (그냥 'Next'만 누르면 끝!)
• Git 설치: 공식 홈페이지에서 윈도우용을 설치해 주세요.

---

2. OpenClaw 설치하기 (복붙 구간)

윈도우 검색창에 cmd를 입력해 '명령 프롬프트'를 켜고 아래 코드를 한 줄씩 복사해서 붙여넣으세요.

Bash

# 1. 프로그램 소스코드 다운로드
git clone https://github.com/openclaw/openclaw.git

# 2. 프로그램 폴더로 이동
cd openclaw

# 3. 필요한 실행 부품 설치 (약 1~2분 소요)
npm install

---

3. API 키 설정 (Gemini / GPT / Claude)

AI의 '두뇌'를 연결하는 과정입니다. openclaw 폴더 안에 있는 .env.example 파일을 복사해서 **.env**로 이름을 바꾼 뒤, 메모장으로 열어주세요.

원하는 AI 모델에 맞춰 아래 내용을 수정하세요:

• OpenAI (GPT) 사용 시

  OPENAI_API_KEY=sk-여러분의_GPT_키_입력
  DEFAULT_MODEL=gpt-4o  (또는 gpt-3.5-turbo)
  

• Google (Gemini) 사용 시

  GEMINI_API_KEY=여러분의_제미나이_키_입력
  DEFAULT_MODEL=gemini-1.5-pro
  

• Anthropic (Claude) 사용 시

  CLAUDE_API_KEY=여러분의_클로드_키_입력
  DEFAULT_MODEL=claude-3-5-sonnet-latest
  

💡 Tip: 각 공식 홈페이지(AI/ML API, Google AI Studio 등)에서 키를 발급받아 붙여넣으시면 됩니다.

---

4. 원클릭 실행 파일 만들기 (.bat 코드)

매번 명령어를 치기 번거로우니, 바탕화면에서 더블 클릭만 하면 실행되는 파일을 만들어 보겠습니다.

1. 메모장을 열고 아래 코드를 붙여넣으세요.
2. 파일을 저장할 때 이름을 **AI_시작하기.bat**로 하고, '모든 파일' 형식으로 openclaw 폴더 안에 저장하세요.

 

@echo off
title OpenClaw Multi-AI Launcher
echo [시스템] OpenClaw 서비스를 시작합니다...
cd /d %~dp0

REM 서버 실행 (백그라운드)
start /b npm start

echo [완료] 서버가 활성화되었습니다.
echo 5초 뒤에 AI 채팅 화면으로 연결합니다...
timeout /t 5 /nobreak > nul

REM 브라우저 열기 (기본 주소: 3000번 포트)
start http://localhost:3000

echo.
echo 창을 닫으면 프로그램이 종료됩니다.
pause

---

5. 실행 및 확인

1. 방금 만든 **AI_시작하기.bat**를 더블 클릭합니다.
2. 잠시 기다리면 브라우저 창이 뜨면서 AI와 대화할 수 있는 화면이 나타납니다.
3. 설정한 API 키에 맞는 모델이 정상적으로 작동하는지 말을 걸어보세요!

---

🔍 자주 발생하는 문제 해결법

• "포트가 사용 중입니다": 이미 다른 프로그램이 3000번 포트를 쓰고 있는 경우입니다. 컴퓨터를 재부팅하거나 .env 파일에서 포트 번호를 수정하세요.
• 대답이 오지 않음: API 키에 잔액이 있는지, 혹은 .env 파일의 변수명(GEMINI_API_KEY 등)이 정확한지 다시 확인해 보세요.

---

질문이나 요청사항은 댓글로 남겨주세요 대댓글이나 다음 편에 업로드 됩니다. 😊