---
read_when:
    - macOS ऑनबोर्डिंग सहायक का डिज़ाइन तैयार करना
    - प्रमाणीकरण या पहचान सेटअप लागू करना
sidebarTitle: 'Onboarding: macOS App'
summary: OpenClaw के लिए प्रथम-रन सेटअप प्रवाह (macOS ऐप)
title: ऑनबोर्डिंग (macOS ऐप)
x-i18n:
    generated_at: "2026-07-27T20:33:51Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: 55154774886c530de92b2110d367af24e2142fac48b901f288582d8552a6ca10
    source_path: start/onboarding.md
    workflow: 16
---

macOS ऐप का प्रथम-रन प्रवाह: चुनें कि Gateway कहाँ चलता है, किसी
सत्यापित AI बैकएंड से कनेक्ट करें, अनुमतियाँ दें, और नियंत्रण एजेंट की अपनी
बूटस्ट्रैप प्रक्रिया को सौंपें।
CLI ऑनबोर्डिंग और दोनों तरीकों की तुलना के लिए, [ऑनबोर्डिंग अवलोकन](/hi/start/onboarding-overview) देखें।

<Steps>
<Step title="macOS चेतावनी को स्वीकृति दें">
<Frame>
<img src="/assets/macos-onboarding/01-macos-warning.jpeg" alt="" />
</Frame>
</Step>
<Step title="स्थानीय नेटवर्क खोजने की अनुमति दें">
<Frame>
<img src="/assets/macos-onboarding/02-local-networks.jpeg" alt="" />
</Frame>
</Step>
<Step title="स्वागत और सुरक्षा सूचना">
<Frame caption="प्रदर्शित सुरक्षा सूचना पढ़ें और उसके अनुसार निर्णय लें">
<img src="/assets/macos-onboarding/03-security-notice.png" alt="" />
</Frame>

सुरक्षा विश्वास मॉडल:

- डिफ़ॉल्ट रूप से, OpenClaw एक व्यक्तिगत एजेंट है: एक विश्वसनीय ऑपरेटर सीमा।
- साझा/बहु-उपयोगकर्ता सेटअप को कड़ा करना आवश्यक है: विश्वास सीमाएँ अलग करें, टूल एक्सेस न्यूनतम रखें, और [सुरक्षा](/hi/gateway/security) का पालन करें।
- स्थानीय ऑनबोर्डिंग नए कॉन्फ़िगरेशन को डिफ़ॉल्ट रूप से `tools.profile: "coding"` पर सेट करती है, ताकि नए सेटअप में अप्रतिबंधित `full` प्रोफ़ाइल के बिना फ़ाइलसिस्टम/रनटाइम टूल उपलब्ध रहें।
- यदि हुक/Webhook या अविश्वसनीय सामग्री के अन्य फ़ीड सक्षम हैं, तो किसी सशक्त आधुनिक मॉडल टियर का उपयोग करें और सख्त टूल नीति/सैंडबॉक्सिंग बनाए रखें।

</Step>
<Step title="स्थानीय बनाम रिमोट">
<Frame>
<img src="/assets/macos-onboarding/04-choose-gateway.png" alt="" />
</Frame>

**Gateway** कहाँ चलता है?

- **यह Mac (केवल स्थानीय):** ऑनबोर्डिंग प्रमाणीकरण कॉन्फ़िगर करती है और क्रेडेंशियल स्थानीय रूप से लिखती है।
- **रिमोट (SSH/Tailnet के माध्यम से):** ऑनबोर्डिंग स्थानीय प्रमाणीकरण कॉन्फ़िगर **नहीं** करती;
  क्रेडेंशियल Gateway होस्ट पर पहले से मौजूद होने चाहिए। रिमोट Gateway टोकन
  फ़ील्ड उस टोकन को संग्रहीत करता है जिसका उपयोग macOS ऐप उस Gateway से कनेक्ट करने के लिए करता है;
  मौजूदा `gateway.remote.token` SecretRef मान तब तक सुरक्षित रखे जाते हैं जब तक आप
  उन्हें बदल नहीं देते।
- **बाद में कॉन्फ़िगर करें:** सेटअप छोड़ें और ऐप को बिना कॉन्फ़िगर किए रहने दें।

<Tip>
**Gateway प्रमाणीकरण सुझाव:**

