macOS डेवलपर सेटअप

स्रोत से OpenClaw macOS एप्लिकेशन बनाएं और चलाएं।

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

ऐप बनाने से पहले, सुनिश्चित करें कि आपके पास निम्नलिखित इंस्टॉल हैं:

1. Xcode 26.2+: Swift विकास के लिए आवश्यक।
2. Node.js 24 और pnpm: Gateway, CLI, और पैकेजिंग स्क्रिप्ट के लिए अनुशंसित। Node 22 LTS, वर्तमान में 22.19+, संगतता के लिए समर्थित रहता है।

1. निर्भरताएँ इंस्टॉल करें

पूरे प्रोजेक्ट की निर्भरताएँ इंस्टॉल करें:

pnpm install

2. ऐप बनाएं और पैकेज करें

macOS ऐप बनाने और उसे dist/OpenClaw.app में पैकेज करने के लिए, चलाएँ:

./scripts/package-mac-app.sh

यदि आपके पास Apple Developer ID प्रमाणपत्र नहीं है, तो स्क्रिप्ट स्वचालित रूप से ad-hoc signing (-) का उपयोग करेगी।

डेव रन मोड, signing flags, और Team ID समस्या निवारण के लिए, macOS ऐप README देखें: https://github.com/openclaw/openclaw/blob/main/apps/macos/README.md

नोट: Ad-hoc signed ऐप्स सुरक्षा संकेत ट्रिगर कर सकते हैं। यदि ऐप "Abort trap 6" के साथ तुरंत क्रैश हो जाता है, तो समस्या निवारण अनुभाग देखें।

3. CLI और Gateway इंस्टॉल करें

पैकेज किया गया ऐप canonical scripts/install-cli.sh इंस्टॉलर एम्बेड करता है। किसी नए प्रोफाइल पर, onboarding के दौरान This Mac चुनें; ऐप Gateway विज़ार्ड शुरू करने से पहले मिलती-जुलती user-space CLI और runtime इंस्टॉल करता है।

मैनुअल डेवलपमेंट रिकवरी के लिए, मिलती-जुलती CLI स्वयं इंस्टॉल करें:

npm install -g openclaw@<version>

pnpm add -g openclaw@<version> और bun add -g openclaw@<version> भी काम करते हैं। Gateway runtime के लिए, Node अनुशंसित पथ बना रहता है।

समस्या निवारण

बिल्ड विफल होता है: toolchain या SDK mismatch

macOS ऐप बिल्ड नवीनतम macOS SDK और Swift 6.2 toolchain की अपेक्षा करता है।

सिस्टम निर्भरताएँ (आवश्यक):

• Software Update में उपलब्ध नवीनतम macOS संस्करण (Xcode 26.2 SDKs द्वारा आवश्यक)
• Xcode 26.2 (Swift 6.2 toolchain)

जाँचें:

xcodebuild -versionxcrun swift --version

यदि संस्करण मेल नहीं खाते, तो macOS/Xcode अपडेट करें और बिल्ड फिर से चलाएँ।

अनुमति देने पर ऐप क्रैश होता है

यदि Speech Recognition या Microphone एक्सेस की अनुमति देने का प्रयास करते समय ऐप क्रैश हो जाता है, तो यह दूषित TCC cache या signature mismatch के कारण हो सकता है।

सुधार:

1. TCC अनुमतियाँ रीसेट करें:

   tccutil reset All ai.openclaw.mac.debug

2. यदि यह विफल हो, तो macOS से "clean slate" बाध्य करने के लिए scripts/package-mac-app.sh में BUNDLE_ID को अस्थायी रूप से बदलें।

Gateway "Starting..." पर अनिश्चित काल तक

यदि gateway स्थिति "Starting..." पर बनी रहती है, तो जाँचें कि कोई zombie process पोर्ट को होल्ड तो नहीं कर रहा है:

openclaw gateway statusopenclaw gateway stop # If you're not using a LaunchAgent (dev mode / manual runs), find the listener:lsof -nP -iTCP:18789 -sTCP:LISTEN

यदि कोई manual run पोर्ट को होल्ड कर रहा है, तो उस process को रोकें (Ctrl+C)। अंतिम उपाय के रूप में, ऊपर मिली PID को kill करें।

संबंधित

• macOS ऐप
• इंस्टॉल अवलोकन