OpenClaw 윈도우 설치 완벽 가이드 2026 | WSL2로 나만의 AI 비서 만들기

작성일자 글쓴이

내 컴퓨터에서 돌아가는 개인 AI 비서를 만들고 싶으신가요? 🤔 오늘은 OpenClaw를 윈도우에 설치하는 방법을 완벽하게 정리해 드릴게요!

OpenClaw란? 🦞

OpenClaw(오픈클로)는 내 컴퓨터에 설치하는 개인 AI 비서예요. 이전에는 ClawdBot(클로드봇), MoltBot(몰트봇)이라는 이름으로도 불렸어요. 모두 같은 프로젝트입니다!

OpenClaw로 할 수 있는 것들

  • 메신저 연동: 텔레그램, 왓츠앱, 디스코드, 슬랙으로 AI와 대화
  • 일정 관리: 캘린더 연동 및 알림
  • 웹 검색: 실시간 정보 검색
  • 파일 작업: 파일 정리, 문서 작성
  • 자동화: 반복 작업 자동 실행

오픈소스라서 무료로 시작할 수 있어요! (단, AI 모델 API 비용은 별도)

왜 WSL2가 필요할까요? 🤔

OpenClaw는 Linux 기반 도구들에 의존해요. 그래서 윈도우에서 직접 실행하는 것보다 WSL2(Windows Subsystem for Linux)를 통해 Ubuntu 환경에서 실행하는 것이 공식적으로 권장됩니다.

WSL2를 사용하면:

  • 윈도우 옆에서 완전한 Linux 환경 실행
  • OpenClaw가 의도대로 안정적으로 작동
  • 시스템 서비스, 패키지 관리 등 Linux 기능 활용 가능

시스템 요구사항 💻

  • OS: Windows 10 또는 Windows 11 (64비트)
  • Node.js: 버전 22 이상 필수!
  • WSL2: Ubuntu 설치 필요
  • 인터넷 연결
  • 관리자 권한: 초기 설정에 필요

⚠️ 중요: Node.js 22 미만 버전은 설치 또는 온보딩 중 오류가 발생할 수 있어요!

준비물 체크리스트 ✅

  1. Node.js – nodejs.org에서 LTS 22+ 버전 다운로드
  2. Git – git-scm.com에서 다운로드
  3. 텔레그램 계정 – 봇 연동용
  4. Claude API Key – console.anthropic.com에서 발급

Step 1: WSL2와 Ubuntu 설치 🐧

1.1 PowerShell 관리자 권한으로 실행

시작 메뉴에서 “PowerShell” 검색 → “관리자로 실행” 클릭

1.2 WSL과 Ubuntu 설치

# WSL 설치 (Ubuntu 24.04 포함)
wsl --install -d Ubuntu-24.04

💡 팁: 설치 후 컴퓨터 재시작이 필요할 수 있어요!

1.3 Ubuntu 초기 설정

  1. 시작 메뉴에서 “Ubuntu” 실행
  2. 사용자 이름 입력 (영문 소문자 권장)
  3. 비밀번호 설정 (입력해도 화면에 안 보이는 게 정상!)

프롬프트가 사용자이름@DESKTOP-XXXXX:~$ 형태로 바뀌면 성공이에요!

Step 2: systemd 활성화 (필수!) ⚙️

OpenClaw는 Gateway 서비스 관리를 위해 systemd가 필요해요.

Ubuntu 터미널에서:

# systemd 설정 파일 생성
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF

PowerShell에서 WSL 재시작:

# Ubuntu 창 닫고 PowerShell에서 실행
wsl --shutdown

다시 Ubuntu 열고 확인:

systemctl --user status

Step 3: 필수 도구 설치 🛠️

Ubuntu 터미널에서 순서대로 실행하세요:

# 시스템 업데이트 및 기본 도구 설치
sudo apt update
sudo apt install -y git curl

# Node.js 22 설치
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 버전 확인
node -v   # v22.x.x가 나와야 해요!
npm -v

Step 4: OpenClaw 설치 🦞

방법 1: 설치 스크립트 (권장) ⭐

# 설치 스크립트 실행
curl -fsSL https://openclaw.ai/install.sh | bash

# 환경 새로고침
exec bash

# 온보딩 시작
openclaw onboard --install-daemon

방법 2: npm으로 직접 설치

# npm으로 전역 설치
npm install -g openclaw@latest

# 온보딩 시작
openclaw onboard --install-daemon

방법 3: 소스에서 빌드 (개발자용)

