🔒
유료 회원 전용
결제 승인이 완료된 회원만 이용할 수 있습니다.
🦞 OpenClaw 설치 가이드
🦞 OpenClaw 설치 가이드
AI 비서 설치 가이드
AI 비서를
내 PC에 설치하자
코딩 몰라도 OK · 총 7단계 · 30분이면 완성
1 Node.js 설치
2 OpenClaw 설치
3 ChatGPT 계정 연결
4 텔레그램 연동
0
준비물
1
Node.js
2
OpenClaw
3
ChatGPT
4
초기설정
5
시작!
6
텔레그램
7
자동시작
📋
STEP 0
준비물 확인 — 뭘 설치해야 하나?
총 3가지만 있으면 AI 비서가 내 PC에서 24시간 일해요.
어렵게 생각하지 마세요. 하나씩 따라만 하면 됩니다!
🖥️
이 가이드에서 "터미널"이란?
컴퓨터에 글자로 명령을 내리는 창이에요. 윈도우에서는 "명령 프롬프트(cmd)"라고 불러요.
터미널 여는 법 (외워두세요!):
① 키보드에서
②
③ "명령 프롬프트"가 나타나면 클릭하세요
검은색(또는 파란색) 창이 열리면 성공! 이 창에 명령어를 타이핑하고 Enter 키를 누르면 실행돼요.
이 가이드에서 어두운 배경의 코드 블록이 나올 때마다, 그 안의 명령어를 이 터미널 창에 입력하면 됩니다.
컴퓨터에 글자로 명령을 내리는 창이에요. 윈도우에서는 "명령 프롬프트(cmd)"라고 불러요.
터미널 여는 법 (외워두세요!):
① 키보드에서
Windows 키(윈도우 로고 키)를 누르세요②
cmd라고 타이핑하세요③ "명령 프롬프트"가 나타나면 클릭하세요
검은색(또는 파란색) 창이 열리면 성공! 이 창에 명령어를 타이핑하고 Enter 키를 누르면 실행돼요.
이 가이드에서 어두운 배경의 코드 블록이 나올 때마다, 그 안의 명령어를 이 터미널 창에 입력하면 됩니다.
| 순서 | 프로그램 | 역할 | 비용 |
|---|---|---|---|
| 0단계 | 🪟 Windows 업데이트 | 안정적인 설치 환경 준비 | 무료 |
| 1단계 | 🟢 Node.js | OpenClaw를 실행하는 엔진 | 무료 |
| 2단계 | 🦞 OpenClaw | AI 비서 본체 | 무료 |
| 3단계 | 🤖 ChatGPT 계정 | AI 두뇌와 연결 | 무료~월 28,000원 |
💡
비유로 이해하기: Node.js는 자동차 엔진, OpenClaw는 자동차 본체, API 키는 기름이에요. 엔진과 차는 공짜!
🪟
STEP 0-5 · 먼저 하세요!
Windows 업데이트 확인하기
Node.js 설치 전에 Windows가 최신 상태인지 확인해야 해요. 오래된 윈도우에서는 설치 오류가 자주 발생해요!
- 1시작 버튼 클릭 → 설정(⚙️) 클릭
- 2Windows 업데이트 클릭
- 3"업데이트 확인" 버튼 클릭
- 4업데이트가 있으면 모두 설치하고 PC 재시작
- 5재시작 후 다시 업데이트 확인 → "최신 상태입니다" 메시지 확인
⚠️
왜 업데이트가 필요한가요?
Node.js는 최신 Windows 기능을 사용해요. 특히 Windows 10 이하 버전이라면 꼭 업데이트 후 진행하세요!
Node.js는 최신 Windows 기능을 사용해요. 특히 Windows 10 이하 버전이라면 꼭 업데이트 후 진행하세요!
✅
"최신 상태입니다" 메시지가 나오면 다음 단계로!
1
STEP 1
Node.js 설치하기
Node.js는 OpenClaw의 엔진이에요. 이걸 먼저 설치해야 OpenClaw를 실행할 수 있어요.
📥 설치 방법
- 1nodejs.org 접속
- 2페이지 아래쪽 "Windows 설치 프로그램(.msi)" 초록 버튼 클릭 → 다운로드
- 3다운받은 .msi 파일 더블클릭 → "Next"만 계속 클릭
- 4"Install" 클릭 → "Finish" 클릭
- 5설치 후 PC 재시작 (강력 권장)
▲ nodejs.org에서 왼쪽 LTS 버전(초록 버튼)을 클릭하세요
⚠️
반드시 LTS(왼쪽)를 선택하세요. Current는 불안정해요.
아래쪽에 Windows 설치 프로그램(.msi) 초록 버튼이 보이면 그걸 클릭해서 다운로드하세요.
오류 시: 터미널을 닫고 새로 열거나, PC 재시작 후 재시도
아래쪽에 Windows 설치 프로그램(.msi) 초록 버튼이 보이면 그걸 클릭해서 다운로드하세요.
오류 시: 터미널을 닫고 새로 열거나, PC 재시작 후 재시도
✅ 설치 확인 — 순서대로 따라하세요
- 1터미널 열기:
Windows 키→cmd→ "명령 프롬프트" 클릭 - 2아래 "복사" 버튼 클릭
- 3터미널에서 마우스 우클릭 (붙여넣기)
- 4Enter 키 누르기
node --version→ v22.x.x
npm --version→ 10.x.x
✅
두 명령어 모두 숫자가 나오면 설치 성공!
2
STEP 2
OpenClaw 설치하기
Node.js에 포함된 npm(앱스토어 같은 설치 도구)으로 명령어 한 줄이면 끝이에요!
📥 설치하기 — 순서대로 따라하세요
- 1터미널 열기:
Windows 키→cmd타이핑 → "명령 프롬프트" 클릭 - 2오른쪽 아래 "복사" 버튼을 클릭하세요 👉
- 3터미널(검은 창)에서 마우스 우클릭 → 명령어가 붙여넣기됨
- 4키보드에서 Enter 키를 누르세요
- 5화면에 글자가 쭉 올라가요 — 정상! 1~2분 기다리면 완료
npm install -g openclaw
▲ npm 버전 확인 후 OpenClaw 설치 & 버전 확인까지 완료된 모습
⚠️
"npm" 찾을 수 없음 오류? → 1단계로 돌아가 Node.js 재설치 후 터미널을 닫고 새로 열어서 다시 시도
✅ 설치 확인 — 같은 방법으로
- 1아래 "복사" 버튼 클릭
- 2터미널에서 마우스 우클릭 (붙여넣기)
- 3Enter 키 누르기
openclaw --version→ 2026.x.x
✅
버전 번호(숫자)가 나오면 설치 성공!
💡
npm이란? 스마트폰 앱스토어처럼 명령어로 프로그램을 설치하는 도구
3
STEP 3
ChatGPT 계정 만들고 연결하기
OpenClaw(몸)에 ChatGPT(두뇌)를 연결해야 AI가 답변할 수 있어요. 계정만으로 시작 가능!
① 계정 만들기
- 1chatgpt.com 접속
- 2"Sign up" 클릭
- 3"Continue with Google" → 구글 계정 가입
- 4이름, 생년월일 입력 → 완료
| 방식 | 특징 | 비용 |
|---|---|---|
| 🆓 무료 | GPT-4o 기본, 하루 제한 | 0원 |
| 💎 Plus | 무제한, 빠른 응답 | 월 $20 |
② 터미널에서 연결 — 순서대로
- 1아래 "복사" 버튼 클릭
- 2터미널에서 마우스 우클릭 (붙여넣기)
- 3Enter 키 누르기
- 4화면 안내에 따라 이메일/비밀번호 입력
openclaw configure
▲ openclaw configure 실행 시 나오는 초기 설정 화면
✅
연결 완료 메시지가 나오면 성공!
⚠️
구글 계정으로 가입했다면: chatgpt.com에서 먼저 비밀번호를 설정하세요
4
STEP 4
OpenClaw 초기 설정
AI 두뇌(ChatGPT)와 AI 몸(OpenClaw)을 연결하는 딱 한 번만 하면 되는 설정이에요.
⚙️ 설정하기 — 순서대로
- 1아래 "복사" 버튼 클릭
- 2터미널에서 마우스 우클릭 (붙여넣기)
- 3Enter 키 누르기
- 4아래 표를 보고 질문에 답하기
openclaw configure| 질문 | 입력할 내용 |
|---|---|
| AI Provider | anthropic 선택 (Enter) |
| API Key | 복사한 sk-ant-... 키 붙여넣기 |
| Model | claude-sonnet-4-6 (기본값 Enter) |
✅ 설정 확인 — 같은 방법으로
- 1아래 "복사" 버튼 클릭
- 2터미널에서 마우스 우클릭 (붙여넣기)
- 3Enter 키 누르기
openclaw status→ OK
✅
"OK"가 나오면 설정 완료! AI를 켤 준비 됐어요.
📸 설정 과정 미리보기 (클릭하면 확대)
① 설정 메뉴
② 모델 선택
③ 인증 화면
🚀
STEP 5
게이트웨이 시작 & 첫 대화!
드디어 AI를 켜볼 시간! 한 줄 입력하면 AI가 깨어나요!
🚀 터미널에서 시작 — 순서대로
- 1아래 "복사" 버튼 클릭
- 2터미널에서 마우스 우클릭 (붙여넣기)
- 3Enter 키 누르기 → AI가 시작돼요!
openclaw gateway start⚠️
터미널 창을 닫으면 AI도 꺼져요! 사용 중에는 열어두세요 (7단계에서 자동 시작 설정 가능)
🌐 브라우저에서 접속 — 순서대로
- 1크롬 또는 엣지 브라우저 열기
- 2아래 "복사" 버튼 클릭
- 3브라우저 주소창에 Ctrl+V (붙여넣기)
- 4Enter 키 누르기
http://127.0.0.1:18789🎉
대시보드가 열리면 성공! "안녕! 자기소개 해줘"라고 보내보세요
📱
STEP 6
텔레그램 연동 — 폰에서도 사용하기
텔레그램 연결하면 카카오톡처럼 폰에서 AI와 대화할 수 있어요!
① 텔레그램에서 봇 만들기
- 1@BotFather 검색 → 대화 시작
- 2
/newbot입력 - 3봇 이름 입력 (예:
내AI비서) - 4유저네임 입력 (영문, bot으로 끝남)
- 5받은 토큰 복사 → 메모장에 저장
③ 단톡방 사용 시: BotFather →
/mybots → Bot Settings → Group Privacy → Turn off⚠️
토큰은 비밀번호! 절대 타인에게 알려주지 마세요
② 터미널에서 연결 — 순서대로
- 1아래 "복사" 버튼 클릭
- 2터미널에서 마우스 우클릭 (붙여넣기)
- 3Enter 키 → 토큰 입력
openclaw configure --section telegram설정 후 같은 방법으로 재시작:
openclaw gateway restart✅
봇에게 "안녕"이라고 보내서 AI가 답하면 성공!
⚡
STEP 7
자동 시작 설정 — PC 켜면 AI도 자동으로!
이 설정을 하면 PC를 켤 때 AI도 자동으로 켜져요. 더 이상 터미널을 열 필요 없어요!
⚡ 자동 시작 등록 — 순서대로
- 1아래 "복사" 버튼 클릭
- 2터미널에서 마우스 우클릭 (붙여넣기)
- 3Enter 키 누르기
openclaw gateway install✅
이제 PC를 켜면 AI가 자동으로 시작돼요!
💡 참고 사항
🔄
PC 재시작 후 브라우저에서
http://127.0.0.1:18789 접속하면 바로 사용 가능!❌
자동 시작을 취소하고 싶으면?
같은 방법(복사 → 우클릭 → Enter)으로:
같은 방법(복사 → 우클릭 → Enter)으로:
openclaw gateway uninstall🆘
TROUBLESHOOTING
자주 나오는 오류 & 해결방법
| 오류 메시지 | 해결 방법 |
|---|---|
| npm not found ("npm"을(를) 찾을 수 없습니다) | Node.js가 설치되지 않았거나, 설치 후 터미널을 새로 열지 않은 경우예요. 해결법: ① 터미널 창을 완전히 닫기 ② 새 터미널 열기 ③ 다시 시도 안 되면 Node.js를 다시 설치(1단계)하고 PC 재시작 후 새 터미널에서 시도하세요. |
| API key invalid (API 키가 유효하지 않습니다) | API 키를 복사할 때 앞뒤에 공백(빈칸)이 붙었을 수 있어요. 해결법: API 키를 다시 복사한 후, 터미널에서 openclaw configure를 다시 실행해서 새로 입력하세요. |
| Authentication failed (인증 실패) | OAuth 인증 과정에서 오류가 발생한 경우예요. 해결법: ① 브라우저에서 해당 서비스에 로그인 되어있는지 확인 ② openclaw configure를 다시 실행 ③ 다른 브라우저로 시도 ▲ 인증 실패 시 나타나는 화면 — 다시 시도하세요 |
| 대시보드가 안 열려요 (페이지를 찾을 수 없음) | 확인 1: 터미널에서 openclaw gateway start를 먼저 실행했나요? (터미널 창이 열려 있어야 해요!)확인 2: 브라우저 주소가 정확히 http://127.0.0.1:18789인지 확인하세요. (https가 아니라 http예요!) |
| 텔레그램 봇이 응답 없음 | 확인 1: 터미널에서 게이트웨이가 실행 중인지 확인 (터미널 창이 열려 있어야 해요) 확인 2: BotFather에서 Privacy Mode를 OFF로 바꿨는지 확인 확인 3: 토큰을 정확히 입력했는지 확인 후 터미널에서 openclaw gateway restart 실행 |
| permission denied (권한이 거부되었습니다) | 터미널을 관리자 권한으로 열어야 해요. 해결법: Windows 키 → cmd 타이핑 → "명령 프롬프트"에서 우클릭 → "관리자 권한으로 실행" 클릭 |
✓
CHECKLIST
설치 완료 체크리스트
아래 항목을 클릭해서 완료 표시를 해보세요!
- Node.js 설치 완료 (
node --version확인) - OpenClaw 설치 완료 (
openclaw --version확인) - Claude API 키 발급 & 저장
- OpenClaw 초기 설정 완료 (
openclaw configure) - 게이트웨이 시작 & 대시보드 접속 확인
- 텔레그램 봇 연동 완료 (선택)
- 자동 시작 등록 완료 (선택)
🎉
AI 비서 설치 완료!
이제 AI에게 블로그를 쓰게 하고, 웹사이트를 만들고,
일정을 관리하게 해보세요. 가능성은 무한해요!
강사: 이신우 · 010-3343-4000 · 두온교육(주)