Skip to main content

​
macOS geliştirici kurulumu

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

​
Ön koşullar

  • Kullanılabilir en son macOS sürümünde, Software Update üzerinden Xcode 26.2+ (Swift 6.2 araç zinciri).
  • Gateway, CLI ve paketleme betikleri için Node.js 24.15+ ve pnpm. Node 22.22.3+ da çalışır.

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

​
2. Uygulamayı derleyin ve paketleyin

dist/OpenClaw.app çıktısını oluşturur. Apple Developer ID sertifikası olmadan betik, geçici imzalamaya geri döner. Geliştirme çalıştırma modları, imzalama bayrakları ve Team ID sorunlarını giderme hakkında bilgi için apps/macos/README.md belgesine bakın. Depo kökünden hızlı geliştirme döngüsü: scripts/restart-mac.sh (geçici imzalama için --no-sign ekleyin; TCC izinleri --no-sign ile kalıcı olmaz).
Geçici olarak imzalanmış uygulamalar güvenlik istemlerini tetikleyebilir. Uygulama “Abort trap 6” hatasıyla hemen çökerse Sorun giderme bölümüne bakın.

​
3. CLI ve Gateway’i yükleyin

Paketlenmiş uygulama, standart scripts/install-cli.sh yükleyicisini içerir. Yeni bir profilde ilk katılım sırasında This Mac seçeneğini belirleyin; uygulama, Gateway sihirbazını başlatmadan önce eşleşen kullanıcı alanı CLI’sını ve çalışma zamanını yükler. Geliştirme sırasında elle kurtarma için eşleşen CLI’yı kendiniz yükleyin:
pnpm add -g openclaw@<version> ve bun add -g openclaw@<version> da çalışır. Gateway’in kendisi için önerilen çalışma zamanı Node 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 (Xcode 26.2+) gerektirir.
Sürümler eşleşmiyorsa macOS/Xcode’u güncelleyin ve derlemeyi yeniden çalıştırın.

​
İzin verilirken uygulama çöküyor

Speech Recognition veya Microphone erişimine izin vermeye çalıştığınızda uygulama çöküyorsa bunun nedeni bozulmuş bir TCC önbelleği veya imza uyuşmazlığı olabilir.
  1. Hata ayıklama paket kimliği için TCC izinlerini sıfırlayın:
  2. Bu işlem başarısız olursa macOS’ta temiz bir başlangıç sağlamak 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 kalıyor

Bir zombi işlemin bağlantı noktasını kullanıp kullanmadığını kontrol edin:
Bağlantı noktası elle başlatılmış bir işlem tarafından kullanılıyorsa işlemi durdurun (Ctrl+C) veya son çare olarak yukarıda bulunan PID’yi sonlandırın.

​
İlgili