macOS, Linux ve Windows için OpenClaw Kurulum Kılavuzu

OpenClaw, AI agent’ınızın Telegram veya WhatsApp gibi uygulamalara bağlanıp mesaj göndermek ya da görevleri yürütmek gibi eylemler gerçekleştirmesini sağlayan yerel bir araçtır. Süreci kavradığınızda kurulumu oldukça kolaydır. Bu kılavuz macOS, Linux ve Windows üzerindeki kurulumları kapsar.

OpenClaw kurulum seçeneklerine kısa bakış

İhtiyaçlarınıza uygun kurulumu seçin. OpenClaw’ı yerel olarak çalıştırmak her şeyi kendi makinenizde tutar ve npm gibi bağımlılıkları kurmayı ya da otomatik bir betik kullanmayı gerektirir. Kurulumla uğraşmak istemezseniz, Kimi Claw gibi tamamen barındırılan platformlar ortamı sizin için yönetir ve doğrudan başlamanızı sağlar.

OpenClaw macOS ve Linux’a nasıl kurulur?

macOS ve Linux aynı yükleyiciyi ve komutları kullanır. Aksi belirtilmedikçe bu yönergeler her iki sistem için de geçerlidir.

Aşağıda hızlı bir kurulum kılavuzu yer alır. Ekran görüntüleriyle eksiksiz adım adım anlatım için bkz. OpenClaw macOS’a nasıl kurulur?.

Yöntem 1: Tek satırlık yükleyici betiğini kullanın

1. Adım: Kurulum betiğini Terminal’de çalıştırın

OpenClaw’ı kurmak için resmi yükleyici betiğini çalıştırın. Betik, Node.js 22 veya daha yeni bir sürümün kurulu olup olmadığını denetler. Eksikse ya da güncel değilse Node.js 24 otomatik olarak kurulur. Ardından OpenClaw CLI’ı kurar ve ilk yapılandırma sihirbazını başlatır.

2. Adım: İlk yapılandırma sihirbazını tamamlayın

Model sağlayıcısı seçme (örn. Kimi API), API anahtarınızı girme, kanal seçme ve temel ayarları yapılandırma dâhil olmak üzere agent ortamınızı hazırlamak için ilk yapılandırma sihirbazını izleyin.

3. Adım: Kurulumunuzu kontrol edin

OpenClaw sürümünüzü doğrulamak için aşağıdaki komutu çalıştırın.

4. Adım: Gateway’i doğrulayın ve kurulumu tamamlayın

OpenClaw gateway’in etkin olduğunu kontrol etmek için aşağıdaki komutu çalıştırın.

Yükleyici ayrıca macOS’ta bir LaunchAgent veya Linux’ta bir systemd hizmeti kaydeder; böylece OpenClaw arka planda çalışmaya devam eder. Her şey hazır olduğunda agent’ınız kullanıma hazırdır. Sohbet etmeye başlayabilir, araçlar bağlayabilir veya ihtiyaçlarınıza göre iş akışları yapılandırabilirsiniz.

Yöntem 2: Homebrew ile kurun

1. Adım: Node.js kurun veya yükseltin

Node.js kurmak için Terminal’de aşağıdaki komutu çalıştırarak Homebrew kullanın. Node.js zaten kuruluysa, en güncel sürümü kullandığınızdan emin olmak için bunun yerine yükseltme komutunu çalıştırın.

2. Adım: OpenClaw CLI’ı kurun

OpenClaw CLI’ı global olarak kurmak için aşağıdaki komutu çalıştırın.

3. Adım: İlk yapılandırmayı çalıştırın ve daemon’ı kurun

İlk yapılandırma sihirbazını başlatmak ve arka plan daemon’ını kaydetmek için aşağıdaki komutu çalıştırın. Model sağlayıcısı seçme (örn. Kimi API), API anahtarınızı girme ve bir mesajlaşma kanalı bağlama dâhil olmak üzere agent ortamınızı yapılandırmak için sihirbazı izleyin. Kurulum tamamlandığında agent’ınız kullanıma hazırdır. Sohbet etmeye başlayabilir, araçlar bağlayabilir veya ihtiyaçlarınıza göre iş akışları yapılandırabilirsiniz.

Yöntem 3: npm ile kurun

1. Adım: Çalışma zamanı sürümünü doğrulayın

Sisteminizde Node.js 22.14 veya daha yeni bir sürümün kurulu olduğundan emin olmak için aşağıdaki komutu çalıştırın. Sürümünüz güncelse kuruluma geçebilirsiniz.

2. Adım: OpenClaw CLI’ı kurun

OpenClaw CLI’ı global olarak kurmak için aşağıdaki komutu çalıştırın.

3. Adım: İlk yapılandırmayı çalıştırın ve kalıcılığı etkinleştirin

