Firma en Mac (compilaciones de depuración)

scripts/package-mac-app.sh compila y empaqueta la aplicación en una ruta fija (dist/OpenClaw.app) y, a continuación, llama a scripts/codesign-mac-app.sh para firmarla. Los permisos de TCC están vinculados al ID del paquete y a la firma de código; mantener ambos estables (y la aplicación en una ruta fija) entre recompilaciones evita que macOS olvide las concesiones de TCC (notificaciones, accesibilidad, grabación de pantalla, micrófono y voz).

• El identificador del paquete de depuración es de forma predeterminada ai.openclaw.mac.debug (se puede sobrescribir con BUNDLE_ID=...).
• Node: >=22.22.3 <23, >=24.15.0 <25 o >=25.9.0 (package.json engines del repositorio). El empaquetador también compila la interfaz de control (pnpm ui:build).
• De forma predeterminada, requiere una identidad de firma real; el script de firma de código termina con un error si no encuentra ninguna y ALLOW_ADHOC_SIGNING no está establecido. La firma ad hoc (SIGN_IDENTITY="-") requiere la aceptación explícita y no conserva los permisos de TCC entre recompilaciones. Consulte Permisos de macOS.
• Lee SIGN_IDENTITY del entorno (por ejemplo, export SIGN_IDENTITY="Apple Development: Your Name (TEAMID)" o un certificado Developer ID Application). Sin esta variable, codesign-mac-app.sh selecciona automáticamente una identidad en este orden: Developer ID Application, Apple Distribution, Apple Development y, después, la primera identidad de firma de código válida que encuentre.
• CODESIGN_TIMESTAMP=auto (valor predeterminado) habilita marcas de tiempo de confianza únicamente para las firmas Developer ID Application. Establezca on/off para forzar una de las dos opciones.
• Añade a Info.plist OpenClawBuildTimestamp (ISO8601 UTC) y OpenClawGitCommit (hash corto, unknown si no está disponible) para que la pestaña Acerca de pueda mostrar la compilación, la información de Git y el canal de depuración o publicación.
• Ejecuta una auditoría del ID de equipo después de firmar y falla si algún archivo Mach-O dentro del paquete tiene un ID de equipo diferente. Establezca SKIP_TEAM_ID_CHECK=1 para omitirla.

Uso

# desde la raíz del repositorioscripts/package-mac-app.sh                                                      # selecciona automáticamente una identidad; genera un error si no encuentra ningunaSIGN_IDENTITY="Developer ID Application: Your Name" scripts/package-mac-app.sh   # certificado realALLOW_ADHOC_SIGNING=1 scripts/package-mac-app.sh                                 # ad hoc (los permisos no se conservarán)SIGN_IDENTITY="-" scripts/package-mac-app.sh                                     # ad hoc explícita (con la misma salvedad)DISABLE_LIBRARY_VALIDATION=1 scripts/package-mac-app.sh                          # solución alternativa solo para desarrollo ante la discrepancia del ID de equipo de Sparkle

Nota sobre la firma ad hoc

SIGN_IDENTITY="-" deshabilita Hardened Runtime (--options runtime) para evitar fallos cuando la aplicación carga frameworks integrados (como Sparkle) que no comparten el mismo ID de equipo. Las firmas ad hoc también impiden conservar los permisos de TCC; consulte Permisos de macOS para conocer los pasos de recuperación.

Metadatos de compilación para Acerca de

La pestaña Acerca de lee OpenClawBuildTimestamp y OpenClawGitCommit de Info.plist para mostrar la versión, la fecha de compilación, el commit de Git y si la compilación es DEBUG (mediante #if DEBUG). Vuelva a ejecutar el empaquetador después de realizar cambios en el código para actualizar estos valores.

Contenido relacionado

• Aplicación para macOS
• Permisos de macOS