# 저장소 클론
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# pnpm 설치 및 빌드
npm install -g pnpm
pnpm install
pnpm ui:build
pnpm build

# 온보딩
openclaw onboard --install-daemon

Step 5: OpenClaw 설정 마법사 🧙‍♂️

openclaw onboard --install-daemon을 실행하면 설정 마법사가 시작돼요.

주요 설정 항목

  • 기본 AI 모델: Claude (anthropic/claude-opus-4-5) 권장
  • 채널 선택: telegram, whatsapp, discord, slack 중 선택
  • Node 관리자: npm 선택
  • 스킬(플러그인): 나중에 추가 가능하니 Skip 가능

Step 6: 텔레그램 봇 만들기 🤖

텔레그램과 연동하려면 봇을 만들어야 해요.

BotFather로 봇 생성

  1. 텔레그램에서 @BotFather 검색
  2. /newbot 입력
  3. 봇 이름 입력 (예: My OpenClaw)
  4. 봇 username 입력 (반드시 bot으로 끝나야 함, 예: myopenclaw_bot)
  5. BotFather가 보내주는 토큰 복사 (123456:ABC-DEF... 형태)

토큰 입력

온보딩 중 "Enter Telegram bot token" 화면에서:

  1. 토큰을 Ctrl+C로 복사
  2. Ubuntu 창에서 마우스 오른쪽 클릭으로 붙여넣기 (Ctrl+V 아님!)
  3. Enter 누르기

Step 7: 페어링 및 첫 대화 💬

봇에게 첫 메시지 보내기

  1. 텔레그램에서 만든 봇 검색 (예: @myopenclaw_bot)
  2. "시작(Start)" 버튼 클릭
  3. 아무 메시지나 보내기

페어링 승인

보안을 위해 페어링 승인이 필요해요. 봇이 페어링 코드를 보여주면:

# 페어링 코드가 ABC123이라면
openclaw pairing approve telegram ABC123

승인이 완료되면 이제 AI와 대화할 수 있어요! 🎉

설치 확인 명령어 ✅

# 환경 상태 점검
openclaw doctor

# Gateway 상태 확인
openclaw status

# 대시보드 열기 (브라우저에서)
openclaw dashboard

# 헬스 체크
openclaw health

자주 하는 실수 주의! ⚠️

  • ❌ Windows CMD에서 직접 OpenClaw 실행하지 마세요
  • ❌ systemd 설정을 건너뛰지 마세요
  • ❌ Node.js 22 미만 버전 사용하지 마세요
  • ❌ 비공식 실행 파일 다운로드하지 마세요
  • ❌ Gateway 포트를 방화벽 설정 없이 외부 노출하지 마세요

트러블슈팅 🔧

openclaw 명령어를 찾을 수 없을 때

# PATH 확인
node -v
npm -v
npm prefix -g
echo "$PATH"

# PATH에 npm 전역 경로 추가 (~/.bashrc에 추가)
export PATH="$(npm prefix -g)/bin:$PATH"

# 적용
source ~/.bashrc

WSL로 돌아가기

# PowerShell에서
wsl

# 또는 시작 메뉴에서 Ubuntu 실행

유용한 명령어 모음 📋

# Gateway 시작/중지/재시작
openclaw gateway start
openclaw gateway stop
openclaw gateway restart

# 로그 확인
openclaw gateway logs

# 설정 확인
openclaw config show

# 업데이트
npm update -g openclaw@latest

전체 설치 흐름 요약 📊

  • 1단계: Node.js, Git 설치 (Windows)
  • 2단계: Claude API Key 발급 (웹)
  • 3단계: WSL + Ubuntu 설치 (PowerShell 관리자)
  • 4단계: systemd 활성화 (Ubuntu)
  • 5단계: OpenClaw 설치 스크립트 실행 (Ubuntu)
  • 6단계: 온보딩 실행 (Ubuntu)
  • 7단계: 텔레그램 봇 생성 + 토큰 입력 (텔레그램 + Ubuntu)
  • 8단계: 페어링 승인 후 대화 시작!

마치며: 나만의 AI 비서 완성! 🎯

축하해요! 이제 윈도우 PC에서 나만의 AI 비서가 돌아가고 있어요. 텔레그램만 열면 어디서든 AI와 대화할 수 있죠!

OpenClaw는 오픈소스 프로젝트라서 빠르게 발전하고 있어요. 공식 문서(docs.openclaw.ai)도 참고해 보세요.

궁금한 점이 있으시면 댓글로 남겨주세요 😊