Przejdź do głównej treści

​
Windows (WSL2)

Uruchamianie OpenClaw na Windows jest zalecane przez WSL2 (rekomendowane Ubuntu). CLI + Gateway działają wewnątrz Linuksa, co utrzymuje spójne środowisko uruchomieniowe i znacząco poprawia kompatybilność narzędzi (Node/Bun/pnpm, binaria Linuksa, Skills). Natywny Windows może być trudniejszy. WSL2 zapewnia pełne doświadczenie Linuksa — jedna komenda do instalacji: wsl --install. Natywne aplikacje towarzyszące na Windows są planowane.

​
Instalacja (WSL2)

​
Gateway

​
Instalacja usługi Gateway (CLI)

Wewnątrz WSL2: 
openclaw onboard --install-daemon
Lub: 
openclaw gateway install
Lub: 
openclaw configure
Po wyświetleniu monitu wybierz Gateway service. Naprawa/migracja: 
openclaw doctor

​
Zaawansowane: udostępnianie usług WSL w LAN (portproxy)

WSL ma własną sieć wirtualną. Jeśli inna maszyna ma łączyć się z usługą uruchomioną wewnątrz WSL (SSH, lokalny serwer TTS lub Gateway), musisz przekierować port Windows na bieżący adres IP WSL. Adres IP WSL zmienia się po restartach, więc może być konieczne odświeżenie reguły przekierowania. Przykład (PowerShell jako Administrator): 
$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
Zezwól na port w Zaporze Windows (jednorazowo): 
New-NetFirewallRule -DisplayName "WSL SSH $ListenPort" -Direction Inbound `
  -Protocol TCP -LocalPort $ListenPort -Action Allow
Odśwież portproxy po restartach 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
Uwagi:
  • SSH z innej maszyny kieruj na adres IP hosta Windows (przykład: ssh user@windows-host -p 2222).
  • Zdalne węzły muszą wskazywać osiągalny adres URL Gateway (nie 127.0.0.1); użyj openclaw status --all, aby potwierdzić.
  • Do dostępu z LAN użyj listenaddress=0.0.0.0; 127.0.0.1 ogranicza dostęp wyłącznie lokalnie.
  • Jeśli chcesz automatyzacji, zarejestruj Zaplanowane Zadanie uruchamiające krok odświeżania przy logowaniu.

​
Instalacja WSL2 krok po kroku

​
1. Zainstaluj WSL2 + Ubuntu

Otwórz PowerShell (Administrator): 
wsl --install
# Or pick a distro explicitly:
wsl --list --online
wsl --install -d Ubuntu-24.04
Uruchom ponownie system, jeśli Windows o to poprosi.

​
2. Włącz systemd (wymagane do instalacji Gateway)

W terminalu WSL: 
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF
Następnie w PowerShell: 
wsl --shutdown
Ponownie otwórz Ubuntu, a następnie zweryfikuj: 
systemctl --user status

​
3. Zainstaluj OpenClaw (wewnątrz WSL)

Postępuj zgodnie z przepływem Pierwsze kroki dla Linuksa wewnątrz WSL: 
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
Pełny przewodnik: Getting Started

​
Aplikacja towarzysząca na Windows

Obecnie nie mamy aplikacji towarzyszącej na Windows. Wkład społeczności jest mile widziany, jeśli chcesz pomóc w jej powstaniu.