Windows (WSL2)

Windows의 OpenClaw는 WSL2를 통해 권장됩니다 (Ubuntu 권장). CLI + Gateway는 Linux 내부에서 실행되며, 런타임을 일관되게 유지하고 도구를 훨씬 더 호환 가능하게 만듭니다 (Node/Bun/pnpm, Linux 바이너리, skills). 네이티브 Windows 설치는 테스트되지 않았으며 더 문제가 많습니다.

네이티브 Windows 컴패니언 앱이 계획되어 있습니다.

설치 (WSL2)

Gateway

Gateway 서비스 설치 (CLI)

WSL2 내부에서:

openclaw onboard --install-daemon

또는:

openclaw gateway install

또는:

openclaw configure

프롬프트가 표시되면 Gateway service를 선택합니다.

복구/마이그레이션:

openclaw doctor

고급: LAN을 통해 WSL 서비스 노출 (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).
  • 원격 nodes는 도달 가능한 Gateway 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 활성화 (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 Getting Started 흐름을 따르세요:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # 첫 실행 시 UI 종속성 자동 설치
pnpm build
openclaw onboard

전체 가이드: 시작하기

Windows 컴패니언 앱

아직 Windows 컴패니언 앱이 없습니다. 구현을 돕고 싶다면 기여를 환영합니다.

← 문서로 돌아가기