> ## 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 डेवलपर सेटअप

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

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

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

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

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

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

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm install
```

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

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
./scripts/package-mac-app.sh
```

यदि आपके पास Apple Developer ID प्रमाणपत्र नहीं है, तो स्क्रिप्ट अपने-आप **एड-हॉक साइनिंग** (`-`) का उपयोग करेगी।

डेव रन मोड, साइनिंग फ़्लैग, और Team ID समस्या-निवारण के लिए, macOS ऐप README देखें:
[https://github.com/openclaw/openclaw/blob/main/apps/macos/README.md](https://github.com/openclaw/openclaw/blob/main/apps/macos/README.md)

> **नोट**: एड-हॉक साइन किए गए ऐप सुरक्षा संकेत दिखा सकते हैं। यदि ऐप "Abort trap 6" के साथ तुरंत क्रैश हो जाता है, तो [समस्या-निवारण](#troubleshooting) अनुभाग देखें।

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

macOS ऐप पृष्ठभूमि कार्यों को प्रबंधित करने के लिए वैश्विक `openclaw` CLI इंस्टॉल की अपेक्षा करता है।

**इसे इंस्टॉल करने के लिए (अनुशंसित):**

1. OpenClaw ऐप खोलें।
2. **सामान्य** सेटिंग टैब पर जाएं।
3. **"CLI इंस्टॉल करें"** पर क्लिक करें।

वैकल्पिक रूप से, इसे मैन्युअल रूप से इंस्टॉल करें:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
npm install -g openclaw@<version>
```

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

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

### बिल्ड विफल: टूलचेन या SDK मेल नहीं खाता

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

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

* **सॉफ़्टवेयर अपडेट में उपलब्ध नवीनतम macOS संस्करण** (Xcode 26.2 SDKs द्वारा आवश्यक)
* **Xcode 26.2** (Swift 6.2 टूलचेन)

**जांचें:**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
xcodebuild -version
xcrun swift --version
```

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

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

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

**सुधार:**

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

   ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
   tccutil reset All ai.openclaw.mac.debug
   ```

2. यदि वह विफल होता है, तो macOS से "साफ़ शुरुआत" मजबूर करने के लिए [`scripts/package-mac-app.sh`](https://github.com/openclaw/openclaw/blob/main/scripts/package-mac-app.sh) में `BUNDLE_ID` को अस्थायी रूप से बदलें।

### Gateway "शुरू हो रहा है..." अनिश्चित काल तक

यदि Gateway स्थिति "शुरू हो रहा है..." पर बनी रहती है, तो जांचें कि क्या कोई ज़ॉम्बी प्रोसेस पोर्ट पकड़े हुए है:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway status
openclaw gateway stop

# यदि आप LaunchAgent (डेव मोड / मैन्युअल रन) का उपयोग नहीं कर रहे हैं, तो listener खोजें:
lsof -nP -iTCP:18789 -sTCP:LISTEN
```

यदि कोई मैन्युअल रन पोर्ट पकड़े हुए है, तो उस प्रोसेस को रोकें (Ctrl+C)। अंतिम उपाय के रूप में, ऊपर मिला PID समाप्त करें।

## संबंधित

* [macOS ऐप](/hi/platforms/macos)
* [इंस्टॉल अवलोकन](/hi/install)