macOS पर Gateway

OpenClaw.app अब Node/Bun या Gateway रनटाइम को बंडल नहीं करता। macOS ऐप बाहरी openclaw CLI इंस्टॉल की अपेक्षा करता है, Gateway को चाइल्ड प्रक्रिया के रूप में शुरू नहीं करता, और Gateway को चालू रखने के लिए प्रति-उपयोगकर्ता launchd सेवा प्रबंधित करता है (या यदि कोई स्थानीय Gateway पहले से चल रहा है, तो उससे जुड़ जाता है)।

स्वचालित सेटअप

नए Mac पर, ऑनबोर्डिंग के दौरान यह Mac चुनें। ऐप Gateway विज़र्ड से पहले अपना हस्ताक्षरित, बंडल किया गया इंस्टॉलर चलाता है, ~/.openclaw के अंतर्गत यूज़र-स्पेस Node रनटाइम और मेल खाता openclaw CLI इंस्टॉल करता है, फिर प्रति-उपयोगकर्ता launchd सेवा इंस्टॉल और शुरू करता है। इस पथ के लिए Terminal, Homebrew, या प्रशासक एक्सेस की आवश्यकता नहीं होती।

ऐप इंस्टॉलर स्क्रिप्ट को बंडल करता है, Node या Gateway पेलोड को नहीं। इसलिए सेटअप को रनटाइम और मेल खाते OpenClaw पैकेज को डाउनलोड करने के लिए इंटरनेट कनेक्शन चाहिए।

मैनुअल रिकवरी

मैनुअल इंस्टॉल के लिए Node 24 अनुशंसित है। Node 22 LTS, वर्तमान में 22.19+, भी काम करता है। फिर openclaw को वैश्विक रूप से इंस्टॉल करें:

npm install -g openclaw@<version>

असफल स्वचालित सेटअप के बाद सेटअप फिर से आज़माएँ का उपयोग करें। यदि वह अभी भी विफल हो, तो ऊपर दिए गए कमांड से CLI को मैनुअल रूप से इंस्टॉल करें, फिर ऑनबोर्डिंग में फिर से जाँचें चुनें। Node अनुशंसित Gateway रनटाइम बना रहता है।

Launchd (LaunchAgent के रूप में Gateway)

लेबल:

• ai.openclaw.gateway (या ai.openclaw.<profile>; लेगेसी com.openclaw.* रह सकता है)

Plist स्थान (प्रति-उपयोगकर्ता):

• ~/Library/LaunchAgents/ai.openclaw.gateway.plist (या ~/Library/LaunchAgents/ai.openclaw.<profile>.plist)

मैनेजर:

• macOS ऐप Local मोड में LaunchAgent इंस्टॉल/अपडेट का स्वामी है।
• CLI भी इसे इंस्टॉल कर सकता है: openclaw gateway install।

व्यवहार:

• "OpenClaw Active" LaunchAgent को सक्षम/अक्षम करता है।
• ऐप छोड़ना gateway को बंद नहीं करता (launchd इसे चालू रखता है)।
• यदि कॉन्फ़िगर किए गए पोर्ट पर Gateway पहले से चल रहा है, तो ऐप नया शुरू करने के बजाय उससे जुड़ जाता है।

लॉगिंग:

• launchd stdout: ~/Library/Logs/openclaw/gateway.log (प्रोफ़ाइल gateway-<profile>.log का उपयोग करते हैं)
• launchd stderr: दबाया गया

संस्करण संगतता

macOS ऐप Gateway संस्करण की जाँच अपने संस्करण के विरुद्ध करता है। जब मौजूदा CLI अनुपस्थित या असंगत हो, तो ऑनबोर्डिंग स्वचालित रूप से प्रबंधित सेटअप चलाती है। इंस्टॉलेशन दोहराने के लिए सेटअप फिर से आज़माएँ या बाहरी CLI को सुधारने के बाद फिर से जाँचें का उपयोग करें।

macOS पर स्टेट डायरेक्टरी

OpenClaw स्टेट को स्थानीय, नॉन-सिंक्ड डिस्क पर रखें। iCloud Drive और अन्य क्लाउड-सिंक्ड फ़ोल्डरों से बचें, क्योंकि सिंक विलंबता और फ़ाइल लॉक सत्रों, क्रेडेंशियल्स, और Gateway स्टेट को प्रभावित कर सकते हैं।

OPENCLAW_STATE_DIR को स्थानीय पथ पर केवल तब सेट करें जब आपको ओवरराइड चाहिए। openclaw doctor सामान्य क्लाउड-सिंक्ड स्टेट पथों के बारे में चेतावनी देता है और स्थानीय स्टोरेज पर वापस जाने की अनुशंसा करता है। देखें एनवायरनमेंट वैरिएबल्स और Doctor।

ऐप कनेक्टिविटी डीबग करें

ऐप द्वारा उपयोग किए जाने वाले उसी Gateway WebSocket हैंडशेक और डिस्कवरी लॉजिक को चलाने के लिए स्रोत चेकआउट से macOS डीबग CLI का उपयोग करें:

cd apps/macosswift run openclaw-mac connect --jsonswift run openclaw-mac discover --timeout 3000 --json

connect --url, --token, --timeout, और --json स्वीकार करता है। discover --timeout, --json, और --include-local स्वीकार करता है। जब आपको CLI डिस्कवरी को ऐप-साइड कनेक्शन समस्याओं से अलग करना हो, तो डिस्कवरी आउटपुट की तुलना openclaw gateway discover --json से करें।

Smoke चेक

openclaw --version OPENCLAW_SKIP_CHANNELS=1 \OPENCLAW_SKIP_CANVAS_HOST=1 \openclaw gateway --port 18999 --bind loopback

फिर:

openclaw gateway call health --url ws://127.0.0.1:18999 --timeout 3000

संबंधित

• macOS ऐप
• Gateway रनबुक