OpenClaw for Windows 설정 하며

OpenClaw(과거 ClawdBot, MoltBot으로 불림)를 Windows에서 설정하는 가장 안정적인 방법은 WSL2(Windows Subsystem for Linux)를 사용하는 것입니다.

공식 문서와 커뮤니티에서는 Windows 네이티브(PowerShell) 설치도 지원하지만, 파일 시스템 성능과 도구 호환성 문제로 인해 WSL2 기반의 Ubuntu 환경에서 실행하는 것을 강력히 권장하고 있습니다.

사전 준비 (Prerequisites)

설치 전 아래 항목이 준비되어 있어야 합니다.

• WSL2 및 Ubuntu: Windows 10(버전 2004 이상) 또는 Windows 11.
• Node.js 22 이상: OpenClaw는 최신 Node.js 환경에서 작동합니다.
• Git 및 빌드 툴: 소스 관리 및 설치 스크립트 실행을 위해 필요합니다.

WSL2(Ubuntu) 환경에서 openclaw 설치 중 발생하는 이 오류는 주로 Node.js 버전 불일치나 권한 문제, 혹은 의존성 라이브러리(sharp 등)의 빌드 실패로 인해 발생합니다.

WSL 2 설치 단계별 절차:

1. 관리자 권한으로 터미널 실행: 윈도우 키를 누르고 'PowerShell' 또는 'cmd'를 검색하여 '관리자 권한으로 실행'을 클릭합니다.
2. 설치 명령어 입력: wsl --install -d Ubuntu-24.04을 입력하고 엔터를 칩니다.
   • 이 명령은 필요한 필수 구성 요소(가상 머신 플랫폼 등)를 활성화하고 최신 리눅스 커널을 설치합니다.
3. 컴퓨터 재부팅: 설치가 완료되면 컴퓨터를 다시 시작하여 설정을 완료합니다.
4. 리눅스 설정: 재부팅 후 자동으로 열리는 우분투(Ubuntu) 창에서 사용자 이름(Username)과 비밀번호(Password)를 설정하면 설치가 완료됩니다.

Node.js 버전 확인 및 업데이트 (가장 중요)

OpenClaw 최신 버전은 보통 Node.js 18 이상(LTS 권장)을 요구합니다. Ubuntu 기본 저장소의 Node 버전은 낮을 수 있으므로 확인이 필요합니다.

업데이트 방법 (nvm 사용 권장):

• curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
• source ~/.bashrc
• nvm install --lts
• nvm use --lts

아래 명령으로 버전을 확인합니다.

• 버전 확인: node -v

빌드 필수 도구 설치

npm install 과정에서 네이티브 모듈을 컴파일해야 할 때 git, python, make, g++ 등이 필요합니다.

sudo apt update
sudo apt install -y git cmake build-essential libvips-dev libvulkan-dev

OpenClaw 설치

이제 요구 사양을 충족했으므로 설치를 진행합니다. 아래 명령을 사용하는 것이 설치 및 설정 절차를 가이드 하므로 좋습니다.

curl -fsSL https://openclaw.ai/install.sh | bash

다음 절차에 따라 설정합니다.

1단계: 보안 경고 확인

◆ I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
  ○ Yes / ● No

→ Yes 선택

설명: OpenClaw은 개인용(1인 사용) 기본 설정입니다. 개인 PC에서 혼자 쓸 거니까 Yes를 선택합니다..

2단계: 온보딩 모드

Onboarding mode
  ● QuickStart
  ○ Manual

→ QuickStart 선택

설명: 기본 설정으로 빠르게 설정합니다. 세부 설정은 나중에 openclaw configure로 변경 가능합니다. Manual은 항목별 직접 선택이라 비숙련자에게 불필요합니다.

3단계: 모델/인증 선택

Model/auth provider
  ● OpenAI (Codex OAuth + API key)
  ○ Anthropic
  ...

→ OpenAI 선택 (GPT/ChatGPT 사용자인 경우)

설명: ChatGPT의 계정을 통해서 사용할 수 있습니다. 다른 경우, api key를 넣어야 할 수 있습니다.

