왕초보도 깔아 쓰는 오픈클로(OpenClaw)설명서"OpenClaw for Absolute Beginners: Install & Use Guide"

🤖 OpenClaw 왕초보 가이드

소개 설치 실전 데모 보안 FAQ

🔥 2026 최신 버전 · 왕초보 전용

코딩 몰라도 OK! 오픈클로 5분 만에 AI 비서 완성 🚀

팩트로 오픈클로(OpenClaw) 왕초보도 깔아 쓴다!
네이버·쿠팡 자동화, 카톡처럼 쓰는 AI 비서 — 지금 시작하세요.

5분 설치 완료

0원 무료 시작

24/7 AI 비서 가동

100% 로컬 보안

⚡ 지금 바로 5분 설치 시작

WHY OPENCLAW

당신이 포기했던 이유, 다 압니다 💭

AI 도구 써보려다 막혔던 경험? 오픈클로는 달라요.

😵

코딩 1도 모름

Python? Node.js? 그게 뭔지조차 모르겠는 분들

🌍

영어 설명만 있음

공식 문서 열면 영어만 가득, 번역기 돌려도 모르겠음

💸

ChatGPT 비용 부담

월 구독료, API 비용... 무료로 쓸 방법 없나요?

🔒

개인정보 유출 걱정

클라우드에 데이터 올리면 해킹될까봐 무서워요

🎯 오픈클로가 한 번에 해결합니다

복사-붙여넣기 3번 → 자연어 명령 → 로컬 실행 → 완전 무료 시작 가능
한국어 완벽 지원 · 네이버/쿠팡 실무 예시 · 데이터 외부 전송 ZERO

📥 Node.js 설치 1분

→

⌨️ 터미널 명령 1분

→

🔑 API 키 입력 2분

→

🚀 AI 비서 시작! 완료

STEP-BY-STEP

⚡ 5분 완성 설치 가이드

각 단계를 순서대로 따라하세요. 막히는 곳 없이 완주 가능합니다!

1

Node.js 설치하기

⏱ 약 1분

오픈클로를 돌리려면 Node.js라는 프로그램이 필요해요. 마치 카카오톡이 실행되려면 안드로이드/iOS가 필요한 것처럼요!

💡

이미 설치되어 있나요?

터미널에서 node --version 입력 후 v18 이상이 나오면 이 단계 건너뛰세요 ✓

• nodejs.org 접속 → 초록색 "LTS 다운로드" 버튼 클릭
• 설치 파일 실행 → "Next"를 계속 눌러서 설치 완료
• 설치 완료 후 컴퓨터 재시작 없이 바로 다음 단계로!

https://nodejs.org/ko/download

🟢

Node.js 22.x LTS
대부분의 사용자에게 권장

← 이 버튼만
클릭하면 됩니다!

2

터미널(명령 프롬프트) 열기

⏱ 30초

"터미널? 해커 화면 같은 거?" — 맞아요! 근데 우리가 쓸 명령은 딱 3줄뿐이에요 😄

🪟 Windows

• Win + R 키 누르기
• cmd 입력 후 엔터
• 검은 창이 열리면 성공!

🍎 Mac

• Cmd + Space 누르기
• Terminal 검색 후 열기
• 흰 창이 열리면 성공!

⚠️

오류가 나요?

에러 메시지 전체를 복사해서 FAQ 섹션의 문제해결 표를 확인하세요. 99%의 오류는 이미 해결법이 있어요!

3

오픈클로 프로젝트 생성

⏱ 약 1~2분

아래 코드를 복사해서 터미널에 붙여넣기(Ctrl+V) 후 Enter! 그게 전부예요.

터미널 (Terminal / CMD)

# ① 오픈클로 프로젝트 새로 만들기 (my-ai 폴더 생성)
npm create claw@latest my-ai

# ② 생성된 폴더로 이동
cd my-ai

# ③ 필요한 패키지 설치
npm install

