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 -versionxcrun 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 statusopenclaw 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

• macOS uygulaması
• Yükleme genel bakışı