Windows’ta OpenClaw Kurulumu Nasıl Yapılır?

OpenClaw, AI iş akışları oluşturmak için güçlü bir araçtır; ancak Windows’ta kurulumu yeni başlayanlar için kafa karıştırıcı olabilir. Bu kılavuz, hızlıca başlayabilmeniz için başlıca kurulum yöntemlerini adım adım açıklar.

OpenClaw Windows kurulumu: 3 yöntemin karşılaştırması

Adımlara geçmeden önce, OpenClaw’ı Windows’a kurmanın üç yoluna kısaca bakalım. Her yöntem; kurulum süresi, özellik kapsamı ve teknik gereksinimler açısından farklı ödünler içerir.

Kimi Claw, OpenClaw’ı tarayıcınızda çalıştırmanızı sağlayan çevrimiçi bir araçtır. Kurulum ve yapılandırmayı otomatik olarak halleder; bu yüzden Node.js, WSL veya API anahtarı ayarlamanız gerekmez. Dakikalar içinde kullanıma hazır bir agent ile başlayabilirsiniz.

Yerel PowerShell veya WSL2 kurulumu için Yöntem 1 ya da Yöntem 2 bölümüne ilerleyin. Yerel kurulumu tamamen atlamak için Yöntem 3: Kimi Claw bölümüne geçin. Daha hızlı başlamak isterseniz hemen başlayabilirsiniz.

OpenClaw’ı Windows’a yerel olarak kurmadan önce gerekenler

OpenClaw’ı yerel olarak kurmayı planlıyorsanız, sisteminizin aşağıdaki gereksinimleri karşıladığından emin olun. Kimi Claw gibi bulut seçeneğini tercih ederseniz bu bölümü tamamen atlayabilirsiniz.

Sistem gereksinimleri

• Windows 10 veya Windows 11 (64-bit)

• En az 4 GB RAM (kararlı npm derlemeleri için 8 GB önerilir)

• Kararlı internet bağlantısı

• WSL2 seçerseniz ilk kurulum için yönetici ayrıcalıkları

• OpenClaw WSL2 için: sanallaştırma BIOS/UEFI içinde etkin olmalıdır

Gerekli yazılımlar

• Node.js 22.14 veya üzeri. OpenClaw modern bir Node.js çalışma zamanı gerektirir. nodejs.org adresinden indirin veya başlangıç betiğiyle kurun.

• Git for Windows (isteğe bağlı, ancak önerilir). Bazı npm paketleri ve yetenekler Git’e bağlıdır.

Yöntem 1: PowerShell kullanarak Windows’ta OpenClaw kurulumu

WSL2 ile karşılaştırıldığında PowerShell yöntemi daha az adım gerektirir ve Linux ortamına ihtiyaç duymaz. Tek bir komut OpenClaw’ı indirir, Node.js sürümünüzü denetler ve başlangıç sihirbazını başlatır. Bu yöntem hem Windows 10 hem de Windows 11’de çalışır.

1. Adım: OpenClaw’ınızı kurun ve çalıştırın

Windows, sisteminizi korumak için betik çalıştırmayı varsayılan olarak sınırlar. OpenClaw’ı kurmadan önce, bu "güvenlik anahtarı" komutunu çalıştırarak PowerShell’in yerel betikleri yürütmesine izin vermelisiniz:

Ardından şu komutu çalıştırın:

Komutu çalıştırdıktan sonra, aşağıdaki ekran görüntüsüne benzer bir çıktı görmelisiniz. Başlangıç adımına geçmeden önce sistem PATH’inizin yenilenmesi için PowerShell’i kapatıp yeniden açın.

2. Adım: Risk uyarısını onaylayın ve başlangıç modunu seçin

Riski kabul edip devam etmek için Yes seçeneğini seçin.

Ardından başlangıç sürecini hızlıca başlatmak için QuickStart seçeneğini seçin. Ayarları daha sonra değiştirebilir veya tam yapılandırma için Manual seçeneğini kullanabilirsiniz.

3. Adım: AI modelinizi yapılandırın ve kimlik doğrulamasını yapın

