Windows에 OpenClaw 설치하기 - WSL2, PowerShell 완벽 가이드

핵심 요약

방법	추천도	설명
WSL2 (권장)	⭐⭐⭐	Ubuntu에서 리눅스처럼 사용
PowerShell 설치	⭐⭐	네이티브 Windows 설치
Docker	⭐	컨테이너로 실행

---

방법 1: WSL2 설치 (권장)

OpenClaw은 Windows에서 WSL2(Windows Subsystem for Linux)를 통해 사용하는 것을 권장합니다. 리눅스 환경 그대로 사용할 수 있어서 호환성 문제가 적습니다.

Step 1: WSL2 + Ubuntu 설치

PowerShell (관리자 권한)으로 실행:

wsl --install

또는 특정 배포판 선택:

wsl --list --online
wsl --install -d Ubuntu-24.04

설치 후 재부팅이 필요할 수 있습니다.

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

Gateway 서비스 설치를 위해 systemd를 활성화해야 합니다.

WSL 터미널에서:

sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF

PowerShell에서 WSL 재시작:

wsl --shutdown

Ubuntu 다시 열고 확인:

systemctl --user status

Step 3: Node.js 22+ 설치

WSL Ubuntu 터미널에서:

# NodeSource 저장소 추가
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# Node.js 설치
sudo apt-get install -y nodejs

Step 4: OpenClaw 설치

방법 A - 인스톨러 (간편):

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

방법 B - npm 직접 설치:

npm install -g openclaw@latest
openclaw onboard --install-daemon

방법 C - 소스에서 설치 (개발자용):

git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install -g pnpm
pnpm install
pnpm ui:build
pnpm build
openclaw onboard --install-daemon

Step 5: 설치 확인

openclaw doctor
openclaw status

---

방법 2: PowerShell 설치 (네이티브)

WSL 없이 Windows에서 직접 설치하는 방법입니다.

Step 1: Node.js 22+ 설치

winget 사용:

winget install OpenJS.NodeJS.LTS

또는 Chocolatey:

choco install nodejs-lts

또는 https://nodejs.org 에서 직접 다운로드

Step 2: Git 설치

winget install Git.Git

또는 https://git-scm.com/download/win 에서 다운로드

설치 후 PowerShell 새로 열기!

Step 3: OpenClaw 설치

PowerShell에서:

iwr -useb https://openclaw.ai/install.ps1 | iex

또는 npm 직접:

npm install -g openclaw@latest
openclaw onboard --install-daemon

Step 4: PATH 문제 해결

openclaw을 찾을 수 없다는 오류가 발생하면:

# npm 글로벌 경로 확인
npm config get prefix

출력된 경로 (예: C:\Users\사용자명\AppData\Roaming\npm)를 시스템 환경 변수 PATH에 추가 후 PowerShell 재시작

---

방법 3: Docker

docker pull ghcr.io/openclaw/openclaw:latest
docker run -it ghcr.io/openclaw/openclaw:latest openclaw --help

---

흔한 문제 해결

1. spawn git ENOENT 오류

해결: Git for Windows 설치 후 PowerShell 재시작

2. openclaw not recognized 오류

해결: npm 글로벌 경로를 PATH에 추가

# 경로 확인
npm config get prefix
# 출력: C:\Users\사용자명\AppData\Roaming\npm
# 이 경로를 시스템 PATH에 추가

3. WSL에서 Gateway 외부 접근 안 됨

해결: WSL은 자체 네트워크 사용. 외부 접근 필요시 포트 포워딩:

# PowerShell (관리자)
$WslIp = (wsl -- hostname -I).Trim().Split(" ")[0]
netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=3000 connectaddress=$WslIp connectport=3000

---

설치 후 체크리스트

# 1. 상태 확인
openclaw doctor

# 2. Gateway 상태
openclaw status

# 3. 대시보드 열기
openclaw dashboard

# 4. 설정
openclaw configure

---

결론

추천: WSL2 + Ubuntu가 가장 안정적입니다! 리눅스 환경 그대로 쓸 수 있어서 문제도 적고, 대부분의 스킬과 도구가 호환됩니다.

네이티브 Windows 설치도 가능하지만, 일부 기능에서 호환성 이슈가 있을 수 있습니다.

---

공식 문서: https://docs.openclaw.ai

GitHub: https://github.com/openclaw/openclaw

관련 키워드: OpenClaw, Windows 설치, WSL2, AI 에이전트, Claude, 자동화