ऑनबोर्डिंग (CLI)

openclaw onboard

CLI ऑनबोर्डिंग macOS, Linux और Windows (नेटिव या WSL2) पर अनुशंसित टर्मिनल सेटअप पथ है। डिफ़ॉल्ट रूप से, यह मशीन पर पहले से उपलब्ध AI एक्सेस का पता लगाता है, वास्तविक कम्प्लीशन से उसका सत्यापन करता है और वर्कस्पेस, Gateway तथा वैकल्पिक सुविधाएँ कॉन्फ़िगर करने के लिए OpenClaw शुरू करता है। openclaw setup यही प्रवाह चलाता है (सेटअप में केवल-कॉन्फ़िग वाला --baseline वैरिएंट शामिल है)। Windows डेस्कटॉप उपयोगकर्ता Windows Hub से भी शुरुआत कर सकते हैं।

निर्देशित ऑनबोर्डिंग सबसे पहले इन्फ़रेंस स्थापित करती है। यह उपलब्ध AI एक्सेस का पता लगाती है, वास्तविक कम्प्लीशन आवश्यक बनाती है और उसके बाद ही OpenClaw के शेष हिस्से को कॉन्फ़िगर करने के लिए OpenClaw शुरू करती है। Skip for now चुनने पर OpenClaw शुरू किए बिना ऑनबोर्डिंग बंद हो जाती है।

कस्टम प्रोवाइडर, रिमोट Gateway सेटअप, चैनल पेयरिंग, डेमन नियंत्रण, स्किल और इंपोर्ट के लिए क्लासिक विज़ार्ड उपलब्ध रहता है। इसे openclaw onboard --classic से स्पष्ट रूप से चलाएँ; निर्देशित इन्फ़रेंस पिकर इसे कार्य नहीं सौंपता। इन्फ़रेंस सफल होने के बाद, OpenClaw open channel wizard for <channel> का उपयोग करके सीक्रेट की आवश्यकता वाले चैनल सेटअप को मास्क किए गए टर्मिनल विज़ार्ड को सौंप सकता है। मॉडल प्रोवाइडर या उसके प्रमाणीकरण को बदलने के लिए OpenClaw से बाहर निकलें और openclaw onboard चलाएँ; OpenClaw निर्देशित या क्लासिक प्रोवाइडर प्रवाह नहीं खोलता।

लोकेल

विज़ार्ड निश्चित ऑनबोर्डिंग टेक्स्ट को स्थानीयकृत करता है। यह इसी क्रम में OPENCLAW_LOCALE, LC_ALL, LC_MESSAGES और LANG से पहला गैर-रिक्त मान उपयोग करता है, फिर अंग्रेज़ी पर फ़ॉलबैक करता है। समर्थित लोकेल: en, zh-CN, zh-TW।

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

लोकेल चाहे जो हो, उत्पाद नाम, कमांड, कॉन्फ़िग कुंजियाँ, URL, प्रोवाइडर ID, मॉडल ID और प्लगइन/चैनल लेबल अंग्रेज़ी में रहते हैं।

बाद में गैर-इन्फ़रेंस सेटिंग दोबारा कॉन्फ़िगर करने के लिए:

openclaw configureopenclaw agents add <name>

निर्देशित डिफ़ॉल्ट

सादा openclaw onboard इस पथ का अनुसरण करता है:

1. सुरक्षा सूचना स्वीकार करें।
2. कॉन्फ़िगर किए गए मॉडल, API-कुंजी एनवायरनमेंट वेरिएबल, समर्थित स्थानीय AI CLI और Gateway होस्ट पर पहुँच योग्य Ollama या LM Studio सर्वर से पहले से इंस्टॉल किए गए टूल-सक्षम मॉडल का पता लगाएँ। केवल-पढ़ने वाला यह चरण कभी कोई मॉडल डाउनलोड नहीं करता। Gemini CLI, Antigravity, Pi और OpenCode इंस्टॉलेशन की रिपोर्ट भी दी जाती है, जब वे निर्देशित सेटअप के लिए पुनः उपयोग योग्य इन्फ़रेंस रूट के रूप में काम नहीं कर सकते। Gemini और Antigravity टूल-मुक्त प्रोब लागू नहीं कर सकते; Pi और OpenCode सेटअप इन्फ़रेंस रूट के बजाय पूर्ण-एजेंट हार्नेस हैं।
3. पहले मिले उम्मीदवार को वास्तविक कम्प्लीशन से जाँचें। विफलता पर कारण दिखाएँ और अगले उपयोग योग्य उम्मीदवार पर जाएँ।
4. यदि पता लगाने की सभी संभावनाएँ समाप्त हो जाएँ, तो OpenAI, Anthropic, xAI (Grok), Google या OpenRouter चुनें अथवा शेष प्रोवाइडर के लिए More… चुनें। प्रत्येक प्रोवाइडर के क्षेत्र, प्लान और समर्थित ब्राउज़र, डिवाइस, API-कुंजी या टोकन विधियाँ दूसरे मेन्यू में दिखाई देती हैं और उसी वास्तविक कम्प्लीशन से जाँची जाती हैं। OpenClaw शुरू किए बिना बाहर निकलने के लिए Skip for now चुनें।
5. केवल सत्यापित मॉडल रूट और उसके लिए आवश्यक क्रेडेंशियल/प्लगइन स्थिति को स्थायी करें। वर्कस्पेस और Gateway सेटिंग अपरिवर्तित रहती हैं।
6. सत्यापित मॉडल के साथ OpenClaw शुरू करें, ताकि वह वर्कस्पेस, Gateway, चैनल, एजेंट, प्लगइन और शेष वैकल्पिक सेटअप कॉन्फ़िगर कर सके।

