macOS companion app

Signature macOS

Signature mac (versions de débogage)

scripts/package-mac-app.sh compile et empaquette l’application dans un chemin fixe (dist/OpenClaw.app), puis appelle scripts/codesign-mac-app.sh pour la signer. Les autorisations TCC sont liées à l’identifiant du paquet et à la signature du code ; conserver ces deux éléments stables (ainsi que l’application dans un chemin fixe) d’une recompilation à l’autre empêche macOS d’oublier les autorisations TCC accordées (notifications, accessibilité, enregistrement de l’écran, microphone, reconnaissance vocale).

L’identifiant du paquet de débogage est par défaut ai.openclaw.mac.debug (remplacez-le avec BUNDLE_ID=...).
Node : >=22.19.0 <23 ou >=23.11.0 (engines dans le fichier package.json du dépôt). L’outil d’empaquetage compile également l’interface de contrôle (pnpm ui:build).
Nécessite par défaut une véritable identité de signature ; le script de signature se termine avec une erreur si aucune n’est trouvée et si ALLOW_ADHOC_SIGNING n’est pas défini. La signature ad hoc (SIGN_IDENTITY="-") doit être explicitement activée et ne conserve pas les autorisations TCC d’une recompilation à l’autre. Consultez les autorisations macOS.
Lit SIGN_IDENTITY depuis l’environnement (par exemple export SIGN_IDENTITY="Apple Development: Your Name (TEAMID)", ou un certificat Developer ID Application). Si cette variable n’est pas définie, codesign-mac-app.sh sélectionne automatiquement une identité dans l’ordre suivant : Developer ID Application, Apple Distribution, Apple Development, puis la première identité de signature de code valide trouvée.
CODESIGN_TIMESTAMP=auto (valeur par défaut) active les horodatages fiables uniquement pour les signatures Developer ID Application. Définissez on/off pour imposer l’un ou l’autre comportement.
Ajoute à Info.plist les valeurs OpenClawBuildTimestamp (UTC au format ISO 8601) et OpenClawGitCommit (hachage court, unknown s’il est indisponible), afin que l’onglet À propos puisse afficher la version, Git et le canal de débogage ou de publication.
Exécute un audit de l’identifiant d’équipe après la signature et échoue si un fichier Mach-O du paquet possède un identifiant d’équipe différent. Définissez SKIP_TEAM_ID_CHECK=1 pour ignorer cette vérification.

Utilisation

bash

# depuis la racine du dépôtscripts/package-mac-app.sh                                                      # sélectionne automatiquement l’identité ; erreur si aucune n’est trouvéeSIGN_IDENTITY="Developer ID Application: Your Name" scripts/package-mac-app.sh   # véritable certificatALLOW_ADHOC_SIGNING=1 scripts/package-mac-app.sh                                 # ad hoc (les autorisations ne seront pas conservées)SIGN_IDENTITY="-" scripts/package-mac-app.sh                                     # ad hoc explicite (même réserve)DISABLE_LIBRARY_VALIDATION=1 scripts/package-mac-app.sh                          # contournement réservé au développement pour une incompatibilité d’identifiant d’équipe Sparkle

Remarque sur la signature ad hoc

SIGN_IDENTITY="-" désactive l’environnement d’exécution renforcé (--options runtime) afin d’éviter les plantages lorsque l’application charge des frameworks intégrés (comme Sparkle) qui ne partagent pas le même identifiant d’équipe. Les signatures ad hoc empêchent également la conservation des autorisations TCC ; consultez les autorisations macOS pour connaître les étapes de récupération.

Métadonnées de compilation pour À propos

L’onglet À propos lit OpenClawBuildTimestamp et OpenClawGitCommit dans Info.plist afin d’afficher la version, la date de compilation, le commit Git et d’indiquer si la compilation est en mode DEBUG (via #if DEBUG). Réexécutez l’outil d’empaquetage après toute modification du code afin d’actualiser ces valeurs.

Pages connexes

Was this useful?