- लूपबैक बाइंड के लिए भी Gateway प्रमाणीकरण मोड डिफ़ॉल्ट रूप से `token` होता है, इसलिए स्थानीय WS क्लाइंट को प्रमाणीकरण करना आवश्यक है।
- `gateway.auth.mode: "none"` सेट करने से कोई भी स्थानीय प्रोसेस कनेक्ट कर सकता है; इसका उपयोग केवल पूर्णतः विश्वसनीय मशीनों पर करें।
- बहु-मशीन एक्सेस या गैर-लूपबैक बाइंड के लिए टोकन का उपयोग करें।

</Tip>
</Step>
<Step title="CLI">
  स्थानीय सेटअप npm, pnpm, या bun के माध्यम से वैश्विक `openclaw` CLI इंस्टॉल करता है,
  जिसमें पहले npm को प्राथमिकता दी जाती है। स्वयं Gateway के लिए Node अनुशंसित रनटाइम
  बना रहता है। मौजूदा संगत इंस्टॉलेशन पुनः उपयोग किए जाते हैं।
</Step>
<Step title="अपने AI को कनेक्ट करें">
  पहले से कॉन्फ़िगर एजेंट मॉडल वाला कनेक्टेड Gateway इस
  पृष्ठ को पूरी तरह छोड़कर सामान्य एजेंट UI खोलता है। OpenClaw और प्रदाता सेटअप
  केवल नए या अधूरे Gateway के लिए चलते हैं।

Gateway तैयार होने के बाद, ऑनबोर्डिंग आपके पास पहले से उपलब्ध AI एक्सेस खोजती है:
Claude Code या Codex लॉगिन, `OPENAI_API_KEY` / `ANTHROPIC_API_KEY`, या कम से कम
16K मापे गए प्रभावी संदर्भ वाला टूल-सक्षम मॉडल, जो किसी पहुँच योग्य Ollama या
LM Studio सर्वर में पहले से इंस्टॉल हो। पहचान Gateway होस्ट पर होती है,
जिसमें वह स्थिति भी शामिल है जब macOS ऐप किसी Linux Gateway से कनेक्ट होता है। सर्वोत्तम
विकल्प का वास्तविक कम्प्लीशन से परीक्षण किया जाता है और उसके उत्तर देने के बाद ही
सहेजा जाता है; परीक्षण विफल होने पर ऐप स्वचालित रूप से अगला विकल्प आज़माता है
और बताता है कि पिछला विकल्प क्यों विफल हुआ। यदि कई विकल्प मिलते हैं, तो आगे बढ़ने से
पहले आप उनके बीच स्विच कर सकते हैं। स्वचालित स्थानीय खोज कभी कोई मॉडल पुल
या डाउनलोड नहीं करती।

जब Gateway होस्ट पर Claude CLI लॉगिन न हो, तब Claude सदस्यता का उपयोग करने के लिए,
Claude Code इंस्टॉल की गई किसी भी मशीन पर
`claude setup-token` चलाएँ, फिर प्रिंट किया गया टोकन **Anthropic setup-token** के रूप में
**Connect with an API key or token** के अंतर्गत पेस्ट करें।

इंस्टॉल किए गए Gemini CLI, Antigravity, Pi, और OpenCode CLI संदर्भ के लिए दिखाए जाते हैं,
जब उन्हें पुनः उपयोग योग्य निर्देशित-सेटअप इन्फ़रेंस मार्ग के रूप में नहीं चुना जा सकता।
Gemini और Antigravity टूल-मुक्त इन्फ़रेंस प्रोब लागू नहीं कर सकते। Pi और
OpenCode सेटअप इन्फ़रेंस मार्गों के बजाय पूर्ण-एजेंट हार्नेस हैं; उनके
सत्र एकीकरणों के लिए अलग रनटाइम और Plugin सेटअप आवश्यक है।

आप प्रदाता के अपने OAuth या डिवाइस-पेयरिंग प्रवाह के माध्यम से भी साइन इन कर सकते हैं।
अंतर्निहित विकल्पों में OpenAI/ChatGPT, OpenRouter, GitHub Copilot, Google
Gemini CLI, xAI, MiniMax Global और CN, तथा Chutes शामिल हैं। यह सूची किसी
निश्चित ऐप सूची के बजाय Gateway के सक्रिय टेक्स्ट-इन्फ़रेंस प्रदाता Plugin से आती है,
इसलिए कोई अन्य प्रदाता प्रदाता-विशिष्ट macOS कोड जोड़े बिना इसमें शामिल हो सकता है।