# ④ 서버 실행!
npm run dev

✅

성공 화면은?

터미널에 Local: http://localhost:3000 같은 주소가 뜨면 완성! 그 주소를 브라우저 주소창에 붙여넣으세요.

Terminal

$ npm create claw@latest my-ai

✔ Project created successfully!

$ npm run dev

  ▲ OpenClaw ready
  ➜ Local:   http://localhost:3000
  ➜ Network: http://192.168.0.x:3000

4

무료 API 키 발급 (Gemini 추천)

⏱ 약 2분

AI가 실제로 대답하려면 "두뇌" 역할을 하는 API 키가 필요해요. 구글 Gemini는 무료로 시작할 수 있어요! (신용카드 불필요)

• aistudio.google.com 접속 → 구글 계정으로 로그인
• 좌측 메뉴 → "Get API Key" 클릭
• "Create API Key" 버튼 → 키 복사 (AIza로 시작하는 긴 문자열)
• 오픈클로 브라우저 화면 → 설정(⚙️) → API Key 입력란에 붙여넣기

🔑

API 키는 비밀번호예요!

절대로 카카오톡·문자·이메일로 공유하지 마세요. 유출 시 요금이 청구될 수 있어요. 내 컴퓨터에만 보관하세요.

AI 모델	무료 여부	속도	추천 용도
🥇 Gemini Flash	완전 무료	매우 빠름	왕초보 시작용 ⭐
Gemini Pro	무료 한도 있음	빠름	일반 업무 자동화
Claude Haiku	소액 과금	빠름	한국어 분석
GPT-4o	유료	보통	고급 분석

5

첫 AI 명령 보내보기 🎉

⏱ 10초

브라우저에서 채팅창에 자연어로 말을 걸어보세요. 마치 카카오톡처럼요!

🙋

오늘 서울 날씨 알려줘

🤖

🌤 오늘 서울 날씨
현재 기온: 23°C
오후 최고: 27°C
흐리다가 저녁에 맑아질 예정이에요!

🙋

네이버 쇼핑 피트니스 매트 베스트 5개 분석해줘

🤖

분석 중...

🎊

설치 완료! 축하합니다!

총 소요 시간: 5분 이내. 이제 당신만의 AI 비서가 24시간 대기 중이에요. 아래에서 실전 활용법을 확인하세요!

REAL USAGE

🇰🇷 한국 실전 활용 예시

카피해서 바로 써먹을 수 있는 실무 명령어 모음!

기본

일상 정보 검색

"오늘 환율 달러 → 원화 알려줘"

💱 실시간 환율 조회 → 정리된 표로 출력

한국 실무

네이버 쇼핑 분석

"네이버 '피트니스 매트' 상위 10개 리뷰 긍부정 분석 엑셀 저장"

📊 상품별 리뷰 감성 분석 → Excel 파일 자동 생성

자동화

쿠팡 베스트셀러 요약

"매일 아침 9시 쿠팡 베스트셀러 TOP5 요약해서 슬랙 보내"

⏰ 스케줄 등록 → 자동 크롤링 → Slack 발송

한국 실무

블로그 글쓰기 자동화

"티스토리 '맛집 후기' SEO 최적화 글 2000자 초안 써줘"

✍️ 키워드 분석 → 목차 생성 → 전체 초안 완성

자동화

경쟁사 모니터링

"주 1회 경쟁사 A 홈페이지 가격 변동 체크 후 카카오톡 알림"

🔍 자동 모니터링 → 변동 감지 시 즉시 알림

기본

문서 분석·요약

"이 PDF 계약서 핵심 조항 5개만 한 페이지로 요약해줘"

📄 PDF 업로드 → AI 분석 → 핵심 요약 출력

📈 오픈클로로 줄어드는 업무 시간

리뷰 분석

-88%

가격 모니터링

-95%

블로그 초안

-75%

데이터 정리

-90%

ADVANCED

