​

OpenClaw macOS-release (Sparkle)

​

Prereqs

• Developer ID Application-certificaat geïnstalleerd (voorbeeld: Developer ID Application: <Developer Name> (<TEAMID>)).
• Sparkle-privésleutelpad ingesteld in de omgeving als SPARKLE_PRIVATE_KEY_FILE (pad naar je Sparkle ed25519-privésleutel; publieke sleutel ingebakken in Info.plist). Als dit ontbreekt, controleer ~/.profile.
• Notary-referenties (sleutelhangprofiel of API-sleutel) voor xcrun notarytool als je Gatekeeper-veilige DMG/zip-distributie wilt.
  • We gebruiken een Sleutelhang-profiel met de naam openclaw-notary, aangemaakt op basis van App Store Connect API-sleutel-omgevingsvariabelen in je shellprofiel:
    • APP_STORE_CONNECT_API_KEY_P8, APP_STORE_CONNECT_KEY_ID, APP_STORE_CONNECT_ISSUER_ID
    • echo "$APP_STORE_CONNECT_API_KEY_P8" | sed 's/\\n/\n/g' > /tmp/openclaw-notary.p8
    • xcrun notarytool store-credentials "openclaw-notary" --key /tmp/openclaw-notary.p8 --key-id "$APP_STORE_CONNECT_KEY_ID" --issuer "$APP_STORE_CONNECT_ISSUER_ID"
• pnpm-deps geïnstalleerd (pnpm install --config.node-linker=hoisted).
• Sparkle-tools worden automatisch opgehaald via SwiftPM op apps/macos/.build/artifacts/sparkle/Sparkle/bin/ (sign_update, generate_appcast, enz.).

​

Build & packaging

• APP_BUILD komt overeen met CFBundleVersion/sparkle:version; houd dit numeriek en monotoon (geen -beta), anders vergelijkt Sparkle het als gelijk.
• Standaard wordt de huidige architectuur gebruikt ($(uname -m)). Voor release-/universal-builds stel je BUILD_ARCHS="arm64 x86_64" in (of BUILD_ARCHS=all).
• Gebruik scripts/package-mac-dist.sh voor release-artefacten (zip + DMG + notarization). Gebruik scripts/package-mac-app.sh voor lokale/dev-packaging.

# From repo root; set release IDs so Sparkle feed is enabled.
# APP_BUILD must be numeric + monotonic for Sparkle compare.
BUNDLE_ID=bot.molt.mac \
APP_VERSION=2026.2.9 \
APP_BUILD="$(git rev-list --count HEAD)" \
BUILD_CONFIG=release \
SIGN_IDENTITY="Developer ID Application: <Developer Name> (<TEAMID>)" \
scripts/package-mac-app.sh

# Zip for distribution (includes resource forks for Sparkle delta support)
ditto -c -k --sequesterRsrc --keepParent dist/OpenClaw.app dist/OpenClaw-2026.2.9.zip

# Optional: also build a styled DMG for humans (drag to /Applications)
scripts/create-dmg.sh dist/OpenClaw.app dist/OpenClaw-2026.2.9.dmg

# Recommended: build + notarize/staple zip + DMG
# First, create a keychain profile once:
#   xcrun notarytool store-credentials "openclaw-notary" \
#     --apple-id "<apple-id>" --team-id "<team-id>" --password "<app-specific-password>"
NOTARIZE=1 NOTARYTOOL_PROFILE=openclaw-notary \
BUNDLE_ID=bot.molt.mac \
APP_VERSION=2026.2.9 \
APP_BUILD="$(git rev-list --count HEAD)" \
BUILD_CONFIG=release \
SIGN_IDENTITY="Developer ID Application: <Developer Name> (<TEAMID>)" \
scripts/package-mac-dist.sh

# Optional: ship dSYM alongside the release
ditto -c -k --keepParent apps/macos/.build/release/OpenClaw.app.dSYM dist/OpenClaw-2026.2.9.dSYM.zip

​

Appcast-vermelding

SPARKLE_PRIVATE_KEY_FILE=/path/to/ed25519-private-key scripts/make_appcast.sh dist/OpenClaw-2026.2.9.zip https://raw.githubusercontent.com/openclaw/openclaw/main/appcast.xml

​

Publiceren & verifiëren

• Upload OpenClaw-2026.2.9.zip (en OpenClaw-2026.2.9.dSYM.zip) naar de GitHub-release voor tag v2026.2.9.
• Zorg dat de ruwe appcast-URL overeenkomt met de ingebakken feed: https://raw.githubusercontent.com/openclaw/openclaw/main/appcast.xml.
• Sanitychecks:
  • curl -I https://raw.githubusercontent.com/openclaw/openclaw/main/appcast.xml retourneert 200.
  • curl -I <enclosure url> retourneert 200 na het uploaden van de assets.
  • Voer op een eerdere publieke build “Check for Updates…” uit via het tabblad About en verifieer dat Sparkle de nieuwe build probleemloos installeert.