> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Windows (WSL2)

# 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](/start/getting-started) (WSL ichida foydalaning)
* [O‘rnatish va yangilanishlar](/install/updating)
* Rasmiy WSL2 qo‘llanmasi (Microsoft): [https://learn.microsoft.com/windows/wsl/install](https://learn.microsoft.com/windows/wsl/install)

## Gateway

* [Gateway ishchi yo‘riqnomasi](/gateway)
* [Konfiguratsiya](/gateway/configuration)

## 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):

```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
$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):

```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
New-NetFirewallRule -DisplayName "WSL SSH $ListenPort" -Direction Inbound `
  -Protocol TCP -LocalPort $ListenPort -Action Allow
```

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

```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
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:

```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
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:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF
```

So‘ng PowerShell’dan:

```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
wsl --shutdown
```

Ubuntu’ni qayta oching, keyin tekshiring:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
systemctl --user status
```

### 3. OpenClaw o‘rnatish (WSL ichida)

WSL ichida Linux uchun Boshlash qo‘llanmasiga amal qiling:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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](/start/getting-started)

## Windows hamroh ilovasi

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