OpenClaw 윈도우 설치 방법 완벽 가이드 | WSL2로 쉽게 설치하기

작성일자 글쓴이

메타 설명: OpenClaw를 윈도우에서 설치하는 방법을 단계별로 안내합니다. WSL2를 활용한 쉽고 안정적인 설치 가이드를 확인하세요!

윈도우에서 OpenClaw 사용하기

OpenClaw는 강력한 개인 AI 어시스턴트 플랫폼입니다. 맥이나 리눅스에서는 바로 설치할 수 있지만, 윈도우에서는 어떻게 해야 할까요?

정답은 WSL2(Windows Subsystem for Linux 2)입니다! WSL2를 사용하면 윈도우에서도 리눅스 환경을 그대로 사용할 수 있어요.

이 가이드를 따라하면 10분 안에 OpenClaw를 설치할 수 있습니다!

왜 WSL2를 사용해야 할까요?

OpenClaw 공식 문서에서도 윈도우 사용자에게 WSL2를 강력히 권장합니다.

WSL2의 장점:

  • 리눅스와 동일한 환경으로 호환성 보장
  • Node.js, pnpm 등 도구가 완벽 작동
  • 설치가 간단함 (명령어 한 줄)
  • 네이티브 윈도우보다 안정적

네이티브 윈도우 설치는 테스트되지 않았고 도구 호환성 문제가 있을 수 있어요.

사전 준비 사항

설치를 시작하기 전에 다음을 확인하세요.

항목 요구사항
운영체제 Windows 10 (버전 2004 이상) 또는 Windows 11
Node.js 버전 22 이상
메모리 최소 4GB RAM 권장

준비되셨나요? 그럼 시작해볼게요!

1단계: WSL2 설치하기

WSL2 설치는 정말 간단합니다. PowerShell을 관리자 권한으로 실행하세요.

설치 명령어:

wsl --install

특정 배포판을 선택하고 싶다면:

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

설치 후 컴퓨터를 재부팅하세요. 재부팅 후 Ubuntu 터미널이 자동으로 열리며 사용자 설정을 진행합니다.

2단계: systemd 활성화하기

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

WSL 터미널에서 실행:

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

그 다음 PowerShell에서 WSL을 재시작합니다:

wsl --shutdown

다시 Ubuntu를 열고 확인:

systemctl --user status

에러 없이 출력되면 성공입니다!

3단계: Node.js 설치하기

OpenClaw는 Node.js 22 이상이 필요합니다.

nvm으로 Node.js 설치:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 22
node --version

v22.x.x가 출력되면 준비 완료!

4단계: OpenClaw 설치하기

이제 본격적으로 OpenClaw를 설치합니다.

방법 1: npm 글로벌 설치 (권장)

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

방법 2: 소스에서 빌드

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

onboard 명령어가 실행되면 설정 마법사가 시작됩니다!

5단계: 설정 마법사 진행하기

onboard 명령어 실행 후 다음을 설정합니다:

  • Gateway 설정 (로컬/원격)
  • AI 모델 인증 (API 키 또는 OAuth)
  • 채널 연결 (WhatsApp, Telegram, Discord 등)
  • 백그라운드 서비스 설치

설정이 완료되면 Gateway가 자동으로 실행됩니다.

6단계: 설치 확인하기

설치가 잘 되었는지 확인해보세요.

openclaw status
openclaw health

브라우저에서 http://127.0.0.1:18789/에 접속하면 Control UI가 열립니다!

LAN에서 접속하기 (선택사항)

다른 기기에서 WSL 내 Gateway에 접속하려면 포트 포워딩이 필요합니다.

PowerShell (관리자)에서:

$WslIp = (wsl -- hostname -I).Trim().Split(" ")[0]
netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=18789 connectaddress=$WslIp connectport=18789

WSL IP는 재시작할 때마다 바뀌므로 주의하세요!

자주 발생하는 문제 해결

설치 중 문제가 생겼다면 다음을 확인하세요.

  • WSL 버전 확인: wsl --version으로 WSL2인지 확인
  • Node 버전: v22 이상인지 확인
  • systemd 활성화: wsl.conf 설정 후 재시작했는지 확인
  • 진단 명령어: openclaw doctor 실행

마무리하며

WSL2를 활용하면 윈도우에서도 OpenClaw를 완벽하게 사용할 수 있습니다. 이제 여러분만의 AI 어시스턴트를 만들어보세요! 설치 중 궁금한 점이 있다면 댓글로 남겨주세요!

해시태그: OpenClaw, 윈도우설치, WSL2, AI어시스턴트, 개인AI, Windows, 리눅스, Ubuntu, 설치가이드, 개발환경

AI에 게시됨