Asosiy tarkibga o'tish

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)

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.