permisos de macOS (TCC)¶

Las concesiones de permisos de macOS son frágiles. TCC asocia una concesión de permisos con la firma de código de la app, el identificador del paquete y la ruta en disco. Si alguno de estos cambia, macOS trata la app como nueva y puede eliminar u ocultar los avisos.

Requisitos para permisos estables¶

• Misma ruta: ejecute la app desde una ubicación fija (para OpenClaw, dist/OpenClaw.app).
• Mismo identificador de paquete: cambiar el ID del paquete crea una nueva identidad de permisos.
• App firmada: las compilaciones sin firmar o firmadas ad-hoc no conservan los permisos.
• Firma consistente: use un certificado real de Apple Development o Developer ID para que la firma se mantenga estable entre recompilaciones.

Las firmas ad-hoc generan una identidad nueva en cada compilación. macOS olvidará concesiones anteriores, y los avisos pueden desaparecer por completo hasta que se borren las entradas obsoletas.

Lista de verificación de recuperación cuando los avisos desaparecen¶

1. Cierre la app.
2. Elimine la entrada de la app en Configuración del sistema -> Privacidad y seguridad.
3. Vuelva a iniciar la app desde la misma ruta y vuelva a conceder los permisos.
4. Si el aviso aún no aparece, restablezca las entradas de TCC con tccutil e inténtelo de nuevo.
5. Algunos permisos solo reaparecen después de un reinicio completo de macOS.

Ejemplos de restablecimiento (reemplace el ID del paquete según sea necesario):

sudo tccutil reset Accessibility bot.molt.mac
sudo tccutil reset ScreenCapture bot.molt.mac
sudo tccutil reset AppleEvents

Permisos de archivos y carpetas (Escritorio/Documentos/Descargas)¶

macOS también puede restringir Escritorio, Documentos y Descargas para procesos de terminal/en segundo plano. Si las lecturas de archivos o los listados de directorios se quedan colgados, conceda acceso al mismo contexto de proceso que realiza las operaciones de archivos (por ejemplo, Terminal/iTerm, una app iniciada por LaunchAgent o un proceso SSH).

Solución alternativa: mueva los archivos al espacio de trabajo de OpenClaw (~/.openclaw/workspace) si desea evitar concesiones por carpeta.

Si está probando permisos, firme siempre con un certificado real. Las compilaciones ad-hoc solo son aceptables para ejecuciones locales rápidas en las que los permisos no importan.