İlk yapılandırma sihirbazını başlatmak ve arka plan daemon’ını kaydetmek için aşağıdaki komutu çalıştırın. Model sağlayıcısı seçme (örn. Kimi API), API anahtarınızı girme ve bir mesajlaşma kanalı seçme dâhil olmak üzere agent ortamınızı yapılandırmak için sihirbazı izleyin. Kurulum tamamlandığında agent’ınız hazırdır. Onunla etkileşime geçmeye başlayabilir, araçlar bağlayabilir veya ihtiyaçlarınıza göre iş akışları oluşturabilirsiniz.

Platform notları: OpenClaw hem Intel hem de Apple Silicon Mac’leri destekler. Kurulum Gatekeeper tarafından engellenirse System Settings içindeki Privacy & Security bölümünden izin verebilirsiniz.

OpenClaw Windows’a nasıl kurulur?

Windows’ta OpenClaw kurmanın üç ana yolu vardır: hızlı yerel kurulum için PowerShell yükleyicisi, tam bir Linux ortamı için WSL2 ve manuel kurulum için npm.

Aşağıda hızlı bir kurulum kılavuzu yer alır. Ekran görüntüleriyle eksiksiz adım adım anlatım için bkz. OpenClaw Windows’a nasıl kurulur?.

Yöntem 1: PowerShell yükleyicisini kullanın (yerel Windows)

1. Adım: Yükleyici betiğini PowerShell’de çalıştırın

PowerShell’i yönetici olarak açın ve OpenClaw’ı kurmak için resmi tek satırlık betiği çalıştırın.

2. Adım: İlk yapılandırma sihirbazını tamamlayın

Model sağlayıcısı seçme (örn. Kimi API), API anahtarınızı girme ve mesajlaşma kanalı seçme dâhil olmak üzere agent ortamınızı yapılandırmak için ilk yapılandırma adımlarını izleyin.

3. Adım: Kurulumu doğrulayın

OpenClaw’ın doğru kurulduğunu ve gateway’in etkin olduğunu doğrulamak için aşağıdaki komutu çalıştırın.

4. Adım: agent’ınızı kullanmaya başlayın

Kurulum tamamlandığında agent’ınız hazırdır. Onunla etkileşime geçmeye başlayabilir, araçlar bağlayabilir veya ihtiyaçlarınıza göre iş akışları yapılandırabilirsiniz.

Yöntem 2: WSL2 ile kurun

1. Adım: Linux ortamını hazırlayın

PowerShell’i yönetici olarak açın ve WSL2’yi etkinleştirip başlatmak için aşağıdaki komutu çalıştırın.

2. Adım: Yükleyiciyi Linux içinde çalıştırın

Linux terminalinizi açın ve OpenClaw’ı kurmak için standart kurulum betiğini çalıştırın.

3. Adım: İlk yapılandırma sihirbazını tamamlayın

Model sağlayıcısı seçme (örn. Kimi API), API anahtarınızı girme ve mesajlaşma kanalı seçme dâhil olmak üzere agent ortamınızı yapılandırmak için ilk yapılandırma adımlarını izleyin.

Kurulum tamamlandığında agent’ınız hazırdır. Onunla etkileşime geçmeye başlayabilir, araçlar bağlayabilir veya ihtiyaçlarınıza göre iş akışları yapılandırabilirsiniz.

Yöntem 3: Windows’ta npm ile kurun

1. Adım: Node.js sürümünüzü kontrol edin

Node.js’nin kurulu ve güncel olduğunu doğrulamak için aşağıdaki komutu çalıştırın.

2. Adım: OpenClaw CLI’ı kurun

OpenClaw CLI’ı global olarak kurmak için aşağıdaki komutu çalıştırın.

3. Adım: İlk yapılandırmayı çalıştırın ve kalıcılığı etkinleştirin

İlk yapılandırma sihirbazını başlatmak ve arka plan daemon’ını kaydetmek için aşağıdaki komutu çalıştırın.

Model sağlayıcısı seçme (örn. Kimi API), API anahtarınızı girme ve mesajlaşma kanalı seçme dâhil olmak üzere agent ortamınızı yapılandırmak için ilk yapılandırma adımlarını izleyin.

Kurulum tamamlandığında agent’ınız hazırdır. Onunla etkileşime geçmeye başlayabilir, araçlar bağlayabilir veya ihtiyaçlarınıza göre iş akışları yapılandırabilirsiniz.

OpenClaw, Kimi Claw ile çevrimiçi nasıl çalıştırılır?

Yukarıdaki yöntemler bir terminal, desteklenen bir Node.js sürümü ve açık kalan bir makine gerektirir. Kimi Claw tamamen barındırılan bir seçenek sunar; böylece yerel ortam kurmadan veya bakımını yapmadan OpenClaw’ı çalıştırabilirsiniz.

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ı onaylayın

Açılır pencerede dağıtımı onaylayın. Kimi Claw, herhangi bir yerel yapılandırma gerektirmeden gateway ve çalışma alanı dâhil OpenClaw ortamınızı otomatik olarak kurar.

3. Adım: Çalışma alanınızı kullanmaya başlayın

