Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
macOS geliştirici kurulumu

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

​
Ön koşullar

Uygulamayı derlemeden önce aşağıdakilerin kurulu 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.16+ 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 sorun 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’ı yükleyin

macOS uygulaması, arka plan görevlerini yönetmek için genel bir openclaw CLI kurulumunun olmasını bekler. Yüklemek için (önerilir):
  1. OpenClaw uygulamasını açın.
  2. General ayarlar sekmesine gidin.
  3. “Install CLI” düğmesine tıklayın.
Alternatif olarak elle 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 uyumsuzluğu

macOS uygulama derlemesi en yeni macOS SDK’sını ve Swift 6.2 araç zincirini bekler. Sistem bağımlılıkları (gerekli):
  • Software Update içinde sunulan en yeni macOS sürümü (Xcode 26.2 SDK’ları tarafından 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.

​
İzin verme sırasında uygulama çö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 uyumsuzluğu 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 başlangıç” zorlamak için scripts/package-mac-app.sh içindeki BUNDLE_ID değerini geçici olarak değiştirin.

​
Gateway “Starting…” durumunda süresiz kalıyor

Gateway durumu “Starting…” olarak kalıyorsa bağlantı noktasını tutan bir zombi süreç olup olmadığı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ırılan bir süreç bağlantı noktasını tutuyorsa bu süreci durdurun (Ctrl+C). Son çare olarak yukarıda bulduğunuz PID’yi sonlandırın.

​
İlgili