---

4단계: 채널 선택

Select channel (QuickStart)
  ● Telegram (Bot API) (recommended · newcomer-friendly)
  ...

→ Telegram 선택

설명: OpenClaw이 연결될 메신저로, Telegram이 비숙련자에게 가장 간단하다.

---

5단계: 텔레그램 봇 토큰 생성 (가장 많이 막히는 단계)

온보딩에서 토큰을 요구합니다:

구체적 절차:

1. 텔레그램 앱 열기 (스마트폰 또는 데스크톱)
2. 상단 검색바에서 @BotFather 검색
3. BotFather와 대화 시작
4. /newbot 입력
5. 봇 이름 입력 (표시 이름, 아무거나 가능. 예: "내 AI 봇")
6. 봇 사용자명 입력 (고유해야 함, _bot으로 끝나야 함. 예: jaeyoung_test_bot)
7. 토큰이 나온다: 123456:ABC-DEF... 형태
8. 이 화면을 캡처해두기 — 토큰과 봇 사용자명이 모두 나옴
9. 토큰을 터미널 온보딩 화면에 붙여넣기

비숙련자 주의사항:

• BotFather는 봇을 만드는 곳이지, 만든 봇과 대화하는 곳이 아님
• 봇 사용자명은 전 세계에서 유일해야 하므로 이미 사용 중이면 다른 이름 시도
• 토큰은 비밀번호와 같으므로 공유하지 않기

---

6단계: 스킬 설치

◆ Install missing skill dependencies
  ◻ Skip for now
  ◻ 📝 apple-notes
  ...

→ Skip for now 선택

설명: 추가 기능(노트 연동, 이메일 등)인데 초기 설치에는 불필요합니다. 나중에 openclaw configure로 개별 추가 가능합니다. 선택지가 40개 넘어서 비숙련자에게 혼란을 줄 수 있으니 스킵이 최선입니다.

---

7단계: API 키 설정 (전부 No)

◆ Set GOOGLE_PLACES_API_KEY for goplaces? → No
◆ Set NOTION_API_KEY for notion? → No

→ 나오는 API 키 질문은 모두 No

설명: 외부 서비스 연동용 API 키입니다. 기본 사용에는 불필요합니다.

---

8단계: Hooks 설정

◆ Enable hooks?
  ◻ Skip for now
  ...

→ Skip for now 선택

설명: 자동화 기능으로 초기 설치에서는 불필요합니다.

---

9단계: 설치 완료 + Health Check

설치가 끝나면 대시보드 URL이 표시됩니다:

Dashboard link: http://127.0.0.1:18789/#token=...

Health check 실패가 나올 수 있습니다:

Health check failed: gateway closed (1006 abnormal closure)

→ 당황하지 말 것. 게이트웨이가 아직 기동 중일 수 있습니다. 잠시 후 확인합니다:

openclaw status

Gateway 항목에 reachable이 보이면 정상입니다.

Telegram Pairing

OpenClaw에서 Channel을 Telegram으로 설정해 두고, Bot과 대화창을 열어 대화를 합니다. 아래와 유사한 메시지가 나오는데, wsl 창에 Paring을 해야 최종 마무리가 됩니다.

OpenClaw: access not configured.

Your Telegram user id: XXXXXXXXXX

Pairing code: ABCDEFGH

Ask the bot owner to approve with:
openclaw pairing approve telegram ABCDEFGH

현재 OpenClaw가 설치된 WSL2(Ubuntu) 터미널로 돌아가서 아래 명령어를 그대로 복사하여 입력하세요.

openclaw pairing approve telegram ABCDEFGH

대화를 시작하면, 여러 분의 AI 비서가 응답하기 시작합니다.

OpenClaw 설정

설치가 되고, 설정을 하는 도중 문제가 많이 있을 수 있습니다. 이 때에는 설정만 다시 해도 괜찮은 경우가 많습니다.

아래 명령을 통해서 다양한 설정을 할 수 있습니다. 최소한은 LLM 설정(Model)과 통신(Channels) 만 살펴 보면 기본 동작이 가능합니다.