🚀 고급 팁: 차원이 다른 활용법

기본 설치가 끝났다면 이것까지 해보세요!

📱

텔레그램 연동 (모바일에서 AI 명령!)

💜 5분 추가 설정

텔레그램 봇을 연결하면 스마트폰에서도 AI 비서를 사용할 수 있어요!

• 텔레그램 앱 → @BotFather 검색 → 채팅
• /newbot 입력 → 봇 이름 설정
• 발급받은 토큰(Token) 복사
• 오픈클로 설정 → Telegram Token 입력 → 저장

.env 파일 설정

# .env 파일에 추가
TELEGRAM_BOT_TOKEN=여기에_텔레그램_봇_토큰_붙여넣기
GEMINI_API_KEY=여기에_Gemini_API_키_붙여넣기

⏰

자동 스케줄러 설정

🔄 한 번 설정 = 영구 자동화

매일 반복되는 작업을 자동화! 크론탭(Cron) 문법으로 원하는 시간에 자동 실행돼요.

스케줄 예시 (cron 문법)

# 매일 오전 9시 - 쿠팡 베스트셀러 수집
0 9 * * *  쿠팡 베스트셀러 TOP10 요약 후 슬랙 전송

# 매주 월요일 오전 8시 - 경쟁사 가격 비교
0 8 * * 1  경쟁사 A,B,C 가격 비교 리포트 이메일 발송

# 매달 1일 자정 - 월간 리포트
0 0 1 * *  지난달 판매 데이터 분석 후 엑셀 저장

SECURITY

🔒 보안: 내 데이터 100% 안전하게

오픈클로의 핵심 강점 — 완전 로컬 실행으로 개인정보 유출 ZERO!

🏠

100% 로컬 실행

모든 데이터가 내 컴퓨터 안에서만 처리됩니다. 외부 서버로 전송 없음.

🔐

API 키 암호화

API 키는 로컬 .env 파일에만 저장. 절대 외부로 노출되지 않아요.

👁️‍🗨️

오픈소스 투명성

모든 코드가 GitHub에 공개. 백도어 없음을 누구나 검증 가능.

🚫

광고·추적 없음

사용 데이터 수집 없음. 분석 코드 없음. 순수하게 당신만의 도구.

🛡️ 반드시 지켜야 할 보안 수칙

🚨

절대 하면 안 되는 것들!

① .env 파일을 GitHub에 올리지 마세요 — API 키가 전 세계에 공개됩니다
② API 키를 채팅·메시지로 공유하지 마세요 — 화면 공유 시에도 주의
③ 공공 와이파이에서 API 키 발급하지 마세요 — 패킷 도청 위험
④ "무료 오픈클로 키 나눔" 사기 조심 — 피싱 사이트 100%

✅

이것만 하면 완벽한 보안!

① .gitignore에 .env 추가 (프로젝트 생성 시 자동 설정됨)
② API 키 정기 교체 — 3개월마다 새 키 발급 권장
③ API 사용량 알림 설정 — 이상 사용 즉시 감지
④ 사용하지 않을 때 서버 종료 — 터미널에서 Ctrl+C

.gitignore 설정 (GitHub 업로드 보안)

# .gitignore 파일에 이 내용 추가
.env
.env.local
.env.production
node_modules/
*.log

TROUBLESHOOT

🔧 여기서 막히면? 99% 해결법

가장 많이 나오는 오류와 해결법 모음!

오류 메시지	원인	해결법
'npm' is not recognized	Node.js 미설치	nodejs.org에서 재설치 후 터미널 재시작
EACCES permission denied	권한 부족	Windows: 관리자 권한 CMD / Mac: sudo 앞에 붙이기
Error: Invalid API Key	API 키 오류	키 앞뒤 공백 제거 후 재입력. 새 키 발급 권장
Port 3000 already in use	다른 프로그램이 포트 점유	npm run dev -- --port 3001 로 다른 포트 사용
Cannot find module	패키지 미설치	npm install 재실행 후 npm run dev
브라우저 빈 화면	캐시 문제	Ctrl+Shift+R (강제 새로고침) / 다른 브라우저 시도

