---
read_when:
    - Debug di prompt dei permessi macOS mancanti o bloccati
    - Packaging o firma dell'app macOS
    - Modifica degli ID bundle o dei percorsi di installazione dell'app
summary: Persistenza dei permessi macOS (TCC) e requisiti di firma
title: Permessi macOS
x-i18n:
    generated_at: "2026-04-24T08:50:29Z"
    model: gpt-5.4
    provider: openai
    source_hash: c9ee8ee6409577094a0ba1bc4a50c73560741c12cbb1b3c811cb684ac150e05e
    source_path: platforms/mac/permissions.md
    workflow: 15
---

Le concessioni dei permessi macOS sono fragili. TCC associa una concessione di permesso alla
firma del codice dell'app, all'identificatore del bundle e al percorso su disco. Se uno di questi cambia,
macOS tratta l'app come nuova e può eliminare o nascondere i prompt.

## Requisiti per permessi stabili

- Stesso percorso: esegui l'app da una posizione fissa (per OpenClaw, `dist/OpenClaw.app`).
- Stesso identificatore del bundle: cambiare il bundle ID crea una nuova identità di permesso.
- App firmata: le build non firmate o firmate ad hoc non mantengono i permessi.
- Firma coerente: usa un vero certificato Apple Development o Developer ID
  in modo che la firma resti stabile tra una build e l'altra.

Le firme ad hoc generano una nuova identità a ogni build. macOS dimenticherà le concessioni precedenti,
e i prompt possono scomparire del tutto finché le voci obsolete non vengono eliminate.

## Checklist di recupero quando i prompt scompaiono

1. Chiudi l'app.
2. Rimuovi la voce dell'app in Impostazioni di Sistema -> Privacy e Sicurezza.
3. Riavvia l'app dallo stesso percorso e concedi di nuovo i permessi.
4. Se il prompt continua a non apparire, reimposta le voci TCC con `tccutil` e riprova.
5. Alcuni permessi riappaiono solo dopo un riavvio completo di macOS.

Esempi di reset (sostituisci il bundle ID secondo necessità):

```bash
sudo tccutil reset Accessibility ai.openclaw.mac
sudo tccutil reset ScreenCapture ai.openclaw.mac
sudo tccutil reset AppleEvents
```

## Permessi per file e cartelle (Desktop/Documents/Downloads)

macOS può anche limitare Desktop, Documents e Downloads per processi terminal/background. Se le letture dei file o gli elenchi delle directory restano bloccati, concedi l'accesso allo stesso contesto di processo che esegue le operazioni sui file (ad esempio Terminal/iTerm, app avviata da LaunchAgent o processo SSH).

Soluzione alternativa: sposta i file nel workspace OpenClaw (`~/.openclaw/workspace`) se vuoi evitare concessioni per singola cartella.

Se stai testando i permessi, firma sempre con un certificato reale. Le build ad hoc
sono accettabili solo per esecuzioni locali rapide in cui i permessi non contano.

## Correlati

- [App macOS](/it/platforms/macos)
- [Firma macOS](/it/platforms/mac/signing)