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

openclaw onboard

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

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

कस्टम प्रदाताओं, रिमोट Gateway सेटअप, चैनल पेयरिंग, डेमन नियंत्रण, Skills और इम्पोर्ट के लिए क्लासिक विज़ार्ड उपलब्ध रहता है। इसे स्पष्ट रूप से 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 और Plugin/चैनल लेबल अंग्रेज़ी में ही रहते हैं।

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

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 चुनें, अथवा शेष प्रदाताओं के लिए और… चुनें। प्रत्येक प्रदाता के क्षेत्र, प्लान और समर्थित ब्राउज़र, डिवाइस, API-कुंजी या टोकन विधियाँ दूसरे मेनू में दिखाई देती हैं और उन्हें उसी वास्तविक कम्प्लीशन से जाँचा जाता है। OpenClaw शुरू किए बिना बाहर निकलने के लिए अभी छोड़ें चुनें।
5. केवल सत्यापित मॉडल मार्ग और उसके लिए आवश्यक क्रेडेंशियल/Plugin स्थिति को स्थायी बनाएँ। कार्यस्थान और Gateway सेटिंग अपरिवर्तित रहती हैं।
6. OpenClaw को सत्यापित मॉडल के साथ शुरू करें, ताकि वह कार्यस्थान, Gateway, चैनल, एजेंट, plugins और शेष वैकल्पिक सेटअप कॉन्फ़िगर कर सके।

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

क्लासिक विज़ार्ड: त्वरित शुरुआत बनाम उन्नत

पूरा विज़ार्ड खोलने के लिए openclaw onboard --classic चलाएँ। यह त्वरित शुरुआत (डिफ़ॉल्ट) और उन्नत (पूर्ण नियंत्रण) के बीच चयन से शुरू होता है। क्लासिक प्रवाह चुनने और उस संकेत को छोड़ने के लिए --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/hook सामग्री संसाधित करेगा, तो उपलब्ध सबसे शक्तिशाली नवीनतम-पीढ़ी के मॉडल को प्राथमिकता दें और टूल नीति सख्त रखें—कमज़ोर या पुराने स्तरों में प्रॉम्प्ट इंजेक्शन करना अधिक आसान है। गैर-इंटरैक्टिव संचालन के लिए, --secret-input-mode ref सादे-पाठ API कुंजी मानों के बजाय पर्यावरण-समर्थित संदर्भ संग्रहीत करता है; संदर्भित पर्यावरण चर पहले से सेट होना चाहिए, अन्यथा ऑनबोर्डिंग तुरंत विफल हो जाती है। इंटरैक्टिव रहस्य संदर्भ मोड किसी पर्यावरण चर या कॉन्फ़िगर किए गए प्रदाता संदर्भ (file या exec) की ओर संकेत कर सकता है और सहेजने से पहले त्वरित प्रारंभिक जाँच करता है। मॉडल/प्रमाणीकरण सेटअप के बाद विज़ार्ड वैकल्पिक लाइव कम्प्लीशन जाँच प्रस्तुत करता है; विफलता पर एक बार मॉडल/प्रमाणीकरण सेटअप पर वापस जाया जा सकता है या क्लासिक विज़ार्ड के शेष भाग को अवरुद्ध किए बिना उसे अनदेखा किया जा सकता है। उसे अनदेखा करने से OpenClaw अनलॉक नहीं होता; संवादात्मक सेटअप के लिए अब भी सफल इन्फ़रेंस जाँच आवश्यक है।
2. कार्यस्थान - एजेंट फ़ाइलों की डायरेक्टरी (डिफ़ॉल्ट ~/.openclaw/workspace)। बूटस्ट्रैप फ़ाइलें आरंभ करता है।
3. Gateway - पोर्ट, बाइंड पता, प्रमाणीकरण मोड, Tailscale एक्सपोज़र। इंटरैक्टिव टोकन मोड में सादे-पाठ टोकन संग्रहण (डिफ़ॉल्ट) चुनें या SecretRef का विकल्प चुनें। गैर-इंटरैक्टिव SecretRef पथ: --gateway-token-ref-env <ENV_VAR>।
4. चैनल - अंतर्निर्मित और आधिकारिक Plugin चैट चैनल, जिनमें 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. Skills - अनुशंसित Skills और उनकी वैकल्पिक निर्भरताएँ इंस्टॉल करती है।

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

एक और एजेंट जोड़ें

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

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

• agents.list[].name
• agents.list[].workspace
• agents.list[].agentDir

टिप्पणियाँ:

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

पूरा संदर्भ

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

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

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