Windows (WSL2)

OpenClaw on Windows is recommended via WSL2 (Ubuntu recommended). The CLI + Gateway run inside Linux, which keeps the runtime consistent and makes tooling far more compatible (Node/Bun/pnpm, Linux binaries, skills). Native Windows might be trickier. WSL2 gives you the full Linux experience — one command to install: wsl --install. Native Windows hamroh ilovalari rejalashtirilgan.

O‘rnatish (WSL2)

Boshlash (WSL ichida foydalaning)
O‘rnatish va yangilanishlar
Rasmiy WSL2 qo‘llanmasi (Microsoft): https://learn.microsoft.com/windows/wsl/install

Gateway

Gateway servisni o‘rnatish (CLI)

WSL2 ichida:

openclaw onboard --install-daemon

Yoki:

openclaw gateway install

Yoki:

openclaw configure

So‘ralganda Gateway service ni tanlang. Tuzatish/migratsiya:

openclaw doctor

Kengaytirilgan: WSL servislarini LAN orqali ochish (portproxy)

WSL has its own virtual network. If another machine needs to reach a service running inside WSL (SSH, a local TTS server, or the Gateway), you must forward a Windows port to the current WSL IP. The WSL IP changes after restarts, so you may need to refresh the forwarding rule. Misol (PowerShell’ni Administrator sifatida ishga tushiring):

$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

Portni Windows Firewall orqali ruxsat bering (bir martalik):

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

WSL qayta ishga tushirilgandan so‘ng portproxy’ni yangilang:

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

Eslatmalar:

Boshqa qurilmadan SSH ulanish Windows host IP manziliga yo‘naltiriladi (masalan: ssh user@windows-host -p 2222).
Masofaviy tugunlar kirish mumkin bo‘lgan Gateway URL’ga yo‘naltirilishi kerak (127.0.0.1 emas); tasdiqlash uchun openclaw status --all dan foydalaning.
LAN orqali kirish uchun listenaddress=0.0.0.0 dan foydalaning; 127.0.0.1 faqat lokal kirishni ta’minlaydi.
Agar buni avtomatik qilishni istasangiz, login vaqtida yangilash bosqichini ishga tushiradigan Scheduled Task ro‘yxatdan o‘tkazing.

WSL2 o‘rnatish bo‘yicha bosqichma-bosqich qo‘llanma

1. WSL2 + Ubuntu o‘rnatish

PowerShell’ni (Admin) oching:

wsl --install
# Yoki distributivni aniq tanlang:
wsl --list --online
wsl --install -d Ubuntu-24.04

Agar Windows so‘rasa, kompyuterni qayta ishga tushiring.

2. systemd ni yoqish (gateway o‘rnatish uchun talab qilinadi)

WSL terminalingizda:

sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF

So‘ng PowerShell’dan:

wsl --shutdown

Ubuntu’ni qayta oching, keyin tekshiring:

systemctl --user status

3. OpenClaw o‘rnatish (WSL ichida)

WSL ichida Linux uchun Boshlash qo‘llanmasiga amal qiling:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # birinchi ishga tushirishda UI bog‘liqliklarini avtomatik o‘rnatadi
pnpm build
openclaw onboard

To‘liq qo‘llanma: Boshlash

Windows hamroh ilovasi

We do not have a Windows companion app yet. Contributions are welcome if you want contributions to make it happen.

Platformalar haqida umumiy ma’lumot

macOS hamroh ilovasi

Windows (WSL2)

Windows (WSL2)

O‘rnatish (WSL2)

Gateway

Gateway servisni o‘rnatish (CLI)

Kengaytirilgan: WSL servislarini LAN orqali ochish (portproxy)

WSL2 o‘rnatish bo‘yicha bosqichma-bosqich qo‘llanma

1. WSL2 + Ubuntu o‘rnatish

2. systemd ni yoqish (gateway o‘rnatish uchun talab qilinadi)

3. OpenClaw o‘rnatish (WSL ichida)

Windows hamroh ilovasi

​Windows (WSL2)

​O‘rnatish (WSL2)

​Gateway

​Gateway servisni o‘rnatish (CLI)

​Kengaytirilgan: WSL servislarini LAN orqali ochish (portproxy)

​WSL2 o‘rnatish bo‘yicha bosqichma-bosqich qo‘llanma

​1. WSL2 + Ubuntu o‘rnatish

​2. systemd ni yoqish (gateway o‘rnatish uchun talab qilinadi)

​3. OpenClaw o‘rnatish (WSL ichida)

​Windows hamroh ilovasi

Windows (WSL2)

O‘rnatish (WSL2)

Gateway

Gateway servisni o‘rnatish (CLI)

Kengaytirilgan: WSL servislarini LAN orqali ochish (portproxy)

WSL2 o‘rnatish bo‘yicha bosqichma-bosqich qo‘llanma

1. WSL2 + Ubuntu o‘rnatish

2. systemd ni yoqish (gateway o‘rnatish uchun talab qilinadi)

3. OpenClaw o‘rnatish (WSL ichida)

Windows hamroh ilovasi