OpenClaw Mac’e nasıl kurulur?

OpenClaw, çalışma tarzınıza ve kurulumu nasıl yönetmek istediğinize bağlı olarak Mac’e birkaç farklı şekilde kurulabilir. Bu kılavuzda, farklı kurulum yöntemleri için adım adım yönergelerin yanı sıra OpenClaw’ı sorunsuz çalıştırmanıza yardımcı olacak ipuçlarını bulacaksınız.

Kısa bakış: OpenClaw’ı Mac’e kurmanın üç yolu

Aşağıda üç yöntemi yan yana karşılaştırabilirsiniz. Her biri, ne kadar manuel kurulum yapmanız gerektiği bakımından farklılık gösterir.

Kimi Claw, Node.js, Homebrew veya API anahtarı kurmadan OpenClaw’ı bulutta çalıştırmanızı sağlar. Tarayıcınızda çalışan bir agent’ı dakikalar içinde kullanmaya başlayabilirsiniz.

Yerel kurulumu tercih ediyorsanız bir sonraki bölüme geçin. Daha basit bir seçenek istiyorsanız Kimi Claw ile Mac’te OpenClaw çalıştırma bölümüne atlayın veya hemen başlamak için aşağıdaki düğmeye tıklayın.

Başlamadan önce: Temel hazırlık ve güvenlik

OpenClaw’ı Mac’e yerel olarak kurmadan önce tamamlamanız gereken birkaç hazırlık ve güvenlik adımı vardır. Kimi Claw kullanmayı planlıyorsanız bu bölümü atlayıp doğrudan aşağıdaki kurulum yönergelerine geçebilirsiniz.

• Bağımlılıklar: Tek satırlık yükleyici gerektiğinde Node.js’i otomatik olarak kurar. Homebrew’ü seçerseniz Node.js’i manuel olarak kurmanız gerekir (Node 24 önerilir; Node 22 LTS 22.16+ da çalışır).

• Güvenlik duvarı ve ağ ayarları: macOS güvenlik duvarı genellikle varsayılan olarak kapalıdır. Sistem Ayarları > Ağ > Güvenlik Duvarı yolundan etkinleştirebilirsiniz. OpenClaw gateway’i 127.0.0.1’e (localhost) bağlar; bu nedenle ağınızdaki diğer cihazlar doğrudan bağlanamaz. Mobil veya uzaktan erişime ihtiyacınız varsa Tailscale ya da SSH tüneli gibi araçlar kullanabilirsiniz. Yönlendiriciniz üzerinden 18789 portunu yönlendirmeyin.

Tek satırlık betikle OpenClaw’ı Mac’e kurma

OpenClaw’ı Mac’te yerel olarak çalıştırmanın en hızlı yolu budur. OpenClaw, geleneksel bir grafik uygulama yerine Terminal’den çalışır ve agent’ınızı yönetmek için tarayıcı tabanlı bir arayüz sunar. Tek bir komut CLI’yi kurar, Node.js sürümünüzü kontrol eder ve başlangıç sihirbazını açar.

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

Spotlight (⌘ + Space) ile Terminal’i açın, ardından aşağıdaki komutu yapıştırın:

Betik sisteminizi algılar, OpenClaw CLI’yi kurar ve Node.js sürümünüzü kontrol eder. Node.js yoksa veya güncel değilse Node 24’ü otomatik olarak kurar (Node 22 LTS 22.16+ da desteklenir).

2. Adım: API anahtarınızı ayarlayın ve gateway’i yapılandırın

Kurulum tamamlandıktan sonra başlangıç sihirbazı otomatik olarak başlar. LLM sağlayıcınız olarak Moonshot AI (Kimi K2.5) seçin ve istendiğinde Kimi API anahtarınızı yapıştırın. Gateway portu ve kimlik doğrulama için varsayılan ayarları kabul edin. Mac’iniz açıldığında OpenClaw’ın otomatik başlamasını istiyorsanız başlangıç sırasında daemon kurulum seçeneğini seçin.

3. Adım: Gateway’i doğrulayın ve dashboard’u açın

Gateway’in çalıştığını kontrol etmek için aşağıdaki komutu çalıştırın:

Ardından dashboard’u açın:

Bu komut tarayıcınızda http://127.0.0.1:18789 adresinde Control UI’ı açar. Oturum açmak için gateway token’ınızı girin. Oturum açtıktan sonra OpenClaw agent’ınızla etkileşime geçmeye başlayabilirsiniz.

Homebrew ile OpenClaw’ı Mac’e kurma

Paketleri Homebrew ile yönetmeyi tercih ediyorsanız OpenClaw’ı Mac’e daha manuel bir kurulumla yükleyebilirsiniz. Bu yöntem bağımlılıklar üzerinde daha fazla denetim sağlar ve mevcut Homebrew iş akışınıza uyum sağlar.

1. Adım: Homebrew’ü kurun

