---
read_when:
- आप इन्फ़रेंस स्थापित करना चाहते हैं, फिर OpenClaw के साथ सेटअप पूरा करना चाहते हैं
summary: '`openclaw onboard` (इंटरैक्टिव ऑनबोर्डिंग) के लिए CLI संदर्भ'
title: ऑनबोर्डिंग
x-i18n:
generated_at: "2026-07-27T17:52:00Z"
model: gpt-5.6
postprocess_version: locale-links-v1
prompt_version: 32
provider: openai
source_hash: 8ec5cfc564aa14041d1aa67a978a4661e6105b7119a942940f71197c695e788b
source_path: cli/onboard.md
workflow: 16
---
# `openclaw onboard`
निर्देशित सेटअप जो पहले इनफ़रेंस स्थापित करता है: यह मौजूदा AI पहुँच का पता लगाता है,
लाइव कम्प्लीशन आवश्यक बनाता है, केवल कार्यशील रूट को सहेजता है, और फिर शेष
कॉन्फ़िगर करने के लिए OpenClaw शुरू करता है। नए सिस्टम पर या जब भी कोई ऑनबोर्डिंग
विकल्प मौजूद हो, `openclaw setup` इस प्रवाह तक पहुँचता है; कॉन्फ़िगर किए गए सिस्टम
सिस्टम-एजेंट चैट के लिए केवल `openclaw setup` का उपयोग करते हैं। `openclaw setup --baseline`
केवल आधारभूत कॉन्फ़िगरेशन/वर्कस्पेस लिखता है।
इंटरैक्टिव CLI प्रवाह का चरण-दर-चरण विवरण।
OpenClaw ऑनबोर्डिंग के सभी भाग एक साथ कैसे काम करते हैं।
आउटपुट, आंतरिक कार्यप्रणाली और प्रत्येक चरण का व्यवहार।
गैर-इंटरैक्टिव फ़्लैग और स्क्रिप्टेड सेटअप।
macOS मेनू बार ऐप के लिए ऑनबोर्डिंग प्रवाह।
## उदाहरण
```bash
openclaw onboard
openclaw onboard --tui
openclaw onboard --classic
openclaw onboard --modern
openclaw onboard --flow quickstart
openclaw onboard --flow manual
openclaw onboard --flow import
openclaw onboard --import-from hermes --import-source ~/.hermes
openclaw onboard --skip-bootstrap
openclaw onboard recommendations --json
openclaw onboard recommendations acknowledge
openclaw onboard recommendations acknowledge --retry ""
openclaw onboard recommendations refresh
openclaw 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 संग्रहीत प्रस्ताव को बदले बिना विफल हो जाते हैं। बाधित 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`](/hi/cli/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 ` OpenClaw का प्रस्तावित वर्कस्पेस और पृथक
इनफ़रेंस संदर्भ प्रदान करता है। जब तक आप OpenClaw सेटअप प्रस्ताव को स्वीकृति नहीं
देते, तब तक इसे सहेजा नहीं जाता। क्लासिक और गैर-इंटरैक्टिव ऑनबोर्डिंग अपने
वर्कस्पेस को अपने सामान्य सेटअप प्रवाह के माध्यम से सहेजते हैं। मौजूदा एजेंट
रोस्टर के साथ पुनः रन करने पर, ऑनबोर्डिंग कॉन्फ़िगर किए गए फ़्लीट वर्कस्पेस को
सुरक्षित रखता है: क्लासिक विज़ार्ड दोनों पथ दिखाता है और उसे स्थानांतरित करने से
पहले स्पष्ट पुष्टि आवश्यक बनाता है, जबकि गैर-इंटरैक्टिव सेटअप चेतावनी देता है और
वर्तमान मान बनाए रखता है।
इनफ़रेंस पास होने के बाद, ऑनबोर्डिंग समर्थित स्थानीय AI टूल की मेमोरी की जाँच
करता है: Claude Code ऑटो-मेमोरी, Codex समेकित मेमोरी और Hermes मेमोरी फ़ाइलें।
कोई भी मिलने पर, एक पृष्ठ उन्हें अनुक्रमित पुनःस्मरण के लिए एजेंट वर्कस्पेस में
`memory/imports/` के अंतर्गत कॉपी करने की पेशकश करता है। पुष्टि के बिना कुछ भी
आयात नहीं किया जाता, पहले आयात की गई फ़ाइलें छोड़ दी जाती हैं, और आप बाद में
हमेशा Control UI के [मेमोरी आयात पृष्ठ](/hi/web/control-ui) से आयात कर सकते हैं,
जो समान केवल-मेमोरी दायरा प्रदान करता है। (पूर्ण
[`openclaw migrate`](/hi/cli/migrate) रन अधिक व्यापक है: यह कॉन्फ़िगरेशन, skills और
क्रेडेंशियल भी आयात कर सकता है।) क्लासिक विज़ार्ड वर्कस्पेस तैयार करने के बाद
समान पृष्ठ दिखाता है।
इनफ़रेंस पास होने (और मेमोरी-आयात प्रस्ताव) के बाद, निर्देशित ऑनबोर्डिंग मानक
सेटअप स्वचालित रूप से लागू करता है — वर्कस्पेस, Gateway और सत्र, वही योजना जिसे
संवादात्मक `openclaw setup` चैट "yes" पर लागू करती — फिर इंस्टॉल किए गए ऐप्स
से Plugin और skill अनुशंसाएँ प्रस्तुत करता है; ऐप नामों का मिलान आपके कॉन्फ़िगर
किए गए मॉडल और ClawHub खोज के माध्यम से किया जाता है, और इस चरण को
[`wizard.appRecommendations`](/hi/gateway/configuration-reference#wizard) से अक्षम किया जा
सकता है। macOS, Linux या Windows डेस्कटॉप सत्र में, यह फिर प्रमाणीकृत Control UI
डैशबोर्ड खोलता है और ब्राउज़र क्लाइंट के कनेक्ट होने के लिए अधिकतम 60 सेकंड तक
प्रतीक्षा करता है। हेडलेस Linux या SSH पर, यह एक प्रमुख, कॉपी-पेस्ट योग्य डैशबोर्ड
URL प्रिंट करता है, जिसमें लूपबैक Gateway के लिए SSH पोर्ट-फ़ॉरवर्ड कमांड शामिल
होता है, और अधिकतम पाँच मिनट प्रतीक्षा करता है। सफल कनेक्शन ब्राउज़र में जारी रहता
है; अगम्य Gateway या टाइमआउट पहले की तरह उसी टर्मिनल निकास-विकल्प पर लौटता है।
ब्राउज़र हस्तांतरण छोड़ने और उस टर्मिनल निकास-विकल्प को बाध्य करने के लिए
`--tui` पास करें। यदि सेटअप लागू करना विफल हो जाता है, तो ऑनबोर्डिंग
इंटरैक्टिव रूप से पूरा करने के लिए संवादात्मक OpenClaw चैट पर लौटता है। चैनल,
एजेंट, plugins और अन्य वैकल्पिक सुविधाएँ OpenClaw चैट के क्षेत्र में रहती हैं:
`openclaw` चलाएँ और चैनल क्रेडेंशियल संग्रह को छिपे हुए टर्मिनल विज़ार्ड
को सौंपने के लिए `open channel wizard for ` का उपयोग करें। मॉडल प्रदाता या उसके प्रमाणीकरण
को बदलने के लिए, 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` सेट करें।
## रीसेट
```bash
openclaw onboard --reset
openclaw 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/चैनल लेबल अपरिवर्तित रहते हैं।
```bash
OPENCLAW_LOCALE=zh-CN openclaw onboard
OPENCLAW_LOCALE=en openclaw onboard # स्पष्ट अंग्रेज़ी ओवरराइड
```
## गैर-इंटरैक्टिव सेटअप
`--non-interactive` के लिए `--accept-risk` आवश्यक है (यह स्वीकार करता है कि एजेंट शक्तिशाली होते हैं और पूर्ण सिस्टम पहुँच जोखिमपूर्ण है)। `--mode` का डिफ़ॉल्ट `local` है।
```bash
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 में प्रदाता-विशिष्ट कुंजी फ़्लैग भी है:
```bash
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:
```bash
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 भी यहाँ काम करते हैं।
प्रदाता कुंजियों को सादे पाठ के बजाय संदर्भों के रूप में संग्रहीत करें:
```bash
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: }` लिखती है; कस्टम प्रदाताओं के लिए यह इसी तरह `models.providers..apiKey` लिखती है (उदाहरण के लिए `{ source: "env", provider: "default", id: "CUSTOM_API_KEY" }`)। अनुबंध: प्रदाता env चर को ऑनबोर्डिंग प्रक्रिया के परिवेश में सेट करें (उदाहरण के लिए `OPENAI_API_KEY`) और जब तक वह env चर सेट न हो, इनलाइन कुंजी फ़्लैग भी पास न करें—मेल खाने वाले env चर के बिना दिया गया फ़्लैग मान मार्गदर्शन के साथ तुरंत विफल हो जाता है।
### Gateway प्रमाणीकरण (गैर-इंटरैक्टिव)
- `--gateway-auth token --gateway-token ` एक सादा-पाठ टोकन संग्रहीत करता है। `token` डिफ़ॉल्ट प्रमाणीकरण मोड है।
- `--gateway-auth token --gateway-token-ref-env `, `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` छोड़ने की अनुमति नहीं देता।
```bash
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 एंडपॉइंट विकल्प
`--auth-choice zai-api-key` आपकी कुंजी के लिए सर्वोत्तम Z.AI एंडपॉइंट और मॉडल का स्वतः पता लगाता है: Coding Plan एंडपॉइंट `zai/glm-5.2` को प्राथमिकता देते हैं (अनुपलब्ध होने पर `glm-5.1` पर फ़ॉलबैक करते हैं); सामान्य API एंडपॉइंट का डिफ़ॉल्ट `zai/glm-5.1` है। Coding Plan एंडपॉइंट बाध्य करने के लिए सीधे `zai-coding-global` या `zai-coding-cn` चुनें।
```bash
# संकेत-रहित एंडपॉइंट चयन
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:
```bash
openclaw onboard --non-interactive \
--auth-choice mistral-api-key \
--mistral-api-key "$MISTRAL_API_KEY"
```
## अतिरिक्त गैर-इंटरैक्टिव फ़्लैग
टोकन-आधारित मॉडल प्रमाणीकरण (`--auth-choice token` के साथ उपयोग किया जाता है):
| फ़्लैग | विवरण |
| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `--token-provider ` | टोकन जारी करने वाले टोकन प्रदाता की ID |
| `--token ` | मॉडल प्रमाणीकरण के लिए टोकन मान |
| `--token-profile-id ` | प्रमाणीकरण प्रोफ़ाइल ID (डिफ़ॉल्ट `:manual`; कुछ प्रदाता-स्वामित्व वाले प्रवाह अपने डिफ़ॉल्ट का उपयोग करते हैं, जैसे `anthropic:default`) |
| `--token-expires-in ` | वैकल्पिक टोकन समाप्ति अवधि (जैसे `365d`, `12h`) |
Cloudflare AI Gateway: `--cloudflare-ai-gateway-account-id `, `--cloudflare-ai-gateway-gateway-id `।
डेमन स्थापना नियंत्रण: `--no-install-daemon` / `--skip-daemon` (उपनाम; Gateway सेवा स्थापना छोड़ें), `--daemon-runtime `।
Skills: `--node-manager ` (डिफ़ॉल्ट `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 में उपयोगी है।
`--json` निर्देशित या क्लासिक ऑनबोर्डिंग में गैर-इंटरैक्टिव मोड निहित नहीं करता।
`--modern` के साथ, JSON OpenClaw का एकबारगी अवलोकन है और उस
एकल परिणाम के बाद बाहर निकल जाता है। अन्य स्क्रिप्ट के लिए `--non-interactive` का उपयोग करें।
## प्रदाता पूर्व-फ़िल्टरिंग
जब कोई प्रमाणीकरण विकल्प पसंदीदा प्रदाता का संकेत देता है, तो ऑनबोर्डिंग डिफ़ॉल्ट-मॉडल और अनुमत-सूची चयनकर्ताओं को उस प्रदाता के मॉडलों तक पहले से फ़िल्टर करती है। फ़िल्टर उसी 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 सेटअप संदर्भ](/hi/start/wizard-cli-reference#outputs-and-internals)।
- सबसे तेज़ पहली चैट: `openclaw dashboard` (Control UI, कोई चैनल सेटअप नहीं)।
- कस्टम प्रदाता: सूचीबद्ध न किए गए होस्टेड प्रदाताओं सहित किसी भी OpenAI- या Anthropic-संगत एंडपॉइंट को कनेक्ट करें। लाइव जाँच द्वारा स्वतः पता लगाने के लिए **अज्ञात** संगतता का उपयोग करें।
- यदि Hermes स्थिति का पता चलता है, तो ऑनबोर्डिंग माइग्रेशन प्रवाह प्रस्तुत करती है (ऊपर `--flow import` देखें)।
## सामान्य अनुवर्ती कमांड
बाद में लक्षित गैर-अनुमानात्मक परिवर्तनों के लिए `openclaw configure` और केवल-चैनल सेटअप के लिए `openclaw
channels add` का उपयोग करें। मॉडल प्रदाता या प्रमाणीकरण मार्ग में परिवर्तन के लिए,
इसके बजाय `openclaw onboard` चलाएँ।
```bash
openclaw channels add
openclaw configure
openclaw agents add
```