macOS companion app
Uprawnienia macOS
Uprawnienia macOS są delikatne. TCC wiąże przyznanie uprawnienia z podpisem kodu aplikacji, identyfikatorem bundle i ścieżką na dysku. Jeśli którakolwiek z tych rzeczy się zmieni, macOS traktuje aplikację jako nową i może usunąć lub ukryć prompty.
Wymagania dla stabilnych uprawnień
- Ta sama ścieżka: uruchamiaj aplikację z ustalonej lokalizacji (dla OpenClaw
dist/OpenClaw.app). - Ten sam identyfikator bundle: zmiana bundle ID tworzy nową tożsamość uprawnień.
- Podpisana aplikacja: niepodpisane albo podpisane ad-hoc buildy nie utrwalają uprawnień.
- Spójny podpis: używaj prawdziwego certyfikatu Apple Development albo Developer ID, aby podpis pozostawał stabilny między przebudowaniami.
Podpisy ad-hoc generują nową tożsamość przy każdym buildzie. macOS zapomni wcześniejsze przyznania, a prompty mogą całkowicie zniknąć, dopóki nie zostaną wyczyszczone stare wpisy.
Lista kontrolna odzyskiwania, gdy prompty znikają
- Zamknij aplikację.
- Usuń wpis aplikacji w System Settings -> Privacy & Security.
- Uruchom ponownie aplikację z tej samej ścieżki i ponownie przyznaj uprawnienia.
- Jeśli prompt nadal się nie pojawia, zresetuj wpisy TCC przez
tccutili spróbuj ponownie. - Niektóre uprawnienia pojawiają się ponownie dopiero po pełnym restarcie macOS.
Przykładowe resety (w razie potrzeby zastąp bundle ID):
sudo tccutil reset Accessibility ai.openclaw.mac
sudo tccutil reset ScreenCapture ai.openclaw.mac
sudo tccutil reset AppleEvents
Uprawnienia do plików i folderów (Desktop/Documents/Downloads)
macOS może także blokować Desktop, Documents i Downloads dla procesów terminalowych/tła. Jeśli odczyty plików albo listowania katalogów zawieszają się, przyznaj dostęp temu samemu kontekstowi procesu, który wykonuje operacje na plikach (na przykład Terminal/iTerm, aplikacja uruchamiana przez LaunchAgent albo proces SSH).
Obejście: przenieś pliki do obszaru roboczego OpenClaw (~/.openclaw/workspace), jeśli chcesz uniknąć przyznań per folder.
Jeśli testujesz uprawnienia, zawsze podpisuj prawdziwym certyfikatem. Buildy ad-hoc są akceptowalne tylko do szybkich lokalnych uruchomień, gdzie uprawnienia nie mają znaczenia.