openclaw onboard

निर्देशित सेटअप जो पहले इनफ़रेंस स्थापित करता है: यह मौजूदा AI पहुँच का पता लगाता है, लाइव कम्प्लीशन आवश्यक बनाता है, केवल कार्यशील रूट को सहेजता है, और फिर शेष कॉन्फ़िगर करने के लिए OpenClaw शुरू करता है। नए सिस्टम पर या जब भी कोई ऑनबोर्डिंग विकल्प मौजूद हो, openclaw setup इस प्रवाह तक पहुँचता है; कॉन्फ़िगर किए गए सिस्टम सिस्टम-एजेंट चैट के लिए केवल openclaw setup का उपयोग करते हैं। openclaw setup --baseline केवल आधारभूत कॉन्फ़िगरेशन/वर्कस्पेस लिखता है।

उदाहरण

openclaw onboardopenclaw onboard --tuiopenclaw onboard --classicopenclaw onboard --modernopenclaw onboard --flow quickstartopenclaw onboard --flow manualopenclaw onboard --flow importopenclaw onboard --import-from hermes --import-source ~/.hermesopenclaw onboard --skip-bootstrapopenclaw onboard recommendations --jsonopenclaw onboard recommendations acknowledgeopenclaw onboard recommendations acknowledge --retry "<failed-id>"openclaw onboard recommendations refreshopenclaw onboard --mode remote --remote-url wss://gateway-host:18789

openclaw onboard recommendations ऑनबोर्डिंग के दौरान संग्रहीत लंबित ऐप-अनुशंसा मिलानों को पढ़ता है। पहली बार के बूटस्ट्रैप द्वारा उपयोग की जाने वाली मशीन-पठनीय सूची के लिए --json जोड़ें। यह कमांड इंस्टॉल किए गए ऐप्स को दोबारा स्कैन नहीं करता और न ही किसी मॉडल को कॉल करता है। इसके आउटपुट में केवल सत्यापित इंस्टॉल ID, स्रोत और टियर होते हैं; यह जानबूझकर अविश्वसनीय मार्केटप्लेस विवरण, मॉडल के कारण और स्थानीय ऐप लेबल छोड़ देता है। अनुशंसा प्रस्ताव का उत्तर दिए जाने के बाद, कमांड एक खाली सूची लौटाता है और भविष्य के ऑनबोर्डिंग रन इस चरण को पूरी तरह छोड़ देते हैं। openclaw onboard recommendations refresh संग्रहीत प्रस्ताव को साफ़ करता है ताकि अगला ऑनबोर्डिंग रन इंस्टॉल किए गए ऐप्स को दोबारा स्कैन करे और नया प्रस्ताव बनाए।

नए वर्कस्पेस अनुशंसा का चुनाव बूटस्ट्रैप वार्तालाप तक स्थगित करते हैं। उस वार्तालाप द्वारा उपयोगकर्ता के चुनावों को संभालने के बाद, openclaw onboard recommendations acknowledge संग्रहीत प्रस्ताव को उत्तर दिया हुआ चिह्नित करता है। अभिस्वीकृति आइडेम्पोटेंट है। यदि चुना गया इंस्टॉल विफल हो जाता है, तो प्रत्येक विफल अपारदर्शी ID को --retry <id...> के साथ पास करें; सफल और अस्वीकृत मिलान उपयोग कर लिए जाते हैं, जबकि विफल मिलान बाद के ऑनबोर्डिंग रन के लिए लंबित रहते हैं। अज्ञात ID संग्रहीत प्रस्ताव को बदले बिना विफल हो जाते हैं। बाधित ClawHub skill इंस्टॉल के बाद, मौजूदा लक्ष्य को केवल तभी सफल माना जाता है जब openclaw skills verify "@owner/slug" उसी प्रकाशक-योग्य अनुशंसा ID के लिए सफल हो और उसका JSON आउटपुट openclaw.resolution.source: "installed" रिपोर्ट करे। केवल रजिस्ट्री सत्यापन स्थानीय इंस्टॉल का प्रमाण नहीं है। अन्यथा उस ID को --retry के साथ लंबित रखें और मौजूदा skill को अधिलेखित न करें।

