Windows Kullanıcıları Mac Almayın - Sıfırdan Openclaw Kurulum Eğitimi

Bir – WSL2 Temel Ortam Kurulumu

• Windows 10 sürüm 2004 (Build 19041) veya üstü / Windows 11
• 64-bit sistem
• BIOS'ta sanallaştırma açık (VT-x / AMD-V)

• Bilgisayarı yeniden başlat, açılırken F2 / Del / F10 (markaya göre değişir) tuşuna bas
• Intel Virtualization Technology veya SVM Mode → Enabled yap
• Kaydet ve çık

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

wsl --update
 wsl --set-default-version 2

1.4 Debian Kurulumu

wsl --list --online   # Mevcut dağıtımları gör
wsl --install -d Debian

• Microsoft Store'dan "Debian" ara ve kur
• Veya: wsl --install -d Debian --web-download

wsl -l -v
# Çıktı şöyle olmalı:
# NAME STATE VERSION
# Debian    Running         2

wsl --set-version Debian 2

1.5 Debian'a İlk Girişte Temel Ayarlar

# Debian kaynaklarını Türkiye mirror'a çevir
sudo sed -i 's/deb.debian.org/mirrors.itu.edu.tr/g' /etc/apt/sources.list

# Güncelle ve yükselt
sudo apt update && sudo apt upgrade -y

# Temel araçlar
sudo apt install -y curl wget git build-essential

1.6 .wslconfig Ayarı (WSL'in öldürülmesini önle)

[wsl2]
autoMemoryReclaim=disabled

wsl --shutdown
wsl -d Debian

[boot]
systemd=true

systemctl --user status   # user slice çalışıyor olmalı

İki – Node.js ve OpenClaw Kurulumu

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install 24
node --version   # v24.x olmalı

mkdir -p ~/.npm-global
  npm config set prefix '~/.npm-global'

export PATH="$HOME/.npm-global/bin:$PATH"

npm install -g openclaw
openclaw --version   # Başarılıysa versiyon gösterir (2026.2.x gibi)

openclaw configure

• Model sağlayıcı: API URL + key (OpenAI, Anthropic, custom)
• Gateway modu: local
• Port: 18789 varsayılan

Üç – Ağ Proxy Ayarı (En Büyük Pit!)

cat /etc/resolv.conf | grep nameserver | awk '{print $2}'   # Genelde 172.x.x.1
  # Veya
  ip route show default | awk '{print $3}'

sudo apt install privoxy

forward-socks5 / 172.31.0.1:10808 .

sudo systemctl enable --now privoxy   # 8118 portunda HTTP proxy dinler

Environment="HTTP_PROXY=http://127.0.0.1:8118"
Environment="HTTPS_PROXY=http://127.0.0.1:8118"
 Environment="no_proxy=localhost,127.0.0.1,::1,10.0.0.0/8,172.16.0.0/12,192.168.0.0/16"

systemctl --user daemon-reload
systemctl --user restart openclaw-gateway

git config --global http.proxy socks5://172.31.0.1:10808   # ✅ Doğru
# sakın socks5h:// kullanma → takılır!

Dört – Gateway'i Başlat & Arka Planda Tut

4.1 İlk Başlatma

openclaw gateway start
openclaw gateway status   # Runtime: running olmalı

$running = wsl -l --running 2>$null | Select-String "Debian"
if (-not $running) {
wsl -d Debian -- sh -c "nohup sleep infinity &"
}

• Tetikleyici: Her 2 dakikada bir
• Eylem: powershell.exe -ExecutionPolicy Bypass -File C:UsersKullanıcıAdınscriptskeep-wsl-alive.ps1
• "Kullanıcı oturum açmasa da çalıştır" tikle

Beş – Tarayıcı Ayarı (AI web'de gezinsin diye – Önerilir)

5.1 Kurulum

sudo apt install chromium xvfb

bash
mkdir -p ~/.local/bin
cat > ~/.local/bin/chromium-proxy << 'EOF'
#!/bin/sh
if ! pgrep -f "Xvfb :99" > /dev/null 2>&1; then
  Xvfb :99 -screen 0 1920x1080x24 -ac +extension GLX +render -noreset &
  sleep 1
fi
export DISPLAY=:99
exec /usr/bin/chromium --proxy-server="socks5://172.31.0.1:10808" "$@"
EOF
chmod +x ~/.local/bin/chromium-proxy

{
  "browser": {
    "executablePath": "/home/kullanıcıadın/.local/bin/chromium-proxy",
    "headless": false,
    "profiles": {
      "openclaw": {
        "cdpPort": 18800,
        "color": "#FF4500"
      }
    }
  }
}

Environment="DISPLAY=:99"

{
  "models": {
    "mode": "merge",
    "providers": {
      "benim-provider": {
        "baseUrl": "https://senin-api.com",
        "apiKey": "sk-xxx",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 32000
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "benim-provider/claude-opus-4-6"
      }
    }
  }
}

http://127.0.0.1:18789/   # Windows tarayıcısında localhost:18789

Sekiz – Proxy Zinciri Özeti

• Gateway (Node) → Privoxy (8118) → SOCKS5 (10808) → Windows proxy → İnternet
• Chromium → Direkt SOCKS5 (10808) → Windows proxy

Dokuz – Yaygın Pitler ve Çözümler

1. Gateway kopuyor → .wslconfig autoMemoryReclaim=disabled
2. Git/clone takılıyor → socks5h yerine socks5 kullan
3. Chromium Windows'ta popup açıyor → :99 ile Xvfb kullan
4. Systemd user servisi başlamıyor → sudo loginctl enable-linger $(whoami)
5. sudo şifre sorması → sudo visudo ile kullanıcıadın ALL=(ALL) NOPASSWD: ALL ekle (sadece WSL'de!)

On – Son Kontrol Listesi

• systemctl --user status → çalışıyor
• node --version → v24
• openclaw --version
• openclaw gateway status → running
• curl -x http://127.0.0.1:8118 https://api.anthropic.com → bağlanıyor (hata verse bile timeout yok)
• localhost:18789 açılıyor
• Browser: openclaw browser start --browser-profile openclaw

Son Söz:

1. systemd etkin
2. Proxy zinciri (Privoxy + socks5)
3. WSL'i öldürmemek (.wslconfig + Windows timer)