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

pnpm install

2. Uygulamayı derleyin ve paketleyin

./scripts/package-mac-app.sh

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).

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:

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

Bir zombi işlemin bağlantı noktasını kullanıp kullanmadığı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ı 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

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