Mac-Signierung (Debug-Builds)

scripts/package-mac-app.sh erstellt und paketiert die App unter einem festen Pfad (dist/OpenClaw.app) und ruft anschließend scripts/codesign-mac-app.sh auf, um sie zu signieren. TCC-Berechtigungen sind an die Bundle-ID und die Codesignatur gebunden. Wenn beide (und der feste Pfad der App) bei erneuten Builds unverändert bleiben, vergisst macOS die erteilten TCC-Berechtigungen nicht (Mitteilungen, Bedienungshilfen, Bildschirmaufnahme, Mikrofon, Spracherkennung).

• Die Debug-Bundle-ID lautet standardmäßig ai.openclaw.mac.debug (Überschreibung mit BUNDLE_ID=...).
• Node: >=22.19.0 <23 oder >=23.11.0 (engines in der package.json des Repositorys). Das Paketierungsskript erstellt außerdem die Control UI (pnpm ui:build).
• Standardmäßig ist eine echte Signierungsidentität erforderlich. Das Codesign-Skript wird mit einem Fehler beendet, wenn keine gefunden wurde und ALLOW_ADHOC_SIGNING nicht gesetzt ist. Die Ad-hoc-Signierung (SIGN_IDENTITY="-") muss ausdrücklich aktiviert werden und bewahrt TCC-Berechtigungen nicht über erneute Builds hinweg. Siehe macOS-Berechtigungen.
• Liest SIGN_IDENTITY aus der Umgebung (z. B. export SIGN_IDENTITY="Apple Development: Your Name (TEAMID)" oder ein Developer ID Application-Zertifikat). Wenn die Variable nicht gesetzt ist, wählt codesign-mac-app.sh automatisch eine Identität in dieser Reihenfolge aus: Developer ID Application, Apple Distribution, Apple Development und anschließend die erste gefundene gültige Codesignaturidentität.
• CODESIGN_TIMESTAMP=auto (Standard) aktiviert vertrauenswürdige Zeitstempel nur für Developer ID Application-Signaturen. Legen Sie on/off fest, um die jeweilige Einstellung zu erzwingen.
• Ergänzt Info.plist um OpenClawBuildTimestamp (ISO8601 UTC) und OpenClawGitCommit (Kurz-Hash, unknown, falls nicht verfügbar), damit die Registerkarte „Über“ Build, Git und den Debug-/Release-Kanal anzeigen kann.
• Führt nach der Signierung eine Team-ID-Prüfung durch und schlägt fehl, wenn eine Mach-O-Datei innerhalb des Bundles eine andere Team-ID aufweist. Legen Sie SKIP_TEAM_ID_CHECK=1 fest, um die Prüfung zu überspringen.

Verwendung

# aus dem Stammverzeichnis des Repositorysscripts/package-mac-app.sh                                                      # wählt die Identität automatisch aus; Fehler, wenn keine gefunden wirdSIGN_IDENTITY="Developer ID Application: Your Name" scripts/package-mac-app.sh   # echtes ZertifikatALLOW_ADHOC_SIGNING=1 scripts/package-mac-app.sh                                 # Ad-hoc (Berechtigungen bleiben nicht erhalten)SIGN_IDENTITY="-" scripts/package-mac-app.sh                                     # ausdrücklich Ad-hoc (gleicher Vorbehalt)DISABLE_LIBRARY_VALIDATION=1 scripts/package-mac-app.sh                          # nur für die Entwicklung: Behelfslösung für abweichende Sparkle-Team-ID

Hinweis zur Ad-hoc-Signierung

SIGN_IDENTITY="-" deaktiviert die Hardened Runtime (--options runtime), um Abstürze zu verhindern, wenn die App eingebettete Frameworks (wie Sparkle) lädt, die nicht dieselbe Team-ID verwenden. Ad-hoc-Signaturen verhindern außerdem die dauerhafte Speicherung von TCC-Berechtigungen. Wiederherstellungsschritte finden Sie unter macOS-Berechtigungen.

Build-Metadaten für „Über“

Die Registerkarte „Über“ liest OpenClawBuildTimestamp und OpenClawGitCommit aus Info.plist, um Version, Build-Datum, Git-Commit und anzuzeigen, ob es sich um einen DEBUG-Build handelt (über #if DEBUG). Führen Sie das Paketierungsskript nach Codeänderungen erneut aus, um diese Werte zu aktualisieren.

Verwandte Themen

• macOS-App
• macOS-Berechtigungen