openclaw configure

특정 설정만 하는 방법도 가능합니다. LLM API 연결 하는 방법은 다음 명령을 통해 할 수 있습니다. 다양한 LLM과 연계가 가능합니다. 버전마다 변화가 있지만, ChatGPT의 경우는 로그인으로도 가능하고, Gemini는 api key로 연계가 가능합니다.

openclaw configure --section model

리부팅시 서비스 자동 활성화

여러 분의 Windows PC에 Node.js 기반 서비스를 관리하는 PM2를 설치해 두시면 매우 편리합니다. 서비스가 죽으면 자동으로 살려주기도 합니다.

# PM2 설치
npm install -g pm2

# OpenClaw를 PM2로 실행
pm2 start openclaw --name "openclaw-agent"

# 부팅 시 자동 시작 설정
pm2 save

pm2를 이용해서 실행하는 스크립트를 만듭니다. 터미널에서 아래 단계들을 순서대로 따라하시면 됩니다.

wsl 화면에서 스크립트 파일 생성 하기 입니다. cat 명령어를 사용하면 복사 붙여넣기로 파일 내용을 한 번에 입력할 수 있어 편리합니다.

cat << 'EOF' > start_openclaw.sh
#!/bin/bash
# nvm 환경 로드 (nvm 경로가 다를 수 있으니 확인 필요)
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
# PM2로 저장된 리스트 복구
pm2 resurrect
EOF

역시, wsl 화면에서 추가한 파일에 실행 권한 추가 하기입니다. 파일을 실행할 수 있도록 권한을 수정합니다.

chmod +x start_openclaw.sh

스크립트 실행 확인해봅시다. 이제 아래 명령어로 스크립트가 정상적으로 작동하는지 테스트해 보세요.

./start_openclaw.sh

Windows가 부팅될 때 WSL2를 백그라운드에서 살짝 건드려 PM2를 깨우는 스케줄러를 등록해야 합니다.

1. Windows 키 + R을 누르고 taskschd.msc를 입력하여 작업 스케줄러를 엽니다.
2. 오른쪽 "기본 작업 만들기..." 를 클릭합니다.
   • 이름: WSL PM2 AutoStart (원하시는 이름)
   • 트리거: 컴퓨터 시작 시
   • 동작: 프로그램 시작
3. 프로그램/스크립트 칸에 아래 내용을 입력합니다.
   • wsl
4. 인수 추가(옵션) 칸에 아래 명령어를 그대로 복사해서 넣습니다.
   • -e bash -c "/home/blckt/start_openclaw.sh"
5. "마침을 클릭할 때 이 작업의 속성 대화 상자 열기"를 활성화 하고 마침을 엽니다. 여기서 일반 탭에서 "사용자의 로그온 여부에 관계 없어 실행"을 활성화 하고 조건 탭에서 "컴퓨터의 AC 전원이 켜져 있는 경우에만 작업 시작" 선택을 비활성화 합니다. 이렇게 해야 조건 없이 실행이 됩니다.

마치며

이번 설정을 진행하며 가장 크게 다가온 장점은 ‘장소의 제약이 사라진 AI 컴퓨팅 리소스의 활용’이었습니다.

단순히 클라우드 AI를 쓰는 것을 넘어, 집에서 24시간 깨어 있는 내 PC의 강력한 성능과 내부 데이터를 외부에서도 마치 곁에 있는 것처럼 자유롭게 꺼내 쓸 수 있다는 점이 정말 매력적입니다. 복잡한 네트워크나 원격 설정을 거쳐 구축한 이 환경은, 단순한 소프트웨어 설치가 아니라 어디서든 연결 가능한 '나만의 AI 기지'를 세우는 과정과 같습니다.

내 컴퓨팅 환경이 상시 대기하며 나를 보조한다는 든든함, 이것이야말로 우리가 지향하는 진정한 Personal AI Computing에 한 걸음 더 다가선 모습이 아닐까 싶습니다. 여러분도 이 설정을 통해 공간의 한계를 넘어선 스마트한 워크플로우를 꼭 구축해 보시길 바랍니다.