macOS’ta OpenClaw Nasıl Kurulur: Mac Mini için Tam Kurulum Rehberi

OpenClaw, geniş sistem düzeyinde izinlerle çalışan, güçlü bir açık kaynaklı, kendi kendine barındırılan AI aracı çerçevesidir ve tam otomatik bir kişisel asistan olarak işlev görür. Yerel donanımınızda 24/7 çalışan, Telegram, WhatsApp, Slack ve iMessage gibi popüler mesajlaşma platformlarına bağlanır, shell komutlarını yürütür, web’de gezinir, dosyaları yönetir ve Anthropic’in Claude ve OpenAI’nin GPT serisi gibi endüstri lideri AI modelleriyle sorunsuz bir şekilde entegre olur.

Bulut bağımlılığı olmadan maksimum performans ve güvenilirlik isteyenler için, özel bir Mac Mini — özellikle Apple Silicon M serisi modelleri (M1 ile M4 arasında) — mevcut en iyi platformlardan biridir. Bu makineler sessiz, enerji verimli, her zaman açık ve macOS ile derin entegrasyona sahiptir, bu da onları kalıcı bir AI aracısı çalıştırmak için ideal kılar. Bu rehber, bir AlexHost Mac Mini sunucusunda kendi OpenClaw asistanınızı kurmanın her adımında size yol gösterir.

> ⚠️ Güvenlik Uyarısı: OpenClaw geniş sistem düzeyinde izinlerle çalışır. Dosyaları okuyabilir, terminal komutlarını yürütebilir, mesaj gönderebilir ve web’de sizin adınıza otonom olarak gezinebilir. İCloud dosyaları, parolalar veya kişisel fotoğraflar gibi hassas veriler eşitlenmişse, bunu birincil kişisel makinenize yüklemeyin. Bu rehberde açıklanan Mac Mini sunucusu gibi özel, izole bir cihaz, güçlü bir şekilde önerilen yaklaşımdır.

Ön Koşullar: Başlamadan Önce İhtiyacınız Olanlar

Kuruluma dalmadan önce, aşağıdakilere sahip olduğunuzdan emin olun:

• Bir AlexHost Mac Mini sunucusu (Apple Silicon M serisi önerilir)
• Mac Mini’nize SSH veya uzaktan erişim (AlexHost’un bağlantı rehberine bakın)
• console.anthropic.com’dan bir Anthropic API anahtarı (veya GPT modellerini tercih ederseniz bir OpenAI API anahtarı)
• Bir Telegram hesabı (isteğe bağlı, mesajlaşma kanalı entegrasyonu için)
• Terminal ve komut satırı işlemleri hakkında temel bilgi

Mac Mini’nin ötesinde güvenilir, her zaman açık bir barındırma ortamı arıyorsanız, AlexHost ayrıca AI aracısı iş yüklerini saatin etrafında çalıştırabilen yüksek performanslı VPS Barındırma ve Özel Sunucular sunmaktadır.

Adım 1: Mac Mini Sunucunuza Bağlanın

AlexHost Mac Mini’nize uzaktan bir bağlantı kurmaya başlayın. SSH veya uzak masaüstü aracılığıyla sunucunuza erişmek için AlexHost’un resmi Mac Mini bağlantı rehberini izleyin. Makinede çalışan bir Terminal oturumunuz olduğunda, devam etmeye hazırsınız.

Adım 2: Gerekli Bağımlılıkları Yükleyin

2.1 Homebrew’i Yükleyin

Homebrew, macOS için fiili paket yöneticisidir ve Node.js ve diğer bağımlılıkları yüklemek için gereklidir. Mac Mini’nizde Terminal’i açın ve aşağıdaki komutu çalıştırın:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Ekrandaki talimatları izleyin ve kurulumun tamamlanmasını bekleyin.

Yalnızca Apple Silicon kullanıcıları (M1/M2/M3/M4): Kurulumdan sonra, Homebrew’i shell’inizin PATH’ine eklemeniz gerekir. Bu iki komutu çalıştırın:

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

Bu, Homebrew tarafından yüklenen ikili dosyaların herhangi bir yeni Terminal oturumundan erişilebilir olmasını sağlar.

2.2 Node.js’yi Yükleyin (Sürüm 22 veya Daha Yeni Gerekli)

OpenClaw, Node.js v22 veya daha yüksek bir sürüm gerektirir. Homebrew aracılığıyla yükleyin:

brew install node

Yüklü sürümü doğrulayın:

node --version

v22.x.x veya daha yüksek bir çıktı görmelisiniz. Daha eski bir sürüm görüntülenirse, hemen yükseltin:

brew upgrade node

Node.js v22 veya daha yeni bir sürüm doğrulanana kadar devam etmeyin — eski sürümler OpenClaw yükleyicisinin başarısız olmasına neden olacaktır.

Adım 3: OpenClaw’ı Yükleyin

3.1 Resmi Yükleyici Betiğini Çalıştırın

Node.js yerinde olduğunda, resmi tek satırlık yükleyiciyi kullanarak OpenClaw’ı yükleyin:

curl -fsSL https://openclaw.ai/install.sh | bash

Bu betik otomatik olarak:

• İşletim sisteminizi ve mimarinizi algılar
• Uyumlu bir Node.js sürümünün mevcut olduğunu doğrular
• OpenClaw CLI’yi sisteminize global olarak yükler
• Çalışma zamanı ortamını hazırlar

Onay mesajını görene kadar bekleyin:

Installation finished successfully!

3.2 Kurulumu Doğrulayın

OpenClaw CLI’nin doğru şekilde yüklendiğini ve erişilebilir olduğunu doğrulayın:

openclaw --version

Terminal’e bir sürüm numarası yazdırılmalıdır. “Komut bulunamadı” hatası alırsanız, Terminal pencerenizi tamamen kapatın, yeniden açın ve komutu tekrar deneyin. Bu, shell’inizin PATH’ini yeniler ve genellikle sorunu çözer.

Adım 4: Ekleme ve Yapılandırma

Bu adım, OpenClaw’ı Anthropic’in Claude’u AI arka ucu olarak kullanacak şekilde yapılandırır ve arka plan hizmeti daemon’unu ayarlar.

4.1 Ekleme Sihirbazını Çalıştırın

openclaw onboard --install-daemon

--install-daemon bayrağı önemlidir — OpenClaw’ı her sistem önyüklemesinde otomatik olarak başlayan bir arka plan hizmeti olarak kaydeder, AI asistanınızın manuel müdahale olmadan her zaman kullanılabilir olmasını sağlar.

Etkileşimli sihirbaz sizi üç yapılandırma alanında rehberlik edecektir:

a) Kimlik Doğrulama — API Anahtarı Kurulumu

API anahtarı istendiğinde, console.anthropic.com’dan Anthropic API anahtarınızı yapıştırın. OpenClaw, Claude ile iletişim kurmak için bu anahtarı kullanacaktır.

> 💡 Faturalandırma notu: Anthropic, belirteç kullanımı başına ücret alır. Aktif olarak kullanılan bir kişisel asistan için, sorgu hacmine ve model seçimine bağlı olarak günde birkaç dolar aralığında maliyetler bekleyin.

b) Ağ Geçidi Ayarları — Port Yapılandırması

Belirli bir nedeniniz olmadığı sürece varsayılan ağ geçidi ayarlarını kabul edin. Varsayılan ağ geçidi bağlantı noktası 18989‘dir. Bu, OpenClaw’ın web arayüzü ve mesajlaşma entegrasyonlarının iletişim kurduğu bağlantı noktasıdır.

c) Kanal Kurulumu — Mesajlaşma Entegrasyonu

Bu aşamada, bir mesajlaşma uygulamasını bağlayabilir (Adım 5’te ayrıntılı olarak ele alınmıştır) veya şimdilik atlayabilir ve bunun yerine web tabanlı panoyu kullanabilirsiniz. Web arayüzünü ilk olarak test etmek istiyorsanız “şimdilik atla” seçeneğini seçin.

4.2 Ağ Geçidinin Çalıştığını Doğrulayın

Ekleme işleminden sonra, OpenClaw ağ geçidi hizmetinin etkin olduğunu doğrulayın:

openclaw gateway status

Çıktı, ağ geçidinin çalıştığını doğrulamalıdır. Çalışmıyorsa, manuel olarak başlatın:

openclaw gateway --port 18789

4.3 Web Panosunu Açın

OpenClaw kontrol arayüzünü tarayıcınızda başlatın:

openclaw dashboard

Bu, web tabanlı panoyu şu adreste açar:

http://127.0.0.1:18789/

Pano başarıyla yüklenirse, ağ geçidiniz tamamen işlevseldir. Mesajlaşma uygulaması yapılandırması olmadan hemen tarayıcıdan doğrudan OpenClaw ile sohbet etmeye başlayabilirsiniz — bu aşamada gerekli değildir.

Adım 5: Telegram Mesajlaşma Kanalını Bağlayın (İsteğe Bağlı)

OpenClaw’ı Telegram’a bağlamak, AI asistanınızla dünyanın herhangi bir yerinden, herhangi bir cihazdan Telegram uygulamasını kullanarak etkileşim kurmanıza olanak tanır.

5.1 BotFather Aracılığıyla Bir Telegram Bot Oluşturun

1. Telegram’ı açın ve @BotFather‘ı arayın
2. Bir sohbet başlatın ve şu komutu gönderin: /newbot
3. BotFather’ın talimatlarını izleyin — botunuz için bir görünen ad ve bir kullanıcı adı seçeceksiniz
4. BotFather, bir bot API belirteci oluşturacak ve gönderecektir — bu belirteci hemen kopyalayın ve güvenli tutun

5.2 Bot Belirtecini OpenClaw’a Kaydedin

Mac Mini Terminal’inize dönün ve çalıştırın:

openclaw onboard

Bir mesajlaşma kanalı seçmeniz istendiğinde, Telegram‘ı seçin ve istendiğinde bot API belirtecini yapıştırın.

5.3 Sohbet Etmeye Başlayın

Telegram’ı açın, yeni oluşturduğunuz botu kullanıcı adıyla bulun ve ona bir mesaj gönderin. OpenClaw, Telegram arayüzü aracılığıyla yanıt verecek ve size uygulamada doğrudan tam AI asistan yetenekleri sunacaktır.

Yaygın Sorunları Giderme