• --classic: संपूर्ण चरण-दर-चरण विज़ार्ड खोलता है। इसे --non-interactive के साथ संयोजित नहीं किया जा सकता; स्वचालित सेटअप के लिए --classic छोड़ दें।
• --flow quickstart: न्यूनतम प्रॉम्प्ट वाला क्लासिक विज़ार्ड खोलता है, डिफ़ॉल्ट रूप से टोकन प्रमाणीकरण का उपयोग करता है, और जब कोई संग्रहीत या स्पष्ट क्रेडेंशियल लागू नहीं होता, तब टोकन जनरेट करता है। स्पष्ट स्थानीय Gateway फ़्लैग, जैसे --gateway-port, --gateway-bind, --gateway-auth, और --tailscale, संबंधित संग्रहीत या डिफ़ॉल्ट क्विकस्टार्ट मानों को ओवरराइड करते हैं; छोड़े गए विकल्प अपने वर्तमान मान बनाए रखते हैं।
• --flow manual (उपनाम advanced): पोर्ट, बाइंड और प्रमाणीकरण के लिए पूर्ण प्रॉम्प्ट वाला क्लासिक विज़ार्ड खोलता है।
• --flow import: नए सेटअप पर पता लगाए गए माइग्रेशन प्रदाता को चलाता है (उदाहरण के लिए --import-from hermes के माध्यम से Hermes)। पुष्टि के बाद, ऑनबोर्डिंग कॉन्फ़िगरेशन, क्रेडेंशियल, वर्कस्पेस फ़ाइलें, मेमोरी और skills को निजी अस्थायी लक्ष्यों के अंतर्गत स्टेज करता है; आयातित इनफ़रेंस को वर्कस्पेस और एजेंट स्थिति प्रोमोट किए जाने तथा कॉन्फ़िगरेशन कमिट किए जाने से पहले लाइव कम्प्लीशन पास करना आवश्यक है। प्रोमोशन से पहले विफलता या रद्दीकरण लाइव लक्ष्य को अछूता छोड़ता है। वापस न किए जा सकने वाले बाहरी सक्रियण चरण, जैसे Codex Plugin इंस्टॉलेशन, बाद में चलते हैं और माइग्रेशन रिपोर्ट से पुनः प्रयास योग्य रहते हैं। यदि कोई कॉन्फ़िगरेशन, क्रेडेंशियल, सत्र या वर्कस्पेस स्थिति मौजूद हो, तो पहले उसे रीसेट करें। ड्राई-रन योजनाओं, अधिलेखन मोड, सत्यापित बैकअप, रिपोर्ट और सटीक मैपिंग के लिए openclaw migrate का उपयोग करें।
• --remote-url और --remote-token: क्लासिक रिमोट Gateway चरण को पहले से भरते हैं और इस रन के लिए संग्रहीत रिमोट मानों को ओवरराइड करते हैं। URL बदलने पर संग्रहीत क्रेडेंशियल का पुनः उपयोग नहीं होता, जब तक आप टोकन भी पास न करें। टोकन प्रॉम्प्ट में छिपा रहता है और विज़ार्ड की मौजूदा प्लेनटेक्स्ट या SecretRef भंडारण पसंद का पालन करता है।
• --tailscale-reset-on-exit और --no-tailscale-reset-on-exit: स्पष्ट रूप से नियंत्रित करते हैं कि Gateway के बाहर निकलने पर Tailscale Serve या Funnel कॉन्फ़िगरेशन रीसेट किया जाए या नहीं। दोनों को छोड़ने पर गैर-इंटरैक्टिव पुनः रन के दौरान वर्तमान सेटिंग सुरक्षित रहती है।
• --modern OpenClaw संवादात्मक सेटअप सहायक के लिए एक संगतता उपनाम है। यह openclaw setup के समान लाइव-इनफ़रेंस गेट का उपयोग करता है और केवल --workspace, --accept-risk, --non-interactive, और --json स्वीकार करता है। अन्य सेटअप फ़्लैग चुपचाप अनदेखा किए जाने के बजाय अस्वीकार कर दिए जाते हैं।

निर्देशित प्रवाह