मैन्युअल कुंजी/टोकन चयनकर्ता उसी प्रदाता रजिस्ट्री का उपयोग करता है। प्रत्येक मार्ग में,
प्रदाता अपना प्रारंभिक मॉडल और कॉन्फ़िगरेशन उपलब्ध कराता है; OpenClaw
उसकी प्रमाणीकरण प्रोफ़ाइल संग्रहीत करने से पहले उसी लाइव परीक्षण से क्रेडेंशियल सत्यापित करता है। जब तक
कोई एक बैकएंड सफल नहीं हो जाता, तब तक आगे बढ़ना लॉक रहता है, इसलिए कार्यशील इन्फ़रेंस के बिना
पहली एजेंट चैट शुरू नहीं हो सकती। वह लाइव जाँच सफल होने के बाद, OpenClaw
शेष वर्कस्पेस, Gateway, चैनल और अन्य वैकल्पिक सुविधाएँ कॉन्फ़िगर करने में
सहायता के लिए उपलब्ध हो जाता है। जब OpenClaw विकल्पों की छोटी सूची प्रस्तुत करता है, तो ऐप
नेटिव विकल्प कार्ड दिखाता है; किसी एक को चुनने पर चयन भेजा जाता है, और **Skip for
now** हमेशा चयन को वैकल्पिक बनाए रखता है। OpenClaw बाद में
Settings → OpenClaw के अंतर्गत भी उपलब्ध रहता है।
</Step>
<Step title="स्मृतियाँ आयात करें (पता चलने पर दिखाया जाता है)">
स्थानीय Gateway के लिए, ऑनबोर्डिंग समर्थित AI
टूल की स्मृतियों के लिए Mac की जाँच करती है: Claude Code ऑटो-मेमोरी, Codex की समेकित स्मृतियाँ और Hermes मेमोरी
फ़ाइलें। इनमें से कोई मिलने पर, यह पृष्ठ प्रत्येक स्रोत को उसकी स्मृति संख्या के साथ सूचीबद्ध करता है
और आपको अनुक्रमित पुनःस्मरण के लिए चयनित स्रोतों को एजेंट वर्कस्पेस में
`memory/imports/` के अंतर्गत आयात करने देता है। पहले से आयात की गई फ़ाइलें छोड़ दी जाती हैं, और
आयात करने के लिए कुछ न होने पर यह पृष्ठ कभी दिखाई नहीं देता। इसे छोड़ना सुरक्षित है;
डैशबोर्ड का मेमोरी आयात पृष्ठ बाद में प्रति-फ़ाइल
नियंत्रण के साथ यही आयात उपलब्ध कराता है।
</Step>
<Step title="अनुमतियाँ">

<Frame caption="चुनें कि आप OpenClaw को कौन-सी अनुमतियाँ देना चाहते हैं">
<img src="/assets/macos-onboarding/05-permissions.png" alt="" />
</Frame>

ऑनबोर्डिंग इनके लिए TCC अनुमतियों का अनुरोध करती है: ऑटोमेशन (AppleScript), सूचनाएँ, अभिगम्यता, स्क्रीन रिकॉर्डिंग, माइक्रोफ़ोन, वाक् पहचान, कैमरा और स्थान।

</Step>
<Step title="समाप्त करें">
  इन्फ़रेंस सफल होने के बाद, OpenClaw शेष वैकल्पिक सेटअप संभालता है और
  आपको सामान्य एजेंट चैट पर ले जा सकता है। अनुमति पूर्वाभ्यास पूरा करने पर
  वही चैट खुलती है; ऐप OpenClaw से पहले वर्कस्पेस नहीं बनाता या अलग
  एजेंट सेटअप वार्तालाप शुरू नहीं करता। एजेंट के पहले वास्तविक टर्न के दौरान
  Gateway होस्ट पर क्या होता है, इसके लिए
  [बूटस्ट्रैपिंग](/hi/start/bootstrapping) देखें।
</Step>
</Steps>

## संबंधित

- [ऑनबोर्डिंग अवलोकन](/hi/start/onboarding-overview)
- [आरंभ करना](/hi/start/getting-started)