Ana içeriğe atla

​
Windows

OpenClaw hem yerel Windows hem de WSL2 destekler. WSL2 daha kararlı yoldur ve tam deneyim için önerilir — CLI, Gateway ve araçlar Linux içinde tam uyumlulukla çalışır. Yerel Windows, temel CLI ve Gateway kullanımı için çalışır; aşağıda belirtilen bazı uyarılar vardır. Yerel Windows yardımcı uygulamaları planlanmaktadır.

​
WSL2 (önerilen)

​
Yerel Windows durumu

Yerel Windows CLI akışları gelişiyor, ancak WSL2 hâlâ önerilen yoldur. Bugün yerel Windows’ta iyi çalışanlar:
  • install.ps1 aracılığıyla web sitesi yükleyicisi
  • openclaw --version, openclaw doctor ve openclaw plugins list --json gibi yerel CLI kullanımı
  • aşağıdaki gibi gömülü local-agent/provider smoke çalıştırmaları:
openclaw agent --local --agent main --thinking low -m "Reply with exactly WINDOWS-HATCH-OK."
Mevcut uyarılar:
  • openclaw onboard --non-interactive, --skip-health geçmediğiniz sürece hâlâ erişilebilir bir yerel gateway bekler
  • openclaw onboard --non-interactive --install-daemon ve openclaw gateway install önce Windows Zamanlanmış Görevler’i dener
  • Zamanlanmış Görev oluşturma reddedilirse, OpenClaw kullanıcı başına Startup klasörü oturum açma öğesine geri döner ve gateway’i hemen başlatır
  • schtasks kilitlenirse veya yanıt vermeyi durdurursa, OpenClaw artık sonsuza kadar takılmak yerine bu yolu hızla iptal eder ve geri dönüş yolunu kullanır
  • Zamanlanmış Görevler, daha iyi supervisor durumu sağladıkları için mevcut olduğunda hâlâ tercih edilir
Yalnızca yerel CLI istiyorsanız ve gateway hizmeti kurmak istemiyorsanız, şunlardan birini kullanın: 
openclaw onboard --non-interactive --skip-health
openclaw gateway run
Yerel Windows’ta yönetilen başlangıç istiyorsanız: 
openclaw gateway install
openclaw gateway status --json
Zamanlanmış Görev oluşturma engellenirse, geri dönüş hizmet modu yine de mevcut kullanıcının Startup klasörü üzerinden oturum açtıktan sonra otomatik başlar.

​
Gateway

​
Gateway hizmeti kurulumu (CLI)

WSL2 içinde: 
openclaw onboard --install-daemon
Veya: 
openclaw gateway install
Veya: 
openclaw configure
İstendiğinde Gateway service seçin. Onarma/taşıma: 
openclaw doctor

​
Windows oturum açılmadan önce Gateway otomatik başlatma

Başsız kurulumlar için, tam önyükleme zincirinin Windows’ta kimse oturum açmasa bile çalıştığından emin olun.

​
1) Oturum açmadan kullanıcı hizmetlerini çalışır tutun

WSL içinde: 
sudo loginctl enable-linger "$(whoami)"

​
2) OpenClaw gateway kullanıcı hizmetini kurun

WSL içinde: 
openclaw gateway install

​
3) Windows önyüklemesinde WSL’yi otomatik başlatın

PowerShell’de Yönetici olarak: 
schtasks /create /tn "WSL Boot" /tr "wsl.exe -d Ubuntu --exec /bin/true" /sc onstart /ru SYSTEM
Ubuntu değerini şu komuttan aldığınız dağıtım adıyla değiştirin: 
wsl --list --verbose

​
Başlangıç zincirini doğrulayın

Yeniden başlatmadan sonra (Windows oturumu açılmadan önce), WSL içinden kontrol edin: 
systemctl --user is-enabled openclaw-gateway.service
systemctl --user status openclaw-gateway.service --no-pager

​
Gelişmiş: WSL hizmetlerini LAN üzerinden açma (portproxy)

WSL kendi sanal ağına sahiptir. Başka bir makinenin WSL içinde çalışan bir hizmete (SSH, yerel bir TTS sunucusu veya Gateway) erişmesi gerekiyorsa, bir Windows portunu mevcut WSL IP’sine yönlendirmeniz gerekir. WSL IP’si yeniden başlatmalardan sonra değişir, bu nedenle yönlendirme kuralını yenilemeniz gerekebilir. Örnek (PowerShell’de Yönetici olarak): 
$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
Portun Windows Güvenlik Duvarı’ndan geçmesine izin verin (bir kerelik): 
New-NetFirewallRule -DisplayName "WSL SSH $ListenPort" -Direction Inbound `
  -Protocol TCP -LocalPort $ListenPort -Action Allow
WSL yeniden başladıktan sonra portproxy’yi yenileyin: 
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
Notlar:
  • Başka bir makineden SSH, Windows ana makine IP’sini hedefler (örnek: ssh user@windows-host -p 2222).
  • Uzak düğümler erişilebilir bir Gateway URL’sini hedeflemelidir (127.0.0.1 değil); doğrulamak için openclaw status --all kullanın.
  • LAN erişimi için listenaddress=0.0.0.0 kullanın; 127.0.0.1 bunu yalnızca yerel tutar.
  • Bunu otomatik yapmak istiyorsanız, oturum açıldığında yenileme adımını çalıştıracak bir Zamanlanmış Görev kaydedin.

​
Adım adım WSL2 kurulumu

​
1) WSL2 + Ubuntu kurun

PowerShell’i açın (Yönetici): 
wsl --install
# Veya bir dağıtımı açıkça seçin:
wsl --list --online
wsl --install -d Ubuntu-24.04
Windows isterse yeniden başlatın.

​
2) systemd’yi etkinleştirin (gateway kurulumu için gereklidir)

WSL terminalinizde: 
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF
Ardından PowerShell’den: 
wsl --shutdown
Ubuntu’yu yeniden açın, sonra doğrulayın: 
systemctl --user status

​
3) OpenClaw’ı kurun (WSL içinde)

WSL içinde Linux Başlangıç akışını izleyin: 
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # ilk çalıştırmada UI bağımlılıklarını otomatik kurar
pnpm build
openclaw onboard
Tam kılavuz: Başlangıç

​
Windows yardımcı uygulaması

Henüz bir Windows yardımcı uygulamamız yok. Bunu gerçekleştirmek için katkıda bulunmak isterseniz katkılar memnuniyetle karşılanır.