मुख्य सामग्री पर जाएं
यह दस्तावेज़ वर्तमान पहली बार चलने वाले सेटअप फ़्लो का वर्णन करता है। लक्ष्य एक सरल “day 0” अनुभव है: चुनें कि Gateway कहाँ चलता है, auth कनेक्ट करें, wizard चलाएँ, और agent को खुद को bootstrap करने दें। onboarding पथों के सामान्य अवलोकन के लिए, Onboarding Overview देखें।
1

macOS चेतावनी स्वीकृत करें

2

स्थानीय नेटवर्क खोजने की अनुमति दें

3

स्वागत और सुरक्षा सूचना

सुरक्षा विश्वास मॉडल:
  • डिफ़ॉल्ट रूप से, OpenClaw एक व्यक्तिगत agent है: एक विश्वसनीय operator सीमा।
  • साझा/बहु-उपयोगकर्ता सेटअप के लिए lock-down आवश्यक है (trust boundaries अलग करें, tool access न्यूनतम रखें, और Security का पालन करें)।
  • स्थानीय onboarding अब नए configs को डिफ़ॉल्ट रूप से tools.profile: "coding" पर सेट करता है ताकि नए स्थानीय सेटअप unrestricted full profile को बाध्य किए बिना filesystem/runtime tools रख सकें।
  • यदि hooks/webhooks या अन्य अविश्वसनीय content feeds सक्षम हैं, तो एक मजबूत आधुनिक model tier का उपयोग करें और सख्त tool policy/sandboxing रखें।
4

स्थानीय बनाम रिमोट

Gateway कहाँ चलता है?
  • यह Mac (केवल स्थानीय): onboarding auth configure कर सकता है और credentials स्थानीय रूप से लिख सकता है।
  • रिमोट (SSH/Tailnet के ज़रिए): onboarding स्थानीय auth configure नहीं करता; credentials gateway host पर मौजूद होने चाहिए। remote gateway token field macOS app द्वारा उस Gateway से connect करने के लिए उपयोग किया गया token store करता है; मौजूदा non-plaintext gateway.remote.token values तब तक सुरक्षित रखे जाते हैं जब तक आप उन्हें replace नहीं करते।
  • बाद में configure करें: setup छोड़ें और app को unconfigured रहने दें।
Gateway auth सुझाव:
  • wizard अब loopback के लिए भी एक token generate करता है, इसलिए local WS clients को authenticate करना होगा।
  • यदि आप auth disable करते हैं, तो कोई भी local process connect कर सकता है; इसका उपयोग केवल पूरी तरह विश्वसनीय machines पर करें।
  • multi-machine access या non-loopback binds के लिए token का उपयोग करें।
5

अनुमतियाँ

Onboarding इन कार्यों के लिए आवश्यक TCC अनुमतियाँ मांगता है:
  • Automation (AppleScript)
  • Notifications
  • Accessibility
  • Screen Recording
  • Microphone
  • Speech Recognition
  • Camera
  • Location
6

CLI

यह चरण वैकल्पिक है
app npm, pnpm, या bun के ज़रिए वैश्विक openclaw CLI install कर सकता है। यह पहले npm को प्राथमिकता देता है, फिर pnpm को, फिर bun को यदि वही एकमात्र detect किया गया package manager है। Gateway runtime के लिए, Node अनुशंसित path बना रहता है।
7

Onboarding Chat (समर्पित session)

setup के बाद, app एक समर्पित onboarding chat session खोलता है ताकि agent अपना परिचय दे सके और अगले steps guide कर सके। यह first-run guidance को आपकी सामान्य conversation से अलग रखता है। पहले agent run के दौरान gateway host पर क्या होता है, इसके लिए Bootstrapping देखें।

​
संबंधित