FAQ

❓ 자주 묻는 질문

설치 전에 꼭 읽어보세요!

💰 완전 무료인가요? 나중에 요금이 청구되지 않나요? +

오픈클로 자체는 완전 무료 오픈소스입니다. 다만 연결하는 AI API에 따라 비용이 발생할 수 있어요. Gemini Flash API는 무료 한도가 매우 넉넉해서 개인 사용자는 거의 무료로 쓸 수 있어요. (하루 1,500회 요청 무료) 대량 자동화가 필요한 경우에만 소액 과금이 발생합니다.

🍎 Mac에서도 똑같이 설치하면 되나요? +

네, Windows와 Mac 모두 동일한 방법으로 설치 가능합니다. 터미널을 여는 방법만 다를 뿐(Mac: 터미널 앱, Windows: CMD), npm 명령어는 동일해요. Mac에서 권한 오류가 나면 명령어 앞에 sudo를 붙여보세요.

📱 스마트폰에서도 쓸 수 있나요? +

설치는 PC/Mac에서 해야 하지만, 텔레그램 봇 연동 후에는 스마트폰 텔레그램 앱에서 AI 명령이 가능합니다. 또한 서버 실행 중에는 같은 와이파이의 스마트폰 브라우저에서도 접속 가능해요 (http://내IP:3000).

🔒 내 데이터가 외부로 나가지 않나요? +

오픈클로 자체는 100% 로컬에서 실행되어 데이터가 외부로 나가지 않습니다. 단, AI에게 보내는 텍스트 메시지는 API를 통해 Google(Gemini) 또는 Anthropic(Claude) 서버로 전송됩니다. 민감한 개인정보나 기업 기밀은 AI 채팅에 직접 입력하지 마세요.

⚡ 컴퓨터를 끄면 AI 비서도 꺼지나요? +

네, 기본 설정에서는 컴퓨터를 끄면 서버도 종료됩니다. 24시간 운영이 필요하다면 클라우드 서버(VPS)에 배포하는 방법이 있어요. Hostinger VPS (월 약 3~5달러)를 추천드립니다. 자동화 스케줄러 사용 시에는 VPS 배포를 권장해요.

🆙 업데이트는 어떻게 하나요? +

터미널에서 프로젝트 폴더로 이동 후 npm update 입력! 최신 버전 확인은 GitHub 공식 저장소를 즐겨찾기 해두고 Releases 탭을 주기적으로 확인하세요. 주요 업데이트는 이 블로그에서도 안내드릴 예정이에요!

지금 바로 시작하세요! 🚀

설치 완료까지 딱 5분. 오늘 밤 당신만의 AI 비서가 가동됩니다.

⚡ 5분 설치 시작 📁 GitHub 보기

📋 이 가이드 핵심 요약

• Node.js 설치 — nodejs.org에서 LTS 버전 다운로드
• npm create claw@latest my-ai — 오픈클로 프로젝트 생성
• Gemini API 키 무료 발급 — aistudio.google.com에서 즉시 발급
• npm run dev — 로컬 서버 실행 → 브라우저 접속
• 자연어 명령 — 한국어로 그냥 말하면 AI가 처리
• 텔레그램 연동 — 스마트폰에서도 어디서나 사용
• 보안 수칙 — .env 파일 보호 + API 키 절대 공유 금지

📖 팩트로 오픈클로 왕초보도 깔아 쓴다 — 왕초보 전용 완벽 가이드 2026

본 가이드의 명령어·코드는 자유롭게 사용하세요 · 정기 업데이트 제공

⚠️ API 키는 개인 책임 하에 관리하세요. 본 가이드는 공식 OpenClaw 문서를 기반으로 제작되었습니다.