केवल openclaw onboard निर्देशित प्रवाह शुरू करता है। यह सुरक्षा सूचना दिखाता है, फिर शुरुआत में एक प्रश्न पूछता है: पूर्ण पहुँच (अनुशंसित — सेटअप स्वचालित रूप से AI ऐप्स, कुंजियों और स्थानीय रनटाइम की खोज करता है) या पहले पूछें (सेटअप आसपास खोजने से पहले एक बार पूछता है, या आपको मैन्युअल रूप से कॉन्फ़िगर करने देता है)। यह चुनाव wizard.accessMode के रूप में सहेजा जाता है। खोज की अनुमति होने पर, ऑनबोर्डिंग कॉन्फ़िगर किए गए मॉडल, API-कुंजी पर्यावरण चर और समर्थित स्थानीय CLI के माध्यम से पहले से उपलब्ध AI पहुँच का पता लगाता है, फिर वास्तविक कम्प्लीशन के साथ अनुशंसित उम्मीदवार का परीक्षण करता है। यदि कोई उम्मीदवार विफल होता है, तो ऑनबोर्डिंग चुपचाप अगले उपयोग योग्य उम्मीदवार को आज़माता है और प्रतिक्रिया न देने वाले सभी उम्मीदवारों को एक पंक्ति में सारांशित करता है; कार्यशील रूट की घोषणा बाकी सभी विकल्प देखने के लिए एक-कीस्ट्रोक विकल्प के साथ की जाती है।

यदि स्वचालित पहचान के सभी विकल्प समाप्त हो जाते हैं, तो प्रदाता चयनकर्ता पहले OpenAI, Anthropic, xAI (Grok), Google और OpenRouter दिखाता है। अन्य सभी समर्थित प्रदाताओं को प्रदाता के अनुसार समूहित देखने के लिए More… चुनें; इसके बाद क्षेत्र, योजनाएँ और प्रमाणीकरण विधियाँ दूसरे मेनू में दिखाई देती हैं। समर्थित ब्राउज़र या डिवाइस साइन-इन तथा छिपी हुई API-कुंजी या टोकन विधियाँ समान लाइव कम्प्लीशन पथ का उपयोग करती हैं। परीक्षण सफल होने के बाद OpenClaw केवल सत्यापित मॉडल रूट और उसके क्रेडेंशियल को सहेजता है; विफल उम्मीदवार कॉन्फ़िगर किए गए मॉडल को प्रतिस्थापित नहीं करता या आज़माया गया क्रेडेंशियल सहेजता नहीं है। OpenClaw शुरू किए बिना बाहर निकलने के लिए Skip for now चुनें और तैयार होने पर openclaw onboard फिर से चलाएँ। OpenClaw शुरू होने तक वर्कस्पेस और Gateway सेटअप अपरिवर्तित रहते हैं।

निर्देशित मोड में, --workspace <dir> OpenClaw का प्रस्तावित वर्कस्पेस और पृथक इनफ़रेंस संदर्भ प्रदान करता है। जब तक आप OpenClaw सेटअप प्रस्ताव को स्वीकृति नहीं देते, तब तक इसे सहेजा नहीं जाता। क्लासिक और गैर-इंटरैक्टिव ऑनबोर्डिंग अपने वर्कस्पेस को अपने सामान्य सेटअप प्रवाह के माध्यम से सहेजते हैं। मौजूदा एजेंट रोस्टर के साथ पुनः रन करने पर, ऑनबोर्डिंग कॉन्फ़िगर किए गए फ़्लीट वर्कस्पेस को सुरक्षित रखता है: क्लासिक विज़ार्ड दोनों पथ दिखाता है और उसे स्थानांतरित करने से पहले स्पष्ट पुष्टि आवश्यक बनाता है, जबकि गैर-इंटरैक्टिव सेटअप चेतावनी देता है और वर्तमान मान बनाए रखता है।

