macOS companion app
macOS izinleri
macOS izin verme işlemleri kırılgandır. TCC, bir izin verme işlemini uygulamanın kod imzası, paket tanımlayıcısı ve diskteki yolu ile ilişkilendirir. Bunlardan herhangi biri değişirse macOS uygulamayı yeni kabul eder 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ı: paket kimliğini değiştirmek yeni bir izin kimliği oluşturur.
- İmzalı uygulama: imzasız veya ad-hoc imzalı derlemeler izinleri kalıcı tutmaz.
- Tutarlı imza: imzanın yeniden derlemeler arasında kararlı kalması için gerçek bir Apple Development veya Developer ID sertifikası kullanın.
Ad-hoc imzalar her derlemede yeni bir kimlik oluşturur. macOS önceki izinleri unutacaktır ve eski girdiler temizlenene kadar istemler tamamen kaybolabilir.
Node ve CLI çalışma zamanları için Erişilebilirlik izinleri
Genel bir node ikilisi yerine OpenClaw.app, Peekaboo.app veya kendi paket tanımlayıcısına sahip başka bir imzalı yardımcıya Erişilebilirlik izni 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 almasına neden olursa, aynı yürütülebilir dosya üzerinden başlatılan herhangi bir JavaScript paketi GUI otomasyon ayrıcalıklarını devralabilir.
Sistem Ayarları'ndaki bir node girdisini tek bir npm paketine verilmiş izin olarak değil, ilgili Node çalışma zamanı için geniş kapsamlı izin olarak değerlendirin. Tam olarak o Node kurulumu üzerinden 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 UI otomasyonunun sahibi olması gereken imzalı uygulamaya veya yardımcıya izin verin.
İstemler kaybolduğunda kurtarma kontrol listesi
- Uygulamadan çıkın.
- Uygulama girdisini Sistem Ayarları -> Gizlilik ve Güvenlik bölümünden kaldırın.
- Uygulamayı aynı yoldan yeniden başlatın ve izinleri yeniden verin.
- İstem hâlâ görünmüyorsa TCC girdilerini
tccutilile sıfırlayın ve tekrar deneyin. - Bazı izinler yalnızca tam bir macOS yeniden başlatmasından sonra tekrar görünür.
Örnek sıfırlamalar (paket kimliğini gerektiği gibi değiştirin):
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/arka plan işlemleri için Masaüstü, Belgeler ve İndirilenler klasörlerini de kısıtlayabilir. Dosya okumaları veya dizin listelemeleri takılırsa, dosya işlemlerini gerçekleştiren aynı işlem bağlamına erişim izni verin (örneğin Terminal/iTerm, LaunchAgent tarafından başlatılan uygulama veya SSH işlemi).
Geçici çözüm: klasör başına izinlerden 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. Ad-hoc derlemeler yalnızca izinlerin önemli olmadığı hızlı yerel çalıştırmalar için kabul edilebilir.
