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

# 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 इंस्टॉल करें:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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](/hi/help/environment#path-related-env-vars) और
[Doctor](/hi/gateway/doctor)।

## ऐप connectivity debug करें

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
cd apps/macos
swift run openclaw-mac connect --json
swift 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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw --version

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

फिर:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway call health --url ws://127.0.0.1:18999 --timeout 3000
```

## संबंधित

* [macOS app](/hi/platforms/macos)
* [Gateway runbook](/hi/gateway)