1. Model/kimlik doğrulama sağlayıcısı olarak Moonshot AI’ı seçin

1. AI modelinizin kimlik doğrulamasını yapın ve yapılandırın

OpenClaw’ı bağlamak için Kimi Açık Platform üzerinden Kimi API anahtarınızı etkinleştirin. 5 $yükleme size 5$ bonus kupon kazandırsa da Tier 2 erişimin açılması için 20 $+ öneriyoruz. Bu, gecikmeyi azaltır ve OpenClaw agent’ınızın karmaşık, çok adımlı görevleri yerine getirmesini sağlar.

1. Kimi API anahtarı oluşturun

API Keys bölümüne gidin ve Create API Key düğmesine tıklayın. API anahtarınızı güvenli ve erişilebilir bir yerde saklamanız gerektiğini unutmayın. Anahtar, oluşturulduğu anda yalnızca bir kez gösterilir.

1. API anahtarınızı girin ve varsayılan modeli seçin

Başlangıç sihirbazı istediğinde, benzersiz API anahtarınızı PowerShell/Terminal penceresine yapıştırın.

Varsayılan model seçmeniz istendiğinde moonshot/kimi-k2.5 seçeneğini seçin (zaten vurgulanmışsa "Keep current" seçeneğini de kullanabilirsiniz). Bu model, agent görevleri için hız ve akıl yürütme arasında en iyi dengeyi sunar.

4. Adım: Kanal seçin

OpenClaw’ınıza hangi uygulamayı bağlamak istediğinizi seçin. Emin değilseniz bu adımı atlayın.

5. Adım: Performans için yapılandırın

Yapılandırmak için Yes’e, atlamak için No’ya tıklayın.

6. Adım: Hooks’u etkinleştirin

Botunuzla sohbet etmek için bir yöntem seçin, ardından çalışmaya başlamasını bekleyin.

7. Adım: OpenClaw’ınızı çalıştırın

Yukarıdaki adımlar tamamlandıktan sonra OpenClaw’ınızı kullanmaya başlayabilirsiniz.

Yöntem 2: WSL2 ile Windows’ta OpenClaw kurulumu

OpenClaw WSL2 kurulumu, Windows içinde tam bir Linux ortamı sağlar ve OpenClaw’ı çalıştırmanın resmi olarak önerilen yoludur. Bu yöntem; systemd daemon yönetimi, yerel shell betikleri ve daha sorunsuz npm derlemeleri dahil olmak üzere tüm özellik setine erişim sunar. OpenClaw’ı Windows’ta günlük iş akışları veya geliştirme için kullanmayı planlıyorsanız en iyi seçenek OpenClaw WSL’dir.

1. Adım: Windows 11/10’da OpenClaw için WSL2’yi etkinleştirin

PowerShell’i Yönetici olarak açın ve şunu çalıştırın:

Bu komut WSL’yi etkinleştirir, Ubuntu’yu indirir ve kurar. İşlem tamamlandıktan sonra bilgisayarınızı yeniden başlatın. Windows yeniden açıldığında Ubuntu başlar ve sizden bir kullanıcı adı ile parola oluşturmanızı ister.

WSL zaten kuruluysa doğrulayın:

2. Adım: WSL2’yi systemd için yapılandırın

OpenClaw, systemd kullanarak arka plan servisi olarak çalışır. Bunu WSL yapılandırmanızda etkinleştirin:

Ardından PowerShell’den WSL’yi yeniden başlatın:

Ubuntu terminalinizi yeniden açın ve systemd’nin çalıştığını doğrulayın:

Çıktıda systemd görünmelidir. Bunun yerine init görünüyorsa /etc/wsl.conf dosyanızı tekrar kontrol edin.

3. Adım: Node.js 22.14+ kurun

OpenClaw için Node.js 22.14 veya üzeri gerekir. NodeSource deposundan kurun:

Kurulumu doğrulayın:

4. Adım: OpenClaw’ı npm ile kurun

Node.js hazır olduğunda OpenClaw’ı global olarak kurun:

Alternatif olarak resmi kurulum betiğini kullanın:

Kurulumu doğrulayın:

5. Adım: Onboarding ile OpenClaw Windows kurulumunu tamamlayın

OpenClaw’ı systemd servisi olarak ayarlamak için onboarding sihirbazını daemon bayrağıyla çalıştırın:

Sihirbaz şu adımlarda size rehberlik eder:

• LLM sağlayıcınızı seçme ve API anahtarınızı girme

• Varsayılan model seçme

• Mesajlaşma kanallarını yapılandırma (isteğe bağlı)

• Gateway’i arka plan servisi olarak kurma

Onboarding tamamlandıktan sonra servis kalıcılığını etkinleştirin; böylece OpenClaw, WSL açıldığında otomatik olarak başlar:

Gateway; agent istekleri, mesajlaşma ve model yürütme dahil tüm OpenClaw işlemlerini yöneten temel arka plan servisidir. Çalıştığından emin olmak, OpenClaw kurulumunuzun tamamlandığını ve kullanıma hazır olduğunu doğrular; sonraki adımlarda oluşabilecek hataları da önler.

Durumunu kontrol etmek için PowerShell veya WSL terminalinizde aşağıdaki komutu çalıştırın:

Yöntem 3: Kimi Claw ile Windows’ta OpenClaw çalıştırma (kurulum gerekmez)

Node.js, WSL ve API anahtarlarını yönetmek ihtiyacınızdan fazla kurulum işi gibi geliyorsa Kimi Claw, OpenClaw’ı çalıştırmanın daha basit bir yolunu sunar. Yerel kurulum veya manuel yapılandırma olmadan OpenClaw’ı doğrudan tarayıcınızda çalıştırmanızı sağlar. Başlamak için şu adımları izleyin:

1. Adım: Kimi Claw’ı açın ve bir instance oluşturun

Kimi Claw sayfasına gidin ve başlamak için Create düğmesine tıklayın.

2. Adım: Dağıtımı başlatın

Açılır pencerede dağıtımı onaylayın. Kimi Claw; gateway, workspace ve araçlar dahil OpenClaw ortamınızı yaklaşık iki dakikada kurar. Komut çalıştırmanız veya manuel yapılandırma yapmanız gerekmez.

3. Adım: Workspace’inizde çalışın

Dağıtım tamamlandığında workspace’iniz dashboard’da açılır. AI agent’ınızla sohbet etmeye başlayabilir, skill’ler kurabilir, zamanlanmış görevleri yapılandırabilir ve dosyaları tamamen tarayıcıdan yönetebilirsiniz.

Kimi Claw ile neler elde edersiniz?

• Sıfır yapılandırma: Node.js, WSL veya API anahtarı yönetimi gerekmez

• 40 GB bulut depolama: Oturumlar arasında kalıcı olan raporları, veri kümelerini ve oluşturulan dosyaları kaydedin

• Kalıcı bellek: AI agent’ınız önceki etkileşimleri, tercihleri ve bağlamı hatırlar

• 5.000+ ClawHub skill’i: Otomasyon, araştırma, kodlama ve analiz skill’lerine anında erişin

• Zamanlanmış görev otomasyonu: Günlük raporlar, hatırlatıcılar ve izleme gibi yinelenen görevler oluşturun

• Her cihazda çalışır: OpenClaw agent’ınıza Windows, Mac veya mobil cihazlarda herhangi bir tarayıcıdan erişin

OpenClaw için Windows güvenlik duvarı ve güvenlik ayarları

Kimi Claw, bulut sunucularında güvenliği ve ağı otomatik olarak yönetir. OpenClaw’ı PowerShell veya WSL2 ile yerel olarak kurmayı tercih ediyorsanız, kurulumdan sonra yapılandırmanız önerilen birkaç güvenlik ayarı vardır.

• Windows Güvenlik Duvarı’nı yapılandırma

