macOS companion app
Permisos de macOS
Las concesiones de permisos de macOS son frágiles. TCC asocia una concesión de permiso con la firma de código de la aplicación, el identificador del paquete y la ruta en disco. Si cualquiera de estos elementos cambia, macOS considera que la aplicación es nueva y puede descartar u ocultar las solicitudes de permiso.
Requisitos para permisos estables
- Misma ruta: ejecuta la aplicación desde una ubicación fija (para OpenClaw,
dist/OpenClaw.app). - Mismo identificador del paquete: el ID de paquete de OpenClaw es
ai.openclaw.mac; cambiarlo crea una nueva identidad de permisos. - Aplicación firmada: las compilaciones sin firmar o con firma ad hoc no conservan los permisos.
- Firma coherente: usa 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 olvida las concesiones anteriores y las solicitudes de permiso pueden desaparecer por completo hasta que se eliminen las entradas obsoletas.
Concesiones de accesibilidad para entornos de ejecución de Node y la CLI
Es preferible conceder accesibilidad a OpenClaw.app, Peekaboo.app u otro componente auxiliar firmado con su propio identificador del paquete, en lugar de a un binario genérico de node.
TCC de macOS concede accesibilidad a la identidad de código del proceso que detecta. Si un flujo de trabajo de Homebrew, nvm, pnpm o npm hace que un ejecutable compartido de node reciba acceso de accesibilidad, cualquier paquete de JavaScript iniciado mediante ese mismo ejecutable puede heredar privilegios de automatización de la interfaz gráfica.
Considera una entrada de node en System Settings como un permiso amplio para ese entorno de ejecución de Node, no como un permiso para un único paquete de npm. Evita conceder accesibilidad a node, a menos que confíes en todos los scripts y paquetes iniciados mediante esa instalación específica de Node.
Si concediste accesibilidad accidentalmente a node, elimina esa entrada en System Settings -> Privacy & Security -> Accessibility. Después, concede el permiso a la aplicación firmada o al componente auxiliar que deba encargarse de la automatización de la interfaz de usuario.
Lista de comprobación para recuperar las solicitudes de permiso desaparecidas
- Cierra la aplicación.
- Elimina la entrada de la aplicación en System Settings -> Privacy & Security.
- Vuelve a iniciar la aplicación desde la misma ruta y concede de nuevo los permisos.
- Si la solicitud sigue sin aparecer, restablece las entradas de TCC con
tccutile inténtalo de nuevo. - Algunos permisos solo vuelven a aparecer después de reiniciar macOS por completo.
Ejemplos de restablecimiento (con el ID de paquete de OpenClaw, ai.openclaw.mac):
sudo tccutil reset Accessibility ai.openclaw.macsudo tccutil reset ScreenCapture ai.openclaw.macsudo tccutil reset AppleEventsPermisos de archivos y carpetas (Desktop/Documents/Downloads)
macOS también puede restringir Desktop, Documents y Downloads para los procesos de terminal o en segundo plano. Si las lecturas de archivos o los listados de directorios se bloquean, concede acceso al mismo contexto de proceso que realiza las operaciones de archivos (por ejemplo, Terminal/iTerm, una aplicación iniciada por LaunchAgent o un proceso SSH).
Solución alternativa: mueve los archivos al espacio de trabajo de OpenClaw (~/.openclaw/workspace) si quieres evitar las concesiones específicas para cada carpeta.
Si estás probando permisos, firma siempre con un certificado real. Las compilaciones ad hoc solo son aceptables para ejecuciones locales rápidas en las que los permisos no sean importantes.