Dağıtım tamamlandığında çalışma alanınız panoda açılır. agent’ınızla etkileşime geçmeye başlayabilir, beceriler kurabilir, zamanlanmış görevleri yapılandırabilir ve dosyaları doğrudan tarayıcınızdan yönetebilirsiniz.

Kimi Claw’ın öne çıkan özellikleri

• Bulut barındırma: Kimi Claw, gateway’inizi bulutta çalıştırır; böylece yerel makineniz çevrimdışı olsa bile agent’ınız erişilebilir kalır.

• Otomatik bakım: Güncellemeler ve yamalar arka planda uygulanır; manuel kurulum veya yeniden başlatma gerekmez.

• Yerleşik yetenekler: Cihazlar arasında kesintisiz erişimle birlikte görev zamanlama, kalıcı depolama ve istemlerinize göre dinamik beceri yükleme içerir.

Yaygın OpenClaw kurulum hatalarını giderme

OpenClaw kurulum sorunlarının çoğu PATH yapılandırması, eksik bağımlılıklar veya port çakışmaları gibi birkaç yaygın kategoriye girer. Aşağıdaki bölümler, macOS, Windows ve Linux genelinde en sık görülen sorunları hızla belirleyip gidermenize yardımcı olur.

Kurulumdan sonra "openclaw: command not found"

OpenClaw sistem PATH’inizde değil.

• Çözüm: npm global bin dizinini PATH’inize ekleyin.

Ardından shell’inizi yeniden yükleyin (örn. source ~/.zshrc) veya terminalinizi yeniden başlatın. Windows’ta yolu ortam değişkenlerinize ekleyin ve PowerShell’i yeniden başlatın.

macOS’ta Sharp derleme hataları

Bu genellikle global olarak kurulmuş libvips Sharp kitaplığıyla çakıştığında olur.

• Çözüm: Kurulum komutunu bu ortam değişkeniyle çalıştırın.

node-gyp hataları görürseniz Xcode Command Line Tools’u kurun:

OpenClaw yeniden başlatmadan sonra başlamıyor

Arka plan daemon’ı ilk yapılandırma sırasında kurulmamış.

• Çözüm: İlk yapılandırmayı daemon bayrağıyla yeniden çalıştırın.

Ardından servisi doğrulayın:

Gateway yanıt vermiyor veya "0 tokens used" gösteriyor

Gateway süreci durmuş olabilir veya API kimlik doğrulaması başarısız olmuş olabilir.

• Çözüm: Gateway’i yeniden başlatın.

Sağlık denetimi çalıştırın:

Hata ayıklama günlükleri için:

Ayrıca API anahtarınızın geçerli olduğunu doğrulayın.

Port 18789 zaten kullanımda

Başka bir süreç OpenClaw gateway portunu kullanıyor.

• Çözüm: Çakışan süreci bulun ve durdurun

Ardından gateway’i yeniden başlatın:

EACCES izin hataları

Bu genellikle npm global dizininin doğru izinlere sahip olmadığı anlamına gelir.

• Çözüm: Dizin sahipliğini güncelleyin.

Windows’ta PowerShell’i Yönetici olarak çalıştırın veya özel bir npm prefix’i ayarlayın:

Docker kurulumlarında volume izinlerini düzeltin:

"spawn git ENOENT" hatası

Git kurulu değil veya PATH içinde erişilebilir değil.

• Çözüm: Git’i git-scm.com üzerinden kurun, terminalinizi yeniden başlatın ve kurulumu tekrar deneyin.

WSL2 systemd çalışmıyor

WSL yapılandırmanızda systemd etkin değil.

• Çözüm: /etc/wsl.conf dosyasını düzenleyip şunu ekleyin.

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

Linux terminalinizi yeniden açın ve doğrulayın:

VPS’te npm install sırasında bellek yetersizliği

Belleği düşük VPS instance’larında paket kurulumu sırasında hata oluşabilir.

• Çözüm: Bir swap dosyası oluşturun.

Ardından kurulumu yeniden çalıştırın.

Mesajlaşma platformlarına bağlanırken "Access not configured"

Hesabınız OpenClaw tarafından yetkilendirilmemiş.

• Çözüm: Eşleştirme kodunu kullanarak hesabınızı onaylayın.

Ayrıca bot kimlik bilgilerinizin (token, webhook, izinler) doğru yapılandırıldığını doğrulayın.

Sonuç

OpenClaw’ı macOS, Linux ve Windows üzerinde kurmak oldukça kolaydır. Kurulumunuza bağlı olarak tek satırlık script, PowerShell, WSL2 veya npm kullanabilirsiniz. İlk yapılandırma sihirbazı model seçimi, API yapılandırması ve mesajlaşma kanalları boyunca size rehberlik eder. Yerel bir ortam yönetmek istemezseniz Kimi Claw, OpenClaw’ı doğrudan bulutta çalıştırmanızı sağlayan tamamen barındırılan bir seçenek sunar.