메인 콘텐츠로 건너뛰기

​
Windows (WSL2)

Windows용 OpenClaw는 WSL2를 통해 사용을 권장합니다 (Ubuntu 권장). CLI + 게이트웨이는 Linux 내부에서 실행되며, 이는 실행 환경을 일관성 있게 유지하고 도구들을 훨씬 더 호환 가능하게 만듭니다 (Node/Bun/pnpm, Linux 바이너리, 스킬). Windows 네이티브는 더 까다로울 수 있습니다. WSL2는 완전한 Linux 경험을 제공합니다 — 설치를 위한 한 줄 명령어: wsl --install. 네이티브 Windows 동반 앱은 계획 중입니다.

​
설치 (WSL2)

​
게이트웨이

​
게이트웨이 서비스 설치 (CLI)

WSL2 내에서: 
openclaw onboard --install-daemon
또는: 
openclaw gateway install
또는: 
openclaw configure
게이트웨이 서비스를 선택하라는 메시지가 뜹니다. 수리/마이그레이션: 
openclaw doctor

​
고급: WSL 서비스 LAN 노출 (portproxy)

WSL은 자체 가상 네트워크를 가지고 있습니다. 다른 머신이 WSL 내부에서 실행 중인 서비스 (SSH, 로컬 TTS 서버 또는 게이트웨이)에 접근해야 하는 경우, 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 방화벽을 통해 포트 허용 (한 번만): 
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).
  • 원격 노드는 접근 가능한 게이트웨이 URL을 가리켜야 합니다 (127.0.0.1은 아님); 이를 확인하려면 openclaw status --all을 사용하세요.
  • LAN 접근을 위해 listenaddress=0.0.0.0을 사용하세요; 127.0.0.1은 로컬로만 유지합니다.
  • 자동화를 원하면, 로그인 시 새로 고침 단계를 실행하도록 예약 작업을 등록하세요.

​
단계별 WSL2 설치

​
1) WSL2 + Ubuntu 설치

PowerShell (관리자 권한) 열기: 
wsl --install
# 또는 배포판을 명시적으로 선택:
wsl --list --online
wsl --install -d Ubuntu-24.04
Windows에서 요청할 경우 재부팅하십시오.

​
2) systemd 활성화 (게이트웨이 설치에 필요)

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 # 첫 실행 시 UI 의존성을 자동으로 설치합니다
pnpm build
openclaw onboard
전체 가이드: 시작하기

​
Windows 동반 앱

현재 Windows 동반 앱이 없습니다. 기여를 원하신다면 기여를 통해 실현 가능성에 도움을 주실 수 있습니다.