윈도우(WSL2)

Windows의 OpenClaw는 WSL2를 통해 권장됩니다(Ubuntu 권장). 는 CLI + 게이트웨이는 Linux 내에서 실행되어 런타임의 일관성을 유지하고 훨씬 더 호환되는 도구입니다(Node/Bun/pnpm, Linux 바이너리, 기술). 네이티브 Windows가 더 까다로울 수 있습니다. WSL2는 완전한 Linux 환경을 제공합니다. 단 하나의 명령 설치하려면: wsl --install.

기본 Windows 도우미 앱이 계획되어 있습니다.

설치(WSL2)

• 시작하기 (WSL 내부에서 사용)
• 설치 및 업데이트
• 공식 WSL2 가이드(Microsoft): https://learn.microsoft.com/windows/wsl/install/

게이트웨이

• 게이트웨이 런북
• 구성

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

WSL2 내부:

openclaw onboard --install-daemon

또는:

openclaw gateway install

또는:

openclaw configure

메시지가 나타나면 게이트웨이 서비스를 선택합니다.

복구/마이그레이션:

openclaw doctor

고급: LAN(포트프록시)을 통해 WSL 서비스 노출

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 방화벽을 통해 포트 허용(1회):

New-NetFirewallRule -DisplayName "WSL SSH $ListenPort" -Direction Inbound `
  -Protocol TCP -LocalPort $ListenPort -Action Allow

WSL이 다시 시작된 후 포트 프록시를 새로 고칩니다.

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 + 우분투 설치

PowerShell 열기(관리자):

wsl --install
# Or pick a distro explicitly:
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 # auto-installs UI deps on first run
pnpm build
openclaw onboard

전체 가이드: 시작하기

Windows 도우미 앱

아직 Windows 도우미 앱이 없습니다. 원한다면 기여를 환영합니다 실현할 수 있도록 기여합니다.