Windows 10/11

Windows에 OpenClaw 설치

Docker Desktop을 사용하여 몇 분 만에 Windows PC에서 OpenClaw(구 Moltbot)을 실행하세요.

사전 요구 사항

설치 단계

Windows용 Docker Desktop을 다운로드하고 설치하세요. OpenClaw 실행에 필요한 컨테이너 런타임을 제공합니다.

winget install Docker.DockerDesktop

더 나은 성능을 위해 Windows Subsystem for Linux 2를 활성화하세요. Docker Desktop이 자동으로 이를 사용합니다.

wsl --install

PowerShell 또는 터미널을 열고 공식 OpenClaw Docker 이미지를 가져오세요.

docker pull openclaw/openclaw:latest

OpenClaw 설정과 데이터를 저장할 폴더를 만드세요.

mkdir $env:USERPROFILE\.openclaw

설정 디렉토리를 마운트하여 Docker로 OpenClaw을 시작하세요.

docker run -d --name openclaw \
  -v $env:USERPROFILE\.openclaw:/root/.openclaw \
  -p 3000:3000 \
  openclaw/openclaw:latest

브라우저를 열고 OpenClaw 대시보드로 이동하여 설정을 완료하세요.

http://localhost:3000

⚠️ Windows의 일반적인 문제

Docker가 시작되지 않나요?

Hyper-V와 WSL2가 활성화되어 있는지 확인하세요. 관리자 PowerShell에서 bcdedit /set hypervisorlaunchtype auto를 실행하고 재시작하세요.

포트 3000이 이미 사용 중인가요?

포트 매핑을 변경하세요: 대신 -p 3001:3000를 사용하세요.

성능이 느린가요?

더 나은 파일 시스템 성능을 위해 Docker Desktop 설정에서 WSL2 백엔드를 활성화하세요.

대안: WSL2에서 네이티브 실행

더 나은 성능을 위해 WSL2 Ubuntu에 OpenClaw을 직접 설치할 수 있습니다:

wsl -d Ubuntu
curl -fsSL https://openclaw.ai/install | bash

OpenClaw이 실행되면 AI 제공업체를 설정하고 메시징 채널을 연결하세요.