कॉन्फ़िगर किए गए इंस्टॉलेशन पर कमांड दोबारा चलाने से पहले मौजूदा डिफ़ॉल्ट मॉडल की जाँच होती है, जिससे निर्देशित प्रवाह सत्यापन और मरम्मत चरण बन जाता है। विफल जाँच कॉन्फ़िगर किए गए मॉडल को कभी अपने-आप नहीं बदलती; ऑनबोर्डिंग रुकती है और पूछती है कि आगे कैसे बढ़ना है। बाद में गैर-इन्फ़रेंस जोड़ने के लिए openclaw channels add या openclaw configure चलाएँ; प्रोवाइडर या प्रमाणीकरण रूट बदलने के लिए openclaw onboard उपयोग करें।

क्लासिक विज़ार्ड: QuickStart बनाम Advanced

पूरा विज़ार्ड खोलने के लिए openclaw onboard --classic चलाएँ। यह QuickStart (डिफ़ॉल्ट) और Advanced (पूर्ण नियंत्रण) के बीच विकल्प से शुरू होता है। क्लासिक प्रवाह चुनने और उस प्रॉम्प्ट को छोड़ने के लिए --flow quickstart या --flow advanced (उपनाम manual) पास करें।

रिमोट मोड (--mode remote) हमेशा उन्नत प्रवाह का उपयोग करता है; यह केवल इस मशीन को किसी अन्य स्थान के Gateway से कनेक्ट करने के लिए कॉन्फ़िगर करता है और रिमोट होस्ट पर कभी कुछ इंस्टॉल या परिवर्तित नहीं करता।

क्लासिक ऑनबोर्डिंग क्या कॉन्फ़िगर करती है

स्थानीय मोड (डिफ़ॉल्ट) इन चरणों से गुजरता है:

1. मॉडल/प्रमाणीकरण - प्रोवाइडर प्रमाणीकरण प्रवाह चुनें (API कुंजी, OAuth या प्रोवाइडर-विशिष्ट मैन्युअल प्रमाणीकरण), जिसमें कस्टम प्रोवाइडर (OpenAI-संगत, OpenAI Responses-संगत, Anthropic-संगत या अज्ञात स्वतः-पहचान) शामिल है। डिफ़ॉल्ट मॉडल चुनें। नया OpenAI API-कुंजी सेटअप डिफ़ॉल्ट रूप से openai/gpt-5.6 उपयोग करता है (सादा डायरेक्ट-API ID Sol पर रिज़ॉल्व होता है); नया ChatGPT/Codex सेटअप डिफ़ॉल्ट रूप से openai/gpt-5.6-sol उपयोग करता है। सेटअप दोबारा चलाने पर मौजूदा स्पष्ट मॉडल, जिसमें openai/gpt-5.5 भी शामिल है, संरक्षित रहता है। यदि अकाउंट GPT-5.6 उपलब्ध नहीं कराता, तो openai/gpt-5.5 स्पष्ट रूप से चुनें। सुरक्षा नोट: यदि यह एजेंट टूल चलाएगा या Webhook/हुक सामग्री संसाधित करेगा, तो उपलब्ध नवीनतम पीढ़ी के सबसे शक्तिशाली मॉडल को प्राथमिकता दें और टूल नीति कठोर रखें - कमज़ोर या पुराने स्तरों पर प्रॉम्प्ट इंजेक्शन करना अधिक आसान है। गैर-इंटरैक्टिव रन के लिए --secret-input-mode ref, प्लेनटेक्स्ट API कुंजी मानों के बजाय एनवायरनमेंट-समर्थित संदर्भ संग्रहीत करता है; संदर्भित एनवायरनमेंट वेरिएबल पहले से सेट होना चाहिए, अन्यथा ऑनबोर्डिंग तुरंत विफल हो जाती है। इंटरैक्टिव सीक्रेट संदर्भ मोड एनवायरनमेंट वेरिएबल या कॉन्फ़िगर किए गए प्रोवाइडर संदर्भ (file या exec) की ओर इंगित कर सकता है, जिसमें सहेजने से पहले त्वरित प्रारंभिक जाँच होती है। मॉडल/प्रमाणीकरण सेटअप के बाद, विज़ार्ड एक वैकल्पिक लाइव कम्प्लीशन परीक्षण प्रस्तुत करता है; विफलता पर एक बार मॉडल/प्रमाणीकरण सेटअप पर लौटा जा सकता है या शेष क्लासिक विज़ार्ड को रोके बिना उसे अनदेखा किया जा सकता है। इसे अनदेखा करने से OpenClaw अनलॉक नहीं होता; संवादात्मक सेटअप के लिए फिर भी सफल इन्फ़रेंस जाँच आवश्यक है।
2. वर्कस्पेस - एजेंट फ़ाइलों की डायरेक्टरी (डिफ़ॉल्ट ~/.openclaw/workspace)। बूटस्ट्रैप फ़ाइलें सीड करता है।
3. Gateway - पोर्ट, बाइंड पता, प्रमाणीकरण मोड, Tailscale एक्सपोज़र। इंटरैक्टिव टोकन मोड में प्लेनटेक्स्ट टोकन संग्रहण (डिफ़ॉल्ट) चुनें या SecretRef चुनें। गैर-इंटरैक्टिव SecretRef पथ: --gateway-token-ref-env <ENV_VAR>।
4. चैनल - अंतर्निर्मित और आधिकारिक प्लगइन चैट चैनल, जिनमें Discord, Feishu, Google Chat, iMessage, Mattermost, Microsoft Teams, QQ Bot, Signal, Slack, Telegram, WhatsApp और अन्य शामिल हैं।
5. डेमन - LaunchAgent (macOS), systemd उपयोगकर्ता यूनिट (Linux/WSL2) या प्रति-उपयोगकर्ता Startup-फ़ोल्डर फ़ॉलबैक वाली नेटिव Windows Scheduled Task इंस्टॉल करता है। यदि टोकन प्रमाणीकरण आवश्यक है और gateway.auth.token SecretRef द्वारा प्रबंधित है, तो डेमन इंस्टॉल उसका सत्यापन करता है, लेकिन रिज़ॉल्व किए गए टोकन को सुपरवाइज़र सेवा एनवायरनमेंट मेटाडेटा में स्थायी नहीं करता; अनरिज़ॉल्व्ड SecretRef मार्गदर्शन के साथ इंस्टॉलेशन रोक देता है। यदि gateway.auth.token और gateway.auth.password दोनों सेट हैं, जबकि gateway.auth.mode सेट नहीं है, तो मोड स्पष्ट रूप से सेट किए जाने तक इंस्टॉलेशन अवरुद्ध रहता है।
6. स्वास्थ्य जाँच - Gateway शुरू करती है और सत्यापित करती है कि उस तक पहुँचा जा सकता है।
7. स्किल - अनुशंसित स्किल और उनकी वैकल्पिक डिपेंडेंसी इंस्टॉल करती है।

