macOS companion app
macOS izinleri
macOS izinleri hassastır. TCC, bir izin yetkilendirmesini uygulamanın kod imzası, paket tanımlayıcısı ve diskteki yolu ile ilişkilendirir. Bunlardan herhangi biri değişirse macOS uygulamayı yeni olarak değerlendirir ve istemleri kaldırabilir veya gizleyebilir.
Kararlı izinler için gereksinimler
- Aynı yol: uygulamayı sabit bir konumdan çalıştırın (OpenClaw için
dist/OpenClaw.app). - Aynı paket tanımlayıcısı: OpenClaw'ın paket kimliği
ai.openclaw.macdeğeridir; bunu değiştirmek yeni bir izin kimliği oluşturur. - İmzalı uygulama: imzasız veya geçici imzayla imzalanmış derlemelerde izinler kalıcı olmaz.
- Tutarlı imza: imzanın yeniden derlemeler arasında kararlı kalması için gerçek bir Apple Development veya Developer ID sertifikası kullanın.
Geçici imzalar her derlemede yeni bir kimlik oluşturur. macOS önceki izinleri unutur ve eski girdiler temizlenene kadar istemler tamamen kaybolabilir.
Node ve CLI çalışma zamanları için Erişilebilirlik izinleri
Genel bir node ikili dosyası yerine Erişilebilirlik iznini OpenClaw.app, Peekaboo.app veya kendi paket tanımlayıcısına sahip başka bir imzalı yardımcı uygulamaya vermeyi tercih edin.
macOS TCC, Erişilebilirlik iznini gördüğü işlemin kod kimliğine verir. Bir Homebrew, nvm, pnpm veya npm iş akışı, paylaşılan bir node yürütülebilir dosyasının Erişilebilirlik izni almasına neden olursa aynı yürütülebilir dosya üzerinden başlatılan tüm JavaScript paketleri grafik arayüz otomasyonu ayrıcalıklarını devralabilir.
Sistem Ayarları'ndaki bir node girdisini tek bir npm paketine verilen izin olarak değil, söz konusu Node çalışma zamanı için geniş kapsamlı bir izin olarak değerlendirin. Tam olarak bu Node kurulumuyla başlatılan her betiğe ve pakete güvenmiyorsanız node için Erişilebilirlik izni vermekten kaçının.
Yanlışlıkla node için Erişilebilirlik izni verdiyseniz bu girdiyi Sistem Ayarları -> Gizlilik ve Güvenlik -> Erişilebilirlik bölümünden kaldırın. Ardından kullanıcı arayüzü otomasyonunun sahibi olması gereken imzalı uygulamaya veya yardımcı uygulamaya izin verin.
İstemler kaybolduğunda kurtarma denetim listesi
- Uygulamadan çıkın.
- Sistem Ayarları -> Gizlilik ve Güvenlik bölümündeki uygulama girdisini kaldırın.
- Uygulamayı aynı yoldan yeniden başlatın ve izinleri tekrar verin.
- İstem hâlâ görünmüyorsa TCC girdilerini
tccutilile sıfırlayıp tekrar deneyin. - Bazı izinler yalnızca macOS tamamen yeniden başlatıldıktan sonra tekrar görünür.
Örnek sıfırlama komutları (OpenClaw'ın paket kimliği ai.openclaw.mac kullanılarak):
sudo tccutil reset Accessibility ai.openclaw.macsudo tccutil reset ScreenCapture ai.openclaw.macsudo tccutil reset AppleEventsDosya ve klasör izinleri (Masaüstü/Belgeler/İndirilenler)
macOS, terminal veya arka plan işlemlerinin Masaüstü, Belgeler ve İndirilenler klasörlerine erişimini de kısıtlayabilir. Dosya okumaları veya dizin listelemeleri yanıt vermiyorsa dosya işlemlerini gerçekleştiren işlem bağlamına erişim verin (örneğin Terminal/iTerm, LaunchAgent tarafından başlatılan uygulama veya SSH işlemi).
Geçici çözüm: klasör başına izin vermekten kaçınmak istiyorsanız dosyaları OpenClaw çalışma alanına (~/.openclaw/workspace) taşıyın.
İzinleri test ediyorsanız her zaman gerçek bir sertifikayla imzalayın. Geçici imzalı derlemeler yalnızca izinlerin önemli olmadığı hızlı yerel çalıştırmalar için kabul edilebilir.