Spotlight (⌘ + Space) ile Terminal’i açın. Homebrew kurulu değilse aşağıdaki komutu çalıştırın. Homebrew, macOS için bir paket yöneticisidir; uygulama mağazasının uygulamaları yüklemesine benzer şekilde, geliştirici araçlarını Terminal’den kurup yönetmenizi sağlar.

Kurulum sırasında Mac oturum açma parolanızı girmeniz istenebilir. Güvenlik nedeniyle Terminal’in siz yazarken hiçbir karakter göstermeyeceğini unutmayın. Kurulumu onaylamanızı isteyen iletiler ve dosyaların kurulduğunu gösteren mesajlar da görebilirsiniz.

Kurulum tamamlandığında Terminal’de başarı mesajını ve sonraki adımları görürsünüz.

2. Adım: Node.js’i kurun

Homebrew kurulduktan sonra Node.js’i yükleyin:

Kurulumdan sonra sürümün v24 (önerilir) veya v22.16+ olduğunu doğrulayın.

3. Adım: OpenClaw CLI’yi kurun ve başlangıç sihirbazını çalıştırın

CLI’yi npm ile global olarak kurun, ardından başlangıç sihirbazını çalıştırın:

npm install -g sırasında EACCES izin hatası görürseniz npm global dizininiz yükseltilmiş erişim gerektiriyor demektir. Ya sudo npm install -g openclaw@latest komutunu çalıştırın ya da ileride sudo kullanmamak için npm varsayılan dizininizi değiştirin.

--install-daemon bayrağı OpenClaw’ı LaunchAgent olarak kaydeder; böylece gateway oturum açtığınızda otomatik olarak başlar. Başlangıç sırasında sağlayıcı olarak Moonshot AI (Kimi K2.5) seçin ve Kimi API anahtarınızı girin.

4. Adım: Gateway’i kontrol edin ve dashboard’u açın

Gateway’in çalıştığını doğrulayın ve dashboard’u açın:

Control UI tarayıcınızda açılır. Gateway token’ınızı girin; artık hazırsınız.

Kimi Claw ile Mac’te OpenClaw çalıştırma

Kimi Claw, yerel kurulum yapmadan OpenClaw’ı bulutta çalıştırmanızı sağlayan çevrim içi bir araçtır. Mac’inize hiçbir şey yüklemeniz gerekmez; Terminal kullanmanız veya bağımlılıkları yönetmeniz de gerekmez. Her şey tarayıcınızda çalışır. Dakikalar içinde bir OpenClaw agent oluşturabilirsiniz. Kimi Claw gateway’i, çalışma alanını, depolamayı ve model erişimini yönetir; böylece agent’ınız MacBook’unuz kapalıyken bile 7/24 çevrim içi kalır.

Kimi Claw nasıl kullanılır?

1. Adım: Kimi Claw’ı açın

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

2. Adım: OpenClaw’ı otomatik olarak dağıtın

Açılır pencerede dağıtımı onaylayın. Ardından Kimi Claw, gateway, çalışma alanı ve araçlar dâhil OpenClaw ortamını kurar. Süreç genellikle birkaç dakika içinde tamamlanır.

3. Adım: OpenClaw’ı kullanmaya başlayın

Dağıtım tamamlandığında çalışma alanınız dashboard’da açılır. Agent’ınızla sohbet etmeye, becerileri ayarlamaya, görevleri zamanlamaya ve dosyaları yönetmeye doğrudan tarayıcıdan başlayabilirsiniz.

Kimi Claw’ın OpenClaw’ı yerel çalıştırmaktan farkı

Kimi Claw, OpenClaw’ı yerel kurulum olmadan çalıştırmanın daha basit bir yolunu sunar. Bağımlılıkları kurup yerel bir ortam yönetmek yerine agent’ınızı doğrudan tarayıcıda çalıştırabilirsiniz; alttaki kurulum ve altyapıyı Kimi Claw üstlenir.

• Yerel kurulum gerekmez: Node.js kurmadan veya Terminal kullanmadan OpenClaw’ı çalıştırın. Her şey doğrudan tarayıcınızda çalışır; böylece daha hızlı başlayabilir ve ortam kurulum sorunlarından kaçınabilirsiniz.

• 5.000’den fazla beceriye anında erişim: Araçları manuel kurmak yerine Kimi Claw, mevcut geniş araç kütüphanesinden göreviniz için gereken becerileri otomatik olarak kullanabilir; bu da kurulum süresini ve uyumluluk sorunlarını azaltır.

• Kesintisiz otomasyon ve zamanlama: Mac’iniz uyuduğunda duran yerel agent’ların aksine Kimi Claw bulutta 7/24 çalışır; bu da onu zamanlanmış görevler ve uzun soluklu iş akışları için uygun kılar.

• 40GB bulut depolama ve kalıcı bellek: Dosyaların genellikle tek bir cihaza bağlı olduğu yerel kurulumların aksine Kimi Claw 40GB depolama alanı içerir; raporlarınıza ve araştırmalarınıza herhangi bir tarayıcıdan erişebilirsiniz. Ayrıca tercihlerinizi ve çalışma bağlamınızı oturumlar arasında hatırlar; böylece kaldığınız yerden devam edebilirsiniz.

