메인 콘텐츠로 건너뛰기

​
Windows (WSL2)

Windows 에서 OpenClaw 를 사용하는 것은 WSL2 를 통해 사용하는 것을 권장합니다 (Ubuntu 권장). CLI + Gateway(게이트웨이) 는 Linux 내부에서 실행되며, 이는 런타임을 일관되게 유지하고 도구 호환성(Node/Bun/pnpm, Linux 바이너리, Skills)을 크게 향상시킵니다. 네이티브 Windows 환경은 더 까다로울 수 있습니다. WSL2 는 완전한 Linux 경험을 제공하며, 설치는 단 하나의 명령으로 가능합니다: wsl --install. 네이티브 Windows 컴패니언 앱은 계획되어 있습니다.

​
설치 (WSL2)

​
Gateway

​
Gateway 서비스 설치 (CLI)

WSL2 내부에서 실행합니다: 
openclaw onboard --install-daemon
또는: 
openclaw gateway install
또는: 
openclaw configure
프롬프트가 표시되면 Gateway service 를 선택하십시오. 복구/마이그레이션: 
openclaw doctor

​
고급: WSL 서비스를 LAN 에 노출하기 (portproxy)

WSL 은 자체 가상 네트워크를 사용합니다. 다른 머신이 WSL 내부에서 실행 중인 서비스(SSH, 로컬 TTS 서버, 또는 Gateway)에 접근해야 하는 경우, Windows 포트를 현재 WSL IP 로 포워딩해야 합니다. WSL IP 는 재시작 후 변경되므로, 포워딩 규칙을 새로 고쳐야 할 수 있습니다. 예시 (PowerShell 관리자 권한): 
$Distro = "Ubuntu-24.04"
$ListenPort = 2222
$TargetPort = 22

$WslIp = (wsl -d $Distro -- hostname -I).Trim().Split(" ")[0]
if (-not $WslIp) { throw "WSL IP not found." }

netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=$ListenPort `
  connectaddress=$WslIp connectport=$TargetPort
Windows 방화벽을 통해 포트를 허용합니다 (최초 1회): 
New-NetFirewallRule -DisplayName "WSL SSH $ListenPort" -Direction Inbound `
  -Protocol TCP -LocalPort $ListenPort -Action Allow
WSL 재시작 후 portproxy 새로 고침: 
netsh interface portproxy delete v4tov4 listenport=$ListenPort listenaddress=0.0.0.0 | Out-Null
netsh interface portproxy add v4tov4 listenport=$ListenPort listenaddress=0.0.0.0 `
  connectaddress=$WslIp connectport=$TargetPort | Out-Null
참고 사항:
  • 다른 머신에서 SSH 접속 시 Windows 호스트 IP 를 대상으로 합니다 (예: ssh user@windows-host -p 2222).
  • 원격 노드는 접근 가능한 Gateway URL 을 사용해야 합니다 (127.0.0.1 아님). 확인을 위해 openclaw status --all 를 사용하십시오.
  • LAN 접근에는 listenaddress=0.0.0.0 를 사용하고, 127.0.0.1 은 로컬 전용으로 유지합니다.
  • 이를 자동화하려면, 로그인 시 새로 고침 단계를 실행하도록 예약 작업(Scheduled Task)을 등록하십시오.

​
단계별 WSL2 설치

​
1. WSL2 + Ubuntu 설치

PowerShell 을 관리자 권한으로 엽니다: 
wsl --install
# Or pick a distro explicitly:
wsl --list --online
wsl --install -d Ubuntu-24.04
Windows 에서 재부팅을 요청하면 재부팅하십시오.

​
2. systemd 활성화 (Gateway 설치에 필요)

WSL 터미널에서 실행합니다: 
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF
그런 다음 PowerShell 에서 실행합니다: 
wsl --shutdown
Ubuntu 를 다시 열고, 다음으로 확인합니다: 
systemctl --user status

​
3. OpenClaw 설치 (WSL 내부)

WSL 내부에서 Linux 시작하기 흐름을 따르십시오: 
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # auto-installs UI deps on first run
pnpm build
openclaw onboard
전체 가이드: Getting Started

​
Windows 컴패니언 앱

현재 Windows 컴패니언 앱은 제공되지 않습니다. 이를 실현하는 데 기여하고자 한다면, 기여를 환영합니다.