macOS geliştirici kurulumu

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

Ön koşullar

• Yazılım Güncelleme'de bulunan en son macOS sürümünde Xcode 26.2+ (Swift 6.2 araç zinciri).
• Gateway, CLI ve paketleme betikleri için Node.js 24 ve pnpm. Node 22.19+ da çalışır.

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

pnpm install

dist/OpenClaw.app çıktısını üretir. Apple Developer ID sertifikası yoksa 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).

2. Uygulamayı derleyin ve paketleyin

./scripts/package-mac-app.sh

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'sini 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> 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.

xcodebuild -versionxcrun swift --version

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:

   tccutil reset All ai.openclaw.mac.debug

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

Bağlantı noktasını bir zombi işlemin 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

Bağlantı noktasını elle başlatılmış bir işlem tutuyorsa işlemi durdurun (Ctrl+C) veya son çare olarak yukarıda bulunan PID'yi sonlandırın.

İlgili

• macOS uygulaması
• Kuruluma genel bakış