Windows (WSL2)¶

Windows پر OpenClaw استعمال کرنے کے لیے WSL2 (Ubuntu تجویز کردہ) کے ذریعے انسٹالیشن کی سفارش کی جاتی ہے۔ 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 معاون ایپس منصوبہ بندی میں ہیں۔

انسٹال کریں (WSL2)¶

• Getting Started (WSL کے اندر استعمال کریں)
• انسٹالیشن اور اپ ڈیٹس
• سرکاری WSL2 گائیڈ (Microsoft): https://learn.microsoft.com/windows/wsl/install

Gateway¶

• Gateway رن بک
• کنفیگریشن

Gateway سروس انسٹال (CLI)¶

WSL2 کے اندر:

openclaw onboard --install-daemon

یا:

openclaw gateway install

یا:

openclaw configure

پرومپٹ آنے پر Gateway service منتخب کریں۔

مرمت/منتقلی:

openclaw doctor

Advanced: WSL سروسز کو LAN پر ایکسپوز کریں (portproxy)¶

WSL کا اپنا ایک ورچوئل نیٹ ورک ہوتا ہے۔ اگر کسی دوسری مشین کو کسی سروس تک رسائی درکار ہو 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.

مثال (PowerShell بطور 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

Windows Firewall کے ذریعے پورٹ کی اجازت دیں (ایک بار):

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

WSL کے ری اسٹارٹ کے بعد portproxy کو ریفریش کریں:

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 host IP کو ہدف بناتا ہے (مثال: ssh user@windows-host -p 2222)۔
• ریموٹ نوڈز کو قابلِ رسائی Gateway URL کی طرف اشارہ کرنا چاہیے ( 127.0.0.1 نہیں)؛ تصدیق کے لیے openclaw status --all استعمال کریں۔
• LAN رسائی کے لیے listenaddress=0.0.0.0 استعمال کریں؛ 127.0.0.1 اسے صرف مقامی رکھتا ہے۔
• اگر آپ اسے خودکار بنانا چاہتے ہیں تو لاگ اِن پر ریفریش مرحلہ چلانے کے لیے ایک Scheduled Task رجسٹر کریں۔

مرحلہ وار WSL2 انسٹال¶

1. WSL2 + Ubuntu انسٹال کریں¶

PowerShell کھولیں (Admin):

wsl --install
# Or pick a distro explicitly:
wsl --list --online
wsl --install -d Ubuntu-24.04

اگر Windows کہے تو ری بوٹ کریں۔

2. systemd فعال کریں (Gateway انسٹال کے لیے ضروری)¶

اپنے 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 Getting Started فلو کی پیروی کریں:

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

مکمل گائیڈ: Getting Started

Windows معاون ایپ¶

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