macOS पर Gateway

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

CLI इंस्टॉल करें (local mode के लिए आवश्यक)

Mac पर Node 24 डिफ़ॉल्ट runtime है। संगतता के लिए Node 22 LTS, वर्तमान में 22.19+, अभी भी काम करता है। फिर openclaw को globally इंस्टॉल करें:

npm install -g openclaw@<version>

macOS ऐप का CLI इंस्टॉल करें बटन वही global install flow चलाता है जिसे ऐप आंतरिक रूप से उपयोग करता है: यह पहले npm को प्राथमिकता देता है, फिर pnpm को, फिर bun को, यदि वही एकमात्र detected package manager हो। Node अनुशंसित Gateway runtime बना रहता है।

Launchd (Gateway as LaunchAgent)

लेबल:

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

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

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

मैनेजर:

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

व्यवहार:

• "OpenClaw Active" LaunchAgent को enable/disable करता है।
• ऐप quit करने से gateway बंद नहीं होता (launchd इसे जीवित रखता है)।
• यदि configured port पर कोई Gateway पहले से चल रहा है, तो ऐप नया शुरू करने के बजाय उससे जुड़ जाता है।

लॉगिंग:

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

Version compatibility

macOS ऐप gateway version को अपने version के साथ जाँचता है। यदि वे असंगत हैं, तो app version से मिलाने के लिए global CLI को update करें।

macOS पर state directory

OpenClaw state को स्थानीय, non-synced disk पर रखें। iCloud Drive और अन्य cloud-synced folders से बचें क्योंकि sync latency और file locks sessions, credentials, और Gateway state को प्रभावित कर सकते हैं।

OPENCLAW_STATE_DIR को स्थानीय path पर केवल तब सेट करें जब आपको override चाहिए। openclaw doctor सामान्य cloud-synced state paths के बारे में चेतावनी देता है और local storage पर वापस जाने की सलाह देता है। देखें environment variables और Doctor।

ऐप connectivity debug करें

source checkout से macOS debug CLI का उपयोग करके वही Gateway WebSocket handshake और discovery logic चलाएँ जिसे ऐप उपयोग करता है:

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 discovery को app-side connection issues से अलग करना हो, तो discovery output की तुलना openclaw gateway discover --json से करें।

Smoke check

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 app
• Gateway runbook