• Entegre Kimi K2.5 modeli ve profesyonel düzeyde arama: Kimi Claw, Kimi K2.5’e yerleşik erişim ve gelişmiş arama özellikleriyle gelir; bu nedenle API anahtarlarını yönetmeniz veya harici servisleri kurmanız gerekmez. Finans, teknoloji ve haberler gibi alanlarda güncel bilgileri otomatik olarak içeri alabilir; araştırma ve görev yürütme süreçlerini daha akıcı hâle getirir.

OpenClaw’ı Mac’te 7/24 çalışır durumda tutma

Çoğu kullanıcı AI’ı geleneksel bir masaüstü uygulaması gibi kullanır: masanızdayken açar, işiniz bitince kapatırsınız. Oysa gece boyunca küresel piyasaları izlemek ya da sabah 08.00’de araştırma raporunun gelen kutunuzda hazır olması gibi değerli otomasyonlar için agent’ınızın kesintisiz etkin kalması gerekir. macOS, sistem uykuya geçtiğinde yerel süreçleri doğal olarak duraklattığından bunu sağlamak için özel bir strateji gerekir. Bu bölümde kalıcı bağlantıyı sürdürmenin iki yolunu ele alıyoruz:

Seçenek A: Ayrılmış Mac donanımı

Bir seçenek, bir Mac’i (örneğin Mac mini) sürekli çalışır durumda tutmaktır. sudo pmset -a sleep 0 komutuyla uyku modunu devre dışı bırakabilir ve Sistem Ayarları’nda “Ağ erişimi için uyandır” seçeneğini etkinleştirebilirsiniz. Uzaktan erişim için Tailscale veya SSH tüneli gibi araçlar kullanabilirsiniz.

Bu kurulum OpenClaw’ı kendi donanımınızda çalışır tutar; ancak makinenizi açık bırakmanızı ve bakım, güncelleme ve yeniden başlatma işlemlerini kendiniz yönetmenizi gerektirir.

Seçenek B: Kimi Claw bunu otomatik olarak halleder

Agent’ınızı Kimi Claw ile çalıştırırsanız 7/24 erişilebilirlik yerleşik olarak gelir. Agent’ınız yerel cihazınızdan bağımsız çalışır; bu nedenle Mac’iniz kapalı veya çevrim dışıyken bile çalışmaya devam eder. Uyku ayarlarını değiştirmeniz ya da bir makineyi sürekli açık tutmanız gerekmez.

Mac’te yaygın OpenClaw kurulum hatalarını giderme

Basit bir kurulumda bile yükleme sırasında sorunlarla karşılaşabilirsiniz. Sık görülen bazı sorunlar ve çözümleri şöyle:

OpenClaw komutu bulunamadı hatası

• Neden: npm global bin dizini shell PATH’inizde değil.

• Çözüm: Shell yapılandırmanızı yeniden yüklemek için source ~/.zshrc komutunu çalıştırın. Zsh yerine Bash kullanıyorsanız ~/.zshrc yerine ~/.bash_profile kullanın. Hata devam ederse npm prefix’inizi bulun ve PATH’e ekleyin:

OpenClaw yeniden başlatmadan sonra başlamıyor

• Neden: LaunchAgent başlangıç sırasında kurulmamış.

• Çözüm: Başlangıç komutunu daemon bayrağıyla çalıştırın:

Bu işlem, oturum açtığınızda OpenClaw gateway’in otomatik olarak başlamasını sağlayan bir LaunchAgent kaydeder. Etkin olduğunu doğrulamak için:

18789 portu zaten kullanımda

• Neden: Başka bir süreç gateway portunu kullanıyor.

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

Beceri kurulumu sırasında Xcode Command Line Tools hatası

• Neden: Bazı npm paketleri native derleme gerektirir ve Xcode Command Line Tools eksik ya da güncel değildir.

• Çözüm: Araçları kurun veya güncelleyin:

Kurulum tamamlandıktan sonra beceriyi yeniden kurmayı deneyin.

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

• Neden: Mac’inizde 22.16’dan eski bir Node.js sürümü kurulu. OpenClaw için Node 24 (önerilir) veya Node 22 LTS 22.16+ gerekir.

• Çözüm: Homebrew kullandıysanız:

Tek satırlık yükleyiciyi kullandıysanız yeniden çalıştırın. Betik eski sürümü algılar ve günceller.

Sonuç

OpenClaw, tek satırlık yükleyici veya Homebrew ile Mac’inizde yerel olarak ya da yerel kurulum gerektirmeden Kimi Claw ile tarayıcınızda çalışabilir. Her yöntem çalışan bir agent’a ulaşmanızı sağlar; ancak gerektirdiği manuel çaba düzeyi farklıdır. 7/24 erişilebilirliği yerleşik, daha hızlı bir kurulum istiyorsanız Kimi Claw ile başlayabilir ve agent’ınızı dakikalar içinde çalışır hâle getirebilirsiniz.