--flow import नए सेटअप के बजाय क्लासिक विज़ार्ड में पता लगाया गया माइग्रेशन प्रवाह (उदाहरण के लिए Hermes) चलाता है; माइग्रेट और इंस्टॉल के अंतर्गत माइग्रेशन गाइड देखें। openclaw onboard --modern, OpenClaw का संगतता उपनाम है। यह openclaw setup वाला ही इन्फ़रेंस गेट उपयोग करता है: सत्यापित इन्फ़रेंस सहायक शुरू करता है, जबकि इंटरैक्टिव विफलता निर्देशित इन्फ़रेंस सेटअप पर वापस जाती है।

दूसरा एजेंट जोड़ें

अपने अलग वर्कस्पेस, सत्र और प्रमाणीकरण प्रोफ़ाइल वाला अलग एजेंट बनाने के लिए openclaw agents add <name> उपयोग करें। --workspace के बिना चलाने पर नाम, वर्कस्पेस, प्रमाणीकरण, चैनल और बाइंडिंग के लिए इंटरैक्टिव प्रवाह शुरू होता है - यह पूरा openclaw onboard विज़ार्ड नहीं है।

यह क्या सेट करता है:

• agents.entries.*.name
• agents.entries.*.workspace
• agents.entries.*.agentDir

नोट्स:

• डिफ़ॉल्ट वर्कस्पेस: ~/.openclaw/workspace-<agentId> (या यदि agents.defaults.workspace सेट है, तो उसके अंतर्गत)।
• आने वाले संदेश इस एजेंट को रूट करने के लिए bindings जोड़ें (ऑनबोर्डिंग आपके लिए यह कर सकती है)।
• गैर-इंटरैक्टिव फ़्लैग: --model, --agent-dir, --bind, --non-interactive।

पूर्ण संदर्भ

विस्तृत चरण-दर-चरण व्यवहार और कॉन्फ़िग आउटपुट के लिए CLI सेटअप संदर्भ देखें। गैर-इंटरैक्टिव उदाहरणों के लिए CLI ऑटोमेशन देखें। पूर्ण फ़्लैग संदर्भ के लिए openclaw onboard देखें।

संबंधित दस्तावेज़

• CLI कमांड संदर्भ: openclaw onboard
• ऑनबोर्डिंग का अवलोकन: ऑनबोर्डिंग का अवलोकन
• macOS ऐप ऑनबोर्डिंग: ऑनबोर्डिंग
• एजेंट का प्रथम-रन अनुष्ठान: एजेंट बूटस्ट्रैपिंग