OpenClaw gateway ilk kez başlatıldığında Windows Güvenlik Duvarı, ağ erişimine izin vermenizi isteyebilir. Yalnızca özel ağlar için izin verin. OpenClaw WSL2 kullanıyorsanız gateway Linux ortamı içinde çalışır ve localhost üzerinden iletişim kurar; bu nedenle genellikle ek güvenlik duvarı kuralı gerekmez.

Browser Relay veya diğer özellikler bağlanamıyorsa localhost trafiğinin antivirüs programları, VPN istemcileri ya da kurumsal güvenlik duvarları gibi üçüncü taraf güvenlik yazılımları tarafından engellenmediğinden emin olun.

• Control UI’ı güvenceye alma

OpenClaw Control UI, 18789 numaralı bağlantı noktasında çalışır ve agent’ınıza tam erişim sağlar. Bu bağlantı noktasını asla herkese açık internete açmayın. Gateway’i 127.0.0.1 adresine bağlı tutun ve yalnızca yerel makinenizden erişin.

Güvenli uzaktan erişim için özel bir ağ tüneli oluşturmak üzere Tailscale kullanın:

Bu, bağlantı noktasını localhost üzerinde tutarken özel Tailscale ağınız üzerinden erişilebilir hale getirir.

Windows’ta sık karşılaşılan OpenClaw kurulum hataları ve çözümleri

Açık bir kılavuzu izleseniz bile kurulum sırasında sorunlarla karşılaşabilirsiniz. Aşağıda, OpenClaw’ı Windows’a kurarken en sık bildirilen sorunları ve bunların çözümlerini bulabilirsiniz.

OpenClaw tanınmıyor

• Neden: npm global bin dizini, sistem PATH değişkeninizde yer almıyor.

• Çözüm: npm prefix’inizi bulmak için aşağıdaki komutu çalıştırın

Çıktıda görünen yolu Windows ortam değişkenlerinize ekleyin. \\bin eklemeyin. Ardından PowerShell’i kapatıp yeniden açın.

Kurulum sırasında Git bulunamadı

• Neden: Git for Windows kurulu değil.

• Çözüm: Git’i git-scm.com adresinden indirip kurun. Kurulumdan sonra PowerShell’i yeniden başlatın ve OpenClaw Windows kurulum aracını tekrar deneyin.

Node.js sürümü çok eski

• Neden: Sisteminizdeki Node.js sürümü minimum gereksinimi (v22.14+) karşılamıyor.

• Çözüm: En güncel LTS sürümünü nodejs.org adresinden indirip kurun. OpenClaw WSL2 kullanıyorsanız NodeSource deposu üzerinden yeniden kurun.

İzin reddedildi hataları

• Neden: PowerShell’in yeterli izni yok veya npm global dizini yazılabilir değil.

• Çözüm: PowerShell’i Administrator olarak çalıştırın veya npm global prefix’ini kullanıcının yazabildiği bir dizine değiştirin

Gateway başlamıyor

• Neden: Port 18789 zaten kullanımda veya yapılandırma dosyası bozulmuş.

• Çözüm: Çakışan süreçleri kontrol edin ve yeniden başlatın

WSL2 systemd çalışmıyor

• Neden: /etc/wsl.conf dosyasında systemd yapılandırması eksik.

• Çözüm: Dosyanın doğru ayarları içerdiğini doğrulayın

Ayar eksikse ekleyin ve PowerShell’de wsl --shutdown komutuyla WSL’yi yeniden başlatın.

Sonuç

OpenClaw’ı Windows’a kurmak, ihtiyaçlarınıza bağlı olarak basit bir betik tabanlı kurulumdan daha gelişmiş bir WSL2 ortamına kadar değişebilir. Tam kontrol ve esneklik istiyorsanız PowerShell ve WSL2 sağlam seçeneklerdir. Kurulumu atlayıp hemen başlamak isterseniz Kimi Claw, yerel kurulum olmadan OpenClaw’ı tarayıcınızda çalıştırmanızı sağlar. İş akışınıza ve teknik rahatlık seviyenize uygun yaklaşımı seçin; OpenClaw’dan en iyi şekilde yararlanmaya hazır olursunuz.