Cómo gestionar permisos de macOS (TCC) sin perder la cabeza

¿Te ha pasado que después de recompilar tu app macOS deja de pedirte permisos? Es frustrante cuando los diálogos de acceso simplemente desaparecen y tu código deja de funcionar sin explicación. Los permisos en macOS son frágiles porque el sistema TCC los asocia a la firma, el bundle identifier y la ruta en el disco. Si cambias cualquiera de estos elementos, el sistema operativo tratará tu app como si fuera nueva y los prompts podrían no aparecer más.

Requisitos previos

Para que los permisos se mantengan estables, necesitas cumplir con estos requisitos:

• Una ruta de ejecución fija (ejemplo: dist/OpenClaw.app).
• Un bundle identifier que no cambie.
• Un certificado real de Apple Development o Developer ID.
• Una firma de código consistente entre cada build.

Inicio rápido

Sigue estos pasos para asegurar que macOS reconozca tu app correctamente:

1. Configura tu entorno para ejecutar la app siempre desde la misma ubicación.
2. Mantén el bundle identifier idéntico en todas tus versiones.
3. Firma la app con un certificado oficial en lugar de usar firmas ad-hoc.
4. Ejecuta la app para activar y aceptar los prompts iniciales de seguridad.

Solución de problemas

Si los prompts de permisos dejan de aparecer, sigue esta lista de recuperación:

1. Cierra la app por completo.
2. Ve a System Settings -> Privacy & Security y elimina la entrada de tu app.
3. Reinicia la app desde la misma ruta y vuelve a conceder los permisos.
4. Si el prompt sigue sin aparecer, resetea las entradas de TCC manualmente.

A veces, algunos permisos solo vuelven a funcionar después de reiniciar macOS por completo. Si necesitas resetear servicios específicos, usa estos comandos en tu terminal (cambia el bundle ID según tu caso):

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

Problemas con archivos y carpetas

macOS puede bloquear el acceso a Desktop, Documents y Downloads para procesos que corren en segundo plano o desde la terminal. Si tu app se queda colgada al leer archivos, asegúrate de dar permisos al proceso que ejecuta la operación (como Terminal, iTerm o un LaunchAgent).

Como alternativa, puedes mover tus archivos a ~/.openclaw/workspace para evitar tener que pedir permisos por cada carpeta individual. Si estás haciendo pruebas, usa siempre una firma real; las firmas ad-hoc generan una identidad nueva en cada build y harán que macOS olvide tus permisos constantemente.

¿Necesitas ayuda con una configuración específica? Prueba nuestro AI Setup Assistant.

Próximos pasos

• Guía de firma de código en macOS
• Configuración de LaunchAgents