Vereisten voor stabiele machtigingen
- Zelfde pad: voer de app uit vanaf een vaste locatie (voor OpenClaw,
dist/OpenClaw.app). - Zelfde bundle-ID: het wijzigen van de bundle-ID maakt een nieuwe machtigingsidentiteit aan.
- Ondertekende app: niet-ondertekende of ad-hoc ondertekende builds behouden geen machtigingen.
- Consistente handtekening: gebruik een echt Apple Development- of Developer ID-certificaat zodat de handtekening stabiel blijft tussen rebuilds.
Toegankelijkheidsmachtigingen voor Node- en CLI-runtimes
Geef Toegankelijkheid bij voorkeur aan OpenClaw.app, Peekaboo.app of een andere ondertekende helper met een eigen bundle-ID in plaats van aan een generiekenode-binary.
macOS TCC verleent Toegankelijkheid aan de code-identiteit van het proces dat het ziet. Als een
Homebrew-, nvm-, pnpm- of npm-workflow ervoor zorgt dat een gedeeld node-uitvoerbaar bestand
Toegankelijkheid ontvangt, kan elk JavaScript-pakket dat via datzelfde
uitvoerbare bestand wordt gestart GUI-automatiseringsrechten erven.
Beschouw een node-vermelding in Systeeminstellingen als brede toestemming voor die Node-runtime,
niet als toestemming voor één npm-pakket. Geef geen Toegankelijkheid aan
node, tenzij je elk script en pakket vertrouwt dat via precies die
Node-installatie wordt gestart.
Als je per ongeluk Toegankelijkheid aan node hebt gegeven, verwijder die vermelding dan uit
Systeeminstellingen -> Privacy en beveiliging -> Toegankelijkheid. Geef daarna machtiging aan de ondertekende
app of helper die UI-automatisering hoort te beheren.
Herstelchecklist wanneer prompts verdwijnen
- Sluit de app af.
- Verwijder de app-vermelding in Systeeminstellingen -> Privacy en beveiliging.
- Start de app opnieuw vanaf hetzelfde pad en verleen de machtigingen opnieuw.
- Als de prompt nog steeds niet verschijnt, reset dan TCC-vermeldingen met
tccutilen probeer het opnieuw. - Sommige machtigingen verschijnen pas opnieuw na een volledige herstart van macOS.
Machtigingen voor bestanden en mappen (Bureaublad/Documenten/Downloads)
macOS kan ook Bureaublad, Documenten en Downloads afschermen voor terminal- en achtergrondprocessen. Als het lezen van bestanden of het weergeven van mappen blijft hangen, geef dan toegang aan dezelfde procescontext die de bestandsbewerkingen uitvoert (bijvoorbeeld Terminal/iTerm, een door LaunchAgent gestarte app of een SSH-proces). Workaround: verplaats bestanden naar de OpenClaw-workspace (~/.openclaw/workspace) als je machtigingen per map wilt vermijden.
Als je machtigingen test, onderteken dan altijd met een echt certificaat. Ad-hoc
builds zijn alleen acceptabel voor snelle lokale runs waarbij machtigingen niet van belang zijn.