इनफ़रेंस पास होने के बाद, ऑनबोर्डिंग समर्थित स्थानीय AI टूल की मेमोरी की जाँच करता है: Claude Code ऑटो-मेमोरी, Codex समेकित मेमोरी और Hermes मेमोरी फ़ाइलें। कोई भी मिलने पर, एक पृष्ठ उन्हें अनुक्रमित पुनःस्मरण के लिए एजेंट वर्कस्पेस में memory/imports/ के अंतर्गत कॉपी करने की पेशकश करता है। पुष्टि के बिना कुछ भी आयात नहीं किया जाता, पहले आयात की गई फ़ाइलें छोड़ दी जाती हैं, और आप बाद में हमेशा Control UI के मेमोरी आयात पृष्ठ से आयात कर सकते हैं, जो समान केवल-मेमोरी दायरा प्रदान करता है। (पूर्ण openclaw migrate रन अधिक व्यापक है: यह कॉन्फ़िगरेशन, skills और क्रेडेंशियल भी आयात कर सकता है।) क्लासिक विज़ार्ड वर्कस्पेस तैयार करने के बाद समान पृष्ठ दिखाता है।

इनफ़रेंस पास होने (और मेमोरी-आयात प्रस्ताव) के बाद, निर्देशित ऑनबोर्डिंग मानक सेटअप स्वचालित रूप से लागू करता है — वर्कस्पेस, Gateway और सत्र, वही योजना जिसे संवादात्मक openclaw setup चैट "yes" पर लागू करती — फिर इंस्टॉल किए गए ऐप्स से Plugin और skill अनुशंसाएँ प्रस्तुत करता है; ऐप नामों का मिलान आपके कॉन्फ़िगर किए गए मॉडल और ClawHub खोज के माध्यम से किया जाता है, और इस चरण को wizard.appRecommendations से अक्षम किया जा सकता है। macOS, Linux या Windows डेस्कटॉप सत्र में, यह फिर प्रमाणीकृत Control UI डैशबोर्ड खोलता है और ब्राउज़र क्लाइंट के कनेक्ट होने के लिए अधिकतम 60 सेकंड तक प्रतीक्षा करता है। हेडलेस Linux या SSH पर, यह एक प्रमुख, कॉपी-पेस्ट योग्य डैशबोर्ड URL प्रिंट करता है, जिसमें लूपबैक Gateway के लिए SSH पोर्ट-फ़ॉरवर्ड कमांड शामिल होता है, और अधिकतम पाँच मिनट प्रतीक्षा करता है। सफल कनेक्शन ब्राउज़र में जारी रहता है; अगम्य Gateway या टाइमआउट पहले की तरह उसी टर्मिनल निकास-विकल्प पर लौटता है। ब्राउज़र हस्तांतरण छोड़ने और उस टर्मिनल निकास-विकल्प को बाध्य करने के लिए --tui पास करें। यदि सेटअप लागू करना विफल हो जाता है, तो ऑनबोर्डिंग इंटरैक्टिव रूप से पूरा करने के लिए संवादात्मक OpenClaw चैट पर लौटता है। चैनल, एजेंट, plugins और अन्य वैकल्पिक सुविधाएँ OpenClaw चैट के क्षेत्र में रहती हैं: openclaw चलाएँ और चैनल क्रेडेंशियल संग्रह को छिपे हुए टर्मिनल विज़ार्ड को सौंपने के लिए open channel wizard for <channel> का उपयोग करें। मॉडल प्रदाता या उसके प्रमाणीकरण को बदलने के लिए, OpenClaw से बाहर निकलें और openclaw onboard चलाएँ; OpenClaw निर्देशित या क्लासिक प्रदाता प्रवाह नहीं खोलता।

कॉन्फ़िगर किए गए इंस्टॉल पर, openclaw onboard को फिर से चलाने पर पहले वर्तमान डिफ़ॉल्ट मॉडल सत्यापित होता है, इसलिए वही प्रवाह सत्यापन और सुधार चरण के रूप में कार्य करता है — यह सेटअप दोबारा लागू नहीं करता, पुनः इंस्टॉल नहीं करता और Gateway सेवा को पुनः शुरू नहीं करता। यदि यह जाँच विफल होती है, तो कॉन्फ़िगर किया गया मॉडल कभी भी स्वचालित रूप से प्रतिस्थापित नहीं होता — ऑनबोर्डिंग रुकता है और पूछता है कि आगे कैसे बढ़ना है। जाँच आपके वर्कस्पेस के बाहर चलती है, इसलिए वर्कस्पेस Plugin द्वारा प्रदान किया गया मॉडल यहाँ विफल हो सकता है जबकि एजेंट में अभी भी काम करता रहे। प्रदाता-विशिष्ट प्रमाणीकरण, चैनल, skills, रिमोट Gateway सेटअप, आयात या पूर्ण Gateway नियंत्रणों के लिए openclaw onboard --classic का उपयोग करें। संवादात्मक गैर-इनफ़रेंस सेटअप और सुधार के लिए openclaw setup चलाएँ; openclaw onboard --modern समान इनफ़रेंस गेट के माध्यम से एक संगतता उपनाम है। क्लासिक विज़ार्ड वैकल्पिक रूप से लाइव कम्प्लीशन के साथ डिफ़ॉल्ट मॉडल सत्यापित कर सकता है, लेकिन OpenClaw तब तक शुरू नहीं होगा जब तक उसकी अपनी लाइव इनफ़रेंस जाँच पास नहीं हो जाती।

इंटरैक्टिव टर्मिनल में, केवल openclaw (कोई सबकमांड नहीं) कॉन्फ़िगरेशन स्थिति के अनुसार रूट करता है:

• यदि सक्रिय कॉन्फ़िगरेशन फ़ाइल अनुपस्थित है या उसमें लिखी गई कोई सेटिंग नहीं है (खाली या केवल मेटाडेटा), तो यह निर्देशित ऑनबोर्डिंग शुरू करता है।
• यदि कॉन्फ़िगरेशन फ़ाइल मौजूद है लेकिन सत्यापन में विफल होती है, तो यह openclaw doctor मार्गदर्शन के साथ क्लासिक ऑनबोर्डिंग पथ शुरू करता है। OpenClaw को कार्यशील इनफ़रेंस चाहिए और इस पूर्व-इनफ़रेंस स्थिति को सुधारने के लिए इसका उपयोग नहीं किया जाता।
• यदि कॉन्फ़िगरेशन फ़ाइल मान्य है, तो यह सामान्य एजेंट TUI खोलता है। एजेंट और मॉडल वाला पहुँच योग्य कॉन्फ़िगर किया गया Gateway ऑनबोर्डिंग या OpenClaw के बिना सीधे उस UI पर जाता है। कॉन्फ़िगर किए गए इंस्टॉल पर, TUI के भीतर /openclaw या openclaw setup से OpenClaw तक पहुँचें।

लूपबैक, निजी IP लिटरल, .local, और Tailnet *.ts.net Gateway URL के लिए प्लेनटेक्स्ट ws:// स्वीकार किया जाता है। अन्य विश्वसनीय निजी-DNS नामों के लिए, ऑनबोर्डिंग प्रक्रिया परिवेश में OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 सेट करें।

रीसेट

openclaw onboard --resetopenclaw onboard --reset --reset-scope full

--reset सेटअप चलाने से पहले स्थिति मिटाता है। --reset-scope नियंत्रित करता है कि कितना मिटाया जाए: config (केवल कॉन्फ़िगरेशन), config+creds+sessions (जब --reset को बिना किसी दायरे के पास किया जाता है, तब डिफ़ॉल्ट), या full (वर्कस्पेस को भी रीसेट करता है)। वर्कस्पेस रीसेट केवल --reset-scope full के साथ होता है।

लोकेल

इंटरैक्टिव ऑनबोर्डिंग निश्चित सेटअप पाठ के लिए CLI विज़ार्ड लोकेल का उपयोग करती है। यह इस क्रम में पहले गैर-रिक्त मान का उपयोग करती है:

1. OPENCLAW_LOCALE
2. LC_ALL
3. LC_MESSAGES
4. LANG
5. अंग्रेज़ी फ़ॉलबैक

समर्थित विज़ार्ड लोकेल en, zh-CN, और zh-TW हैं। लोकेल मान अंडरस्कोर या POSIX प्रत्यय वाले रूपों का उपयोग कर सकते हैं, जैसे zh_CN.UTF-8। उत्पाद नाम, कमांड नाम, कॉन्फ़िगरेशन कुंजियाँ, URL, प्रदाता ID, मॉडल ID, और Plugin/चैनल लेबल अपरिवर्तित रहते हैं।

OPENCLAW_LOCALE=zh-CN openclaw onboardOPENCLAW_LOCALE=en openclaw onboard # स्पष्ट अंग्रेज़ी ओवरराइड

गैर-इंटरैक्टिव सेटअप

--non-interactive के लिए --accept-risk आवश्यक है (यह स्वीकार करता है कि एजेंट शक्तिशाली होते हैं और पूर्ण सिस्टम पहुँच जोखिमपूर्ण है)। --mode का डिफ़ॉल्ट local है।

openclaw onboard --non-interactive \  --auth-choice custom-api-key \  --custom-base-url "https://llm.example.com/v1" \  --custom-model-id "foo-large" \  --custom-api-key "$CUSTOM_API_KEY" \  --secret-input-mode plaintext \  --custom-compatibility openai \  --custom-image-input

--custom-api-key वैकल्पिक है; इसे छोड़ने पर ऑनबोर्डिंग env में CUSTOM_API_KEY की जाँच करती है। OpenClaw सामान्य विज़न मॉडल ID (GPT-4o/4.1/5.x, Claude 3/4, Gemini, Qwen-VL, LLaVA, Pixtral, और इसी तरह के मॉडल) को स्वचालित रूप से छवि-सक्षम चिह्नित करता है। अज्ञात कस्टम विज़न ID के लिए --custom-image-input पास करें, या केवल-पाठ मेटाडेटा बाध्य करने के लिए --custom-text-input पास करें। ऐसे OpenAI-संगत एंडपॉइंट के लिए --custom-compatibility openai-responses का उपयोग करें जो /v1/responses का समर्थन करते हैं लेकिन /v1/chat/completions का नहीं; मान्य मान openai (डिफ़ॉल्ट), openai-responses, anthropic हैं।

LM Studio में प्रदाता-विशिष्ट कुंजी फ़्लैग भी है:

openclaw onboard --non-interactive \  --auth-choice lmstudio \  --custom-base-url "http://localhost:1234/v1" \  --custom-model-id "qwen/qwen3.5-9b" \  --lmstudio-api-key "$LM_API_TOKEN" \  --accept-risk

गैर-इंटरैक्टिव Ollama:

openclaw onboard --non-interactive \  --auth-choice ollama \  --custom-base-url "http://ollama-host:11434" \  --custom-model-id "qwen3.5:27b" \  --accept-risk

--custom-base-url का डिफ़ॉल्ट http://127.0.0.1:11434 है। --custom-model-id वैकल्पिक है; इसे छोड़ने पर ऑनबोर्डिंग Ollama के सुझाए गए डिफ़ॉल्ट का उपयोग करती है। kimi-k2.5:cloud जैसे क्लाउड मॉडल ID भी यहाँ काम करते हैं।

प्रदाता कुंजियों को सादे पाठ के बजाय संदर्भों के रूप में संग्रहीत करें:

openclaw onboard --non-interactive \  --auth-choice openai-api-key \  --secret-input-mode ref \  --accept-risk

--secret-input-mode ref के साथ, ऑनबोर्डिंग सादे-पाठ कुंजी मानों के बजाय env-समर्थित संदर्भ लिखती है: प्रमाणीकरण-प्रोफ़ाइल-समर्थित प्रदाताओं के लिए यह keyRef: { source: "env", provider: "default", id: <envVar> } लिखती है; कस्टम प्रदाताओं के लिए यह इसी तरह models.providers.<id>.apiKey लिखती है (उदाहरण के लिए { source: "env", provider: "default", id: "CUSTOM_API_KEY" })। अनुबंध: प्रदाता env चर को ऑनबोर्डिंग प्रक्रिया के परिवेश में सेट करें (उदाहरण के लिए OPENAI_API_KEY) और जब तक वह env चर सेट न हो, इनलाइन कुंजी फ़्लैग भी पास न करें—मेल खाने वाले env चर के बिना दिया गया फ़्लैग मान मार्गदर्शन के साथ तुरंत विफल हो जाता है।

Gateway प्रमाणीकरण (गैर-इंटरैक्टिव)

• --gateway-auth token --gateway-token <token> एक सादा-पाठ टोकन संग्रहीत करता है। token डिफ़ॉल्ट प्रमाणीकरण मोड है।
• --gateway-auth token --gateway-token-ref-env <name>, gateway.auth.token को env SecretRef के रूप में संग्रहीत करता है। ऑनबोर्डिंग प्रक्रिया के परिवेश में उस नाम का गैर-रिक्त env चर आवश्यक है।
• --gateway-token और --gateway-token-ref-env परस्पर अनन्य हैं।
• --install-daemon के साथ: SecretRef-प्रबंधित gateway.auth.token को सत्यापित किया जाता है, लेकिन पर्यवेक्षक सेवा परिवेश मेटाडेटा में हल किए गए सादे पाठ के रूप में स्थायी नहीं किया जाता; यदि संदर्भ अनसुलझा है, तो स्थापना सुधार मार्गदर्शन के साथ सुरक्षित रूप से विफल हो जाती है। यदि gateway.auth.token और gateway.auth.password दोनों कॉन्फ़िगर किए गए हैं और gateway.auth.mode सेट नहीं है, तो मोड को स्पष्ट रूप से सेट किए जाने तक स्थापना अवरुद्ध रहती है।
• स्थानीय ऑनबोर्डिंग कॉन्फ़िगरेशन में gateway.mode="local" लिखती है। बाद की किसी कॉन्फ़िगरेशन फ़ाइल में gateway.mode का न होना कॉन्फ़िगरेशन क्षति या अधूरा मैन्युअल संपादन दर्शाता है, न कि कोई मान्य स्थानीय-मोड शॉर्टकट।
• स्थानीय ऑनबोर्डिंग चुने गए सेटअप पथ के लिए आवश्यक डाउनलोड योग्य plugins स्थापित करती है (उदाहरण के लिए, उन प्रमाणीकरण विकल्पों हेतु Codex या Copilot रनटाइम Plugin)। रिमोट ऑनबोर्डिंग केवल रिमोट Gateway की कनेक्शन जानकारी लिखती है—यह कभी भी स्थानीय Plugin पैकेज स्थापित नहीं करती।
• --allow-unconfigured एक अलग openclaw gateway run आपात विकल्प है; यह ऑनबोर्डिंग को gateway.mode छोड़ने की अनुमति नहीं देता।

export OPENAI_API_KEY="your-provider-key"export OPENCLAW_GATEWAY_TOKEN="your-token"openclaw onboard --non-interactive \  --mode local \  --auth-choice openai-api-key \  --secret-input-mode ref \  --gateway-auth token \  --gateway-token-ref-env OPENCLAW_GATEWAY_TOKEN \  --accept-risk

स्थानीय Gateway स्वास्थ्य

• जब तक आप --skip-health पास नहीं करते, ऑनबोर्डिंग सफलतापूर्वक समाप्त होने से पहले पहुँच योग्य स्थानीय Gateway की प्रतीक्षा करती है।
• --install-daemon पहले प्रबंधित Gateway स्थापना पथ शुरू करता है। इसके बिना, स्थानीय Gateway पहले से चल रहा होना चाहिए (उदाहरण के लिए openclaw gateway run)।
• यदि स्वचालन में केवल कॉन्फ़िगरेशन/वर्कस्पेस/बूटस्ट्रैप लेखन चाहिए, तो --skip-health प्रतीक्षा छोड़ देता है।
• --skip-bootstrap, agents.defaults.skipBootstrap: true सेट करता है और AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md, और BOOTSTRAP.md बनाना छोड़ देता है।
• नेटिव Windows पर, --install-daemon पहले Scheduled Tasks का प्रयास करता है और कार्य निर्माण अस्वीकृत होने पर प्रति-उपयोगकर्ता Startup-folder लॉगिन आइटम पर फ़ॉलबैक करता है।

इंटरैक्टिव संदर्भ मोड

• संकेत मिलने पर गुप्त संदर्भ का उपयोग करें चुनें, फिर परिवेश चर या कोई कॉन्फ़िगर किया गया गुप्त प्रदाता (file या exec) चुनें।
• ऑनबोर्डिंग संदर्भ सहेजने से पहले तेज़ प्रारंभिक सत्यापन चलाती है और विफलता होने पर आपको पुनः प्रयास करने देती है।

Z.AI एंडपॉइंट विकल्प

# संकेत-रहित एंडपॉइंट चयनopenclaw onboard --non-interactive \  --auth-choice zai-coding-global \  --zai-api-key "$ZAI_API_KEY" # अन्य Z.AI एंडपॉइंट विकल्प: zai-coding-cn, zai-global, zai-cn

Mistral:

openclaw onboard --non-interactive \  --auth-choice mistral-api-key \  --mistral-api-key "$MISTRAL_API_KEY"

अतिरिक्त गैर-इंटरैक्टिव फ़्लैग

टोकन-आधारित मॉडल प्रमाणीकरण (--auth-choice token के साथ उपयोग किया जाता है):

Cloudflare AI Gateway: --cloudflare-ai-gateway-account-id <id>, --cloudflare-ai-gateway-gateway-id <id>।

डेमन स्थापना नियंत्रण: --no-install-daemon / --skip-daemon (उपनाम; Gateway सेवा स्थापना छोड़ें), --daemon-runtime <node>।

Skills: --node-manager <npm|pnpm|bun> (डिफ़ॉल्ट npm), --skip-skills।

UI और हुक सेटअप: --skip-ui (Control UI/TUI संकेत छोड़ें), --skip-hooks (Webhook/हुक सेटअप छोड़ें), --skip-channels, --skip-search।

आउटपुट: --suppress-gateway-token-output टोकन वाले Gateway/UI आउटपुट (टोकन संकेत, अंतर्निहित टोकन वाला स्वतः-लॉगिन URL, और Control UI का स्वचालित प्रारंभ) को दबाता है—यह साझा टर्मिनलों और CI में उपयोगी है।

प्रदाता पूर्व-फ़िल्टरिंग

जब कोई प्रमाणीकरण विकल्प पसंदीदा प्रदाता का संकेत देता है, तो ऑनबोर्डिंग डिफ़ॉल्ट-मॉडल और अनुमत-सूची चयनकर्ताओं को उस प्रदाता के मॉडलों तक पहले से फ़िल्टर करती है। फ़िल्टर उसी Plugin के स्वामित्व वाले अन्य प्रदाताओं से भी मेल खाता है, जिसमें volcengine/volcengine-plan और byteplus/byteplus-plan जैसे coding-plan संस्करण शामिल होते हैं। यदि पसंदीदा-प्रदाता फ़िल्टर से कोई लोड किया गया मॉडल नहीं मिलता, तो चयनकर्ता को खाली छोड़ने के बजाय ऑनबोर्डिंग बिना फ़िल्टर वाली सूची पर फ़ॉलबैक करती है।

वेब-खोज अनुवर्ती चरण

कुछ वेब-खोज प्रदाता ऑनबोर्डिंग के दौरान प्रदाता-विशिष्ट अनुवर्ती संकेत सक्रिय करते हैं:

• Grok उसी xAI प्रमाणीकरण और x_search मॉडल विकल्प के साथ वैकल्पिक x_search सेटअप की पेशकश कर सकता है।
• Kimi Moonshot API क्षेत्र (api.moonshot.ai बनाम api.moonshot.cn) और डिफ़ॉल्ट Kimi वेब-खोज मॉडल पूछ सकता है।

अन्य व्यवहार

• स्थानीय ऑनबोर्डिंग DM दायरा व्यवहार: CLI सेटअप संदर्भ।
• सबसे तेज़ पहली चैट: openclaw dashboard (Control UI, कोई चैनल सेटअप नहीं)।
• कस्टम प्रदाता: सूचीबद्ध न किए गए होस्टेड प्रदाताओं सहित किसी भी OpenAI- या Anthropic-संगत एंडपॉइंट को कनेक्ट करें। लाइव जाँच द्वारा स्वतः पता लगाने के लिए अज्ञात संगतता का उपयोग करें।
• यदि Hermes स्थिति का पता चलता है, तो ऑनबोर्डिंग माइग्रेशन प्रवाह प्रस्तुत करती है (ऊपर --flow import देखें)।

सामान्य अनुवर्ती कमांड

बाद में लक्षित गैर-अनुमानात्मक परिवर्तनों के लिए openclaw configure और केवल-चैनल सेटअप के लिए openclaw channels add का उपयोग करें। मॉडल प्रदाता या प्रमाणीकरण मार्ग में परिवर्तन के लिए, इसके बजाय openclaw onboard चलाएँ।

openclaw channels addopenclaw configureopenclaw agents add <name>