Anforderungen für stabile Berechtigungen
- Gleicher Pfad: Führen Sie die App von einem festen Speicherort aus (für OpenClaw
dist/OpenClaw.app). - Gleiche Bundle-ID: Das Ändern der Bundle-ID erzeugt eine neue Berechtigungsidentität.
- Signierte App: Unsigned- oder Ad-hoc-signierte Builds behalten Berechtigungen nicht dauerhaft bei.
- Konsistente Signatur: Verwenden Sie ein echtes Apple-Development- oder Developer-ID-Zertifikat, damit die Signatur über Rebuilds hinweg stabil bleibt.
Bedienungshilfen-Berechtigungen für Node- und CLI-Laufzeiten
Gewähren Sie Bedienungshilfen-Zugriff vorzugsweise OpenClaw.app, Peekaboo.app oder einem anderen signierten Helper mit eigener Bundle-ID statt einem generischennode-Binary.
macOS TCC gewährt Bedienungshilfen-Zugriff für die Code-Identität des Prozesses, den es sieht. Wenn ein
Homebrew-, nvm-, pnpm- oder npm-Workflow dazu führt, dass ein gemeinsam genutztes node-Executable
Bedienungshilfen-Zugriff erhält, kann jedes JavaScript-Paket, das über dasselbe
Executable gestartet wird, GUI-Automatisierungsrechte erben.
Behandeln Sie einen node-Eintrag in den Systemeinstellungen als weitreichende Berechtigung für diese Node-
Laufzeit, nicht als Berechtigung für ein einzelnes npm-Paket. Vermeiden Sie es, node Bedienungshilfen-Zugriff zu gewähren,
es sei denn, Sie vertrauen jedem Skript und Paket, das über genau diese
Node-Installation gestartet wird.
Wenn Sie node versehentlich Bedienungshilfen-Zugriff gewährt haben, entfernen Sie diesen Eintrag aus
Systemeinstellungen -> Datenschutz & Sicherheit -> Bedienungshilfen. Gewähren Sie die Berechtigung anschließend der signierten
App oder dem Helper, der die UI-Automatisierung besitzen soll.
Wiederherstellungs-Checkliste, wenn Eingabeaufforderungen verschwinden
- Beenden Sie die App.
- Entfernen Sie den App-Eintrag in Systemeinstellungen -> Datenschutz & Sicherheit.
- Starten Sie die App erneut vom selben Pfad und gewähren Sie die Berechtigungen erneut.
- Wenn die Eingabeaufforderung weiterhin nicht erscheint, setzen Sie TCC-Einträge mit
tccutilzurück und versuchen Sie es erneut. - Einige Berechtigungen erscheinen erst nach einem vollständigen macOS-Neustart wieder.
Berechtigungen für Dateien und Ordner (Schreibtisch/Dokumente/Downloads)
macOS kann auch Schreibtisch, Dokumente und Downloads für Terminal-/Hintergrundprozesse sperren. Wenn Dateilesevorgänge oder Verzeichnisauflistungen hängen bleiben, gewähren Sie Zugriff für denselben Prozesskontext, der Dateioperationen ausführt (zum Beispiel Terminal/iTerm, eine über LaunchAgent gestartete App oder ein SSH-Prozess). Workaround: Verschieben Sie Dateien in den OpenClaw-Arbeitsbereich (~/.openclaw/workspace), wenn Sie ordnerspezifische Berechtigungen vermeiden möchten.
Wenn Sie Berechtigungen testen, signieren Sie immer mit einem echten Zertifikat. Ad-hoc-
Builds sind nur für schnelle lokale Läufe akzeptabel, bei denen Berechtigungen keine Rolle spielen.