Ana içeriğe atla

​
macOS geliştirici kurulumu

OpenClaw macOS uygulamasını kaynaktan derleyin ve çalıştırın.

​
Ön koşullar

Uygulamayı derlemeden önce aşağıdakilerin yüklü olduğundan emin olun:
  1. Xcode 26.2+: Swift geliştirme için gereklidir.
  2. Node.js 24 ve pnpm: Gateway, CLI ve paketleme betikleri için önerilir. Şu anda 22.19+ olan Node 22 LTS, uyumluluk için desteklenmeye devam eder.

​
1. Bağımlılıkları Yükleyin

Proje genelindeki bağımlılıkları yükleyin: 
pnpm install

​
2. Uygulamayı Derleyin ve Paketleyin

macOS uygulamasını derleyip dist/OpenClaw.app içine paketlemek için şunu çalıştırın: 
./scripts/package-mac-app.sh
Apple Developer ID sertifikanız yoksa betik otomatik olarak ad-hoc imzalama (-) kullanır. Geliştirme çalıştırma modları, imzalama bayrakları ve Team ID sorunlarını giderme için macOS uygulaması README dosyasına bakın: https://github.com/openclaw/openclaw/blob/main/apps/macos/README.md
Not: Ad-hoc imzalanmış uygulamalar güvenlik istemlerini tetikleyebilir. Uygulama “Abort trap 6” ile hemen çöküyorsa Sorun Giderme bölümüne bakın.

​
3. CLI ve Gateway’i Yükleyin

Paketlenmiş uygulama kanonik scripts/install-cli.sh yükleyicisini gömer. Yeni bir profilde, ilk kurulum sırasında Bu Mac seçeneğini seçin; uygulama Gateway sihirbazını başlatmadan önce eşleşen kullanıcı alanı CLI ve çalışma zamanını yükler. Elle geliştirme kurtarması için eşleşen CLI’yi kendiniz yükleyin: 
npm install -g openclaw@<version>
pnpm add -g openclaw@<version> ve bun add -g openclaw@<version> de çalışır. Gateway çalışma zamanı için Node önerilen yol olmaya devam eder.

​
Sorun Giderme

​
Derleme başarısız oluyor: araç zinciri veya SDK uyuşmazlığı

macOS uygulama derlemesi en son macOS SDK’sını ve Swift 6.2 araç zincirini bekler. Sistem bağımlılıkları (gerekli):
  • Yazılım Güncelleme’de kullanılabilen en son macOS sürümü (Xcode 26.2 SDK’ları için gereklidir)
  • Xcode 26.2 (Swift 6.2 araç zinciri)
Kontroller: 
xcodebuild -version
xcrun swift --version
Sürümler eşleşmiyorsa macOS/Xcode’u güncelleyin ve derlemeyi yeniden çalıştırın.

​
Uygulama izin verme sırasında çöküyor

Speech Recognition veya Microphone erişimine izin vermeye çalıştığınızda uygulama çöküyorsa bunun nedeni bozuk bir TCC önbelleği veya imza uyuşmazlığı olabilir. Düzeltme:
  1. TCC izinlerini sıfırlayın: 
    tccutil reset All ai.openclaw.mac.debug
  2. Bu başarısız olursa macOS’tan “temiz sayfa” zorlamak için scripts/package-mac-app.sh içindeki BUNDLE_ID değerini geçici olarak değiştirin.

​
Gateway süresiz olarak “Starting…” durumunda

Gateway durumu “Starting…” olarak kalıyorsa bir zombi sürecin bağlantı noktasını tutup tutmadığını kontrol edin: 
openclaw gateway status
openclaw gateway stop

# LaunchAgent kullanmıyorsanız (geliştirme modu / elle çalıştırmalar), dinleyiciyi bulun:
lsof -nP -iTCP:18789 -sTCP:LISTEN
Elle çalıştırma bağlantı noktasını tutuyorsa o süreci durdurun (Ctrl+C). Son çare olarak yukarıda bulduğunuz PID’yi sonlandırın.

​
İlgili