> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# macOS रिलीज़

# OpenClaw macOS रिलीज़ (Sparkle)

43. यह ऐप अब Sparkle ऑटो‑अपडेट्स के साथ शिप होता है। 44. रिलीज़ बिल्ड्स को Developer ID से साइन किया जाना चाहिए, ज़िप किया जाना चाहिए, और साइन की हुई appcast एंट्री के साथ प्रकाशित किया जाना चाहिए।

## पूर्वापेक्षाएँ

* Developer ID Application प्रमाणपत्र इंस्टॉल हो (उदाहरण: `Developer ID Application: <Developer Name> (<TEAMID>)`)।
* 45. Sparkle प्राइवेट की पाथ को एनवायरनमेंट में `SPARKLE_PRIVATE_KEY_FILE` के रूप में सेट करें (आपकी Sparkle ed25519 प्राइवेट की का पाथ; पब्लिक की Info.plist में बेक की गई है)। 46. यदि यह गायब है, तो `~/.profile` जांचें।
* यदि आप Gatekeeper-सुरक्षित DMG/zip वितरण चाहते हैं, तो `xcrun notarytool` के लिए Notary क्रेडेंशियल्स (कीचेन प्रोफ़ाइल या API कुंजी)।
  * हम `openclaw-notary` नाम की Keychain प्रोफ़ाइल का उपयोग करते हैं, जो आपके शेल प्रोफ़ाइल में App Store Connect API कुंजी पर्यावरण चरों से बनाई गई है:
    * `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` निर्भरताएँ इंस्टॉल हों (`pnpm install --config.node-linker=hoisted`)।
* Sparkle टूल्स SwiftPM के माध्यम से `apps/macos/.build/artifacts/sparkle/Sparkle/bin/` पर स्वचालित रूप से फ़ेच होते हैं (`sign_update`, `generate_appcast`, आदि)।

## बिल्ड और पैकेज

टिप्पणियाँ:

* `APP_BUILD` का मैपिंग `CFBundleVersion`/`sparkle:version` से होता है; इसे संख्यात्मक और मोनोटोनिक रखें (`-beta` नहीं), अन्यथा Sparkle इसे समान के रूप में तुलना करता है।
* 47. डिफ़ॉल्ट रूप से वर्तमान आर्किटेक्चर (`$(uname -m)`) लिया जाता है। 48. रिलीज़/यूनिवर्सल बिल्ड्स के लिए `BUILD_ARCHS="arm64 x86_64"` (या `BUILD_ARCHS=all`) सेट करें।
* 49. रिलीज़ आर्टिफ़ैक्ट्स (zip + DMG + notarization) के लिए `scripts/package-mac-dist.sh` का उपयोग करें। 50. लोकल/डेव पैकेजिंग के लिए `scripts/package-mac-app.sh` का उपयोग करें।

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# 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
```

## ऐपकास्ट एंट्री

Sparkle द्वारा फ़ॉर्मैटेड HTML नोट्स रेंडर करने के लिए रिलीज़ नोट जेनरेटर का उपयोग करें:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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
```

Generates HTML release notes from `CHANGELOG.md` (via [`scripts/changelog-to-html.sh`](https://github.com/openclaw/openclaw/blob/main/scripts/changelog-to-html.sh)) and embeds them in the appcast entry.
Commit the updated `appcast.xml` alongside the release assets (zip + dSYM) when publishing.

## प्रकाशित करें और सत्यापित करें

* Upload `OpenClaw-2026.2.9.zip` (and `OpenClaw-2026.2.9.dSYM.zip`) to the GitHub release for tag `v2026.2.9`.
* सुनिश्चित करें कि रॉ ऐपकास्ट URL बेक्ड फ़ीड से मेल खाता है: `https://raw.githubusercontent.com/openclaw/openclaw/main/appcast.xml`।
* सैनीटी जाँच:
  * `curl -I https://raw.githubusercontent.com/openclaw/openclaw/main/appcast.xml` 200 लौटाता है।
  * एसेट्स अपलोड के बाद `curl -I <enclosure url>` 200 लौटाता है।
  * On a previous public build, run “Check for Updates…” from the About tab and verify Sparkle installs the new build cleanly.

पूर्णता की परिभाषा: साइन किया हुआ ऐप + ऐपकास्ट प्रकाशित हों, पुराने इंस्टॉल किए गए संस्करण से अपडेट फ़्लो काम करे, और रिलीज़ एसेट्स GitHub रिलीज़ से संलग्न हों।