Guides

CLI सेटअप संदर्भ

यह पृष्ठ चरण-दर-चरण ऑनबोर्डिंग व्यवहार, आउटपुट और आंतरिक कार्यप्रणाली को समेटता है। मार्गदर्शिका के लिए, ऑनबोर्डिंग (CLI) देखें। संपूर्ण CLI फ़्लैग संदर्भ (प्रत्येक --flag, गैर-इंटरैक्टिव उदाहरण, प्रदाता-विशिष्ट कमांड) के लिए, openclaw onboard देखें।

विज़ार्ड क्या करता है

स्थानीय मोड (डिफ़ॉल्ट) आपको इनके माध्यम से मार्गदर्शन करता है:

मॉडल और प्रमाणीकरण सेटअप (Anthropic, OpenAI Code सदस्यता OAuth, xAI, OpenCode, कस्टम एंडपॉइंट और प्रदाता के स्वामित्व वाले अन्य प्रमाणीकरण प्रवाह)
वर्कस्पेस का स्थान और बूटस्ट्रैप फ़ाइलें
Gateway सेटिंग्स (पोर्ट, बाइंड, प्रमाणीकरण, Tailscale)
चैनल और प्रदाता (Discord, Feishu, Google Chat, iMessage, Mattermost, Microsoft Teams, QQ Bot, Signal, Slack, Telegram, WhatsApp और अन्य बंडल किए गए या Plugin चैनल)
वेब खोज प्रदाता (वैकल्पिक)
डेमन इंस्टॉलेशन (LaunchAgent, systemd उपयोगकर्ता यूनिट या Startup-फ़ोल्डर फ़ॉलबैक वाला मूल Windows Scheduled Task)
स्वास्थ्य जाँच
Skills सेटअप

रिमोट मोड इस मशीन को कहीं और स्थित Gateway से कनेक्ट होने के लिए कॉन्फ़िगर करता है। यह रिमोट होस्ट पर कुछ भी इंस्टॉल या संशोधित नहीं करता।

स्थानीय प्रवाह का विवरण

मौजूदा कॉन्फ़िगरेशन का पता लगाना

यदि ~/.openclaw/openclaw.json मौजूद है, तो वर्तमान मान बनाए रखें, समीक्षा करके अपडेट करें, या सेटअप से पहले रीसेट करें चुनें।
विज़ार्ड को दोबारा चलाने पर कुछ भी नहीं मिटता, जब तक कि आप स्पष्ट रूप से Reset न चुनें (या --reset न दें)।
CLI --reset का डिफ़ॉल्ट config+creds+sessions है; वर्कस्पेस को भी हटाने के लिए --reset-scope full का उपयोग करें।
यदि कॉन्फ़िगरेशन अमान्य है या उसमें पुराने कुंजी-नाम हैं, तो विज़ार्ड रुक जाता है और आगे बढ़ने से पहले openclaw doctor चलाने को कहता है।
Reset स्थिति को Trash में ले जाता है (कभी सीधे नहीं मिटाता) और ये दायरे प्रदान करता है:
- केवल कॉन्फ़िगरेशन
- कॉन्फ़िगरेशन + क्रेडेंशियल + सत्र
- पूर्ण रीसेट (वर्कस्पेस भी हटाता है)

मॉडल और प्रमाणीकरण

विकल्पों की पूरी मैट्रिक्स प्रमाणीकरण और मॉडल विकल्प में है।

वर्कस्पेस

डिफ़ॉल्ट ~/.openclaw/workspace (कॉन्फ़िगर करने योग्य)।
पहली बार चलाने के बूटस्ट्रैप के लिए आवश्यक वर्कस्पेस फ़ाइलें तैयार करता है।
वर्कस्पेस की संरचना: एजेंट वर्कस्पेस।

Gateway

पोर्ट, बाइंड, प्रमाणीकरण मोड और Tailscale एक्सपोज़र के लिए संकेत देता है।
अनुशंसित: लूपबैक के लिए भी टोकन प्रमाणीकरण सक्षम रखें, ताकि स्थानीय WS क्लाइंट को प्रमाणीकरण करना आवश्यक हो।
टोकन मोड में, इंटरैक्टिव सेटअप ये विकल्प देता है:
- प्लेनटेक्स्ट टोकन जनरेट/संग्रहीत करें (डिफ़ॉल्ट)
- SecretRef का उपयोग करें (वैकल्पिक चयन)
पासवर्ड मोड में, इंटरैक्टिव सेटअप प्लेनटेक्स्ट या SecretRef संग्रहण का भी समर्थन करता है।
गैर-इंटरैक्टिव टोकन SecretRef पथ: --gateway-token-ref-env <ENV_VAR>।
- ऑनबोर्डिंग प्रक्रिया के परिवेश में एक गैर-रिक्त परिवेश चर आवश्यक है।
- इसे --gateway-token के साथ संयोजित नहीं किया जा सकता।
प्रमाणीकरण केवल तभी अक्षम करें, जब आप प्रत्येक स्थानीय प्रक्रिया पर पूर्ण विश्वास करते हों।
गैर-लूपबैक बाइंड के लिए फिर भी प्रमाणीकरण आवश्यक है।

चैनल

WhatsApp: वैकल्पिक QR लॉगिन
Telegram: बॉट टोकन
Discord: बॉट टोकन
Google Chat: सेवा खाता JSON + Webhook ऑडियंस
Mattermost: बॉट टोकन + बेस URL
Signal: वैकल्पिक signal-cli इंस्टॉलेशन + खाता कॉन्फ़िगरेशन
iMessage: imsg CLI पथ + Messages DB एक्सेस; जब Gateway Mac से अलग स्थान पर चलता हो, तो SSH रैपर का उपयोग करें
DM सुरक्षा: डिफ़ॉल्ट पेयरिंग है। पहला DM एक कोड भेजता है; इसे openclaw pairing approve <channel> <code> के माध्यम से स्वीकृत करें या अनुमति-सूचियों का उपयोग करें।

वेब खोज

कोई प्रदाता चुनें (Brave, DuckDuckGo, Exa, Firecrawl, Gemini, Grok, Kimi, MiniMax Search, Ollama Web Search, Perplexity, SearXNG, Tavily) या छोड़ दें।
इस चरण को --skip-search से छोड़ें; बाद में openclaw configure --section web से दोबारा कॉन्फ़िगर करें।

डेमन इंस्टॉलेशन

macOS: LaunchAgent
- लॉग-इन उपयोगकर्ता सत्र आवश्यक है; हेडलेस उपयोग के लिए, कस्टम LaunchDaemon का उपयोग करें (साथ में उपलब्ध नहीं कराया जाता)।
Linux और WSL2 के माध्यम से Windows: systemd उपयोगकर्ता यूनिट
- विज़ार्ड loginctl enable-linger <user> का प्रयास करता है, ताकि लॉगआउट के बाद भी Gateway चलता रहे।
- यह sudo के लिए पूछ सकता है (/var/lib/systemd/linger लिखता है); पहले sudo के बिना प्रयास करता है।
मूल Windows: पहले Scheduled Task
- यदि टास्क बनाने की अनुमति नहीं मिलती, तो OpenClaw प्रति-उपयोगकर्ता Startup-फ़ोल्डर लॉगिन आइटम का फ़ॉलबैक उपयोग करता है और Gateway को तुरंत शुरू कर देता है।
- Scheduled Tasks को प्राथमिकता दी जाती है, क्योंकि वे बेहतर सुपरवाइज़र स्थिति प्रदान करते हैं।
रनटाइम चयन: Node आवश्यक है, क्योंकि OpenClaw का मानक रनटाइम स्थिति संग्रह node:sqlite का उपयोग करता है।

स्वास्थ्य जाँच

Gateway को शुरू करता है (यदि आवश्यक हो) और openclaw health चलाता है।
openclaw status --deep स्थिति आउटपुट में सक्रिय Gateway स्वास्थ्य जाँच जोड़ता है, जिसमें समर्थित होने पर चैनल जाँच भी शामिल होती हैं।

Skills

उपलब्ध Skills को पढ़ता है और आवश्यकताओं की जाँच करता है।
आपको Node प्रबंधक चुनने देता है: npm, pnpm, या bun।
आवश्यक इंस्टॉलर उपलब्ध होने पर विश्वसनीय बंडल किए गए Skills के लिए वैकल्पिक निर्भरताएँ इंस्टॉल करता है।
अनुपलब्ध Homebrew, uv और Go इंस्टॉलर को छोड़ देता है, फिर प्रभावित Skills को मैन्युअल सेटअप मार्गदर्शन के साथ समूहित करता है। अनुपलब्ध पूर्वापेक्षाएँ इंस्टॉल करने के बाद openclaw doctor चलाएँ।

समापन

सारांश और अगले चरण, जिनमें iOS, Android और macOS ऐप विकल्प शामिल हैं।

रिमोट मोड का विवरण

आप ये निर्धारित करते हैं:

रिमोट Gateway URL (ws://... या wss://...)
रिमोट Gateway के कॉन्फ़िगरेशन से मेल खाता टोकन, पासवर्ड या बिना प्रमाणीकरण का विकल्प

खोज (वैकल्पिक)

यदि dns-sd (macOS) या avahi-browse (Linux) उपलब्ध है, तो ऑनबोर्डिंग मैन्युअल URL प्रविष्टि पर जाने से पहले Bonjour/mDNS Gateway बीकन खोजने का विकल्प देता है। कॉन्फ़िगर होने पर विस्तृत-क्षेत्र DNS-SD खोज का भी प्रयास किया जाता है। दस्तावेज़: Gateway खोज, Bonjour।

कनेक्शन विधि

बीकन चुने जाने पर, प्रत्यक्ष WebSocket या SSH टनल चुनें:

प्रत्यक्ष: wss:// पर कनेक्ट होता है और खोजे गए TLS फ़िंगरप्रिंट पर विश्वास करने को कहता है (पहले उपयोग पर विश्वास के आधार पर पिनिंग; केवल आपकी स्वीकृति पर पिन किया जाता है)।
SSH टनल: पहले चलाने के लिए एक ssh -N -L 18789:127.0.0.1:18789 <user>@<host> कमांड दिखाता है, फिर स्थानीय टनल एंडपॉइंट से कनेक्ट होता है।

प्रमाणीकरण

टोकन (अनुशंसित), पासवर्ड या बिना प्रमाणीकरण का विकल्प चुनें, फिर वैकल्पिक रूप से इसे प्लेनटेक्स्ट के बजाय SecretRef के रूप में संग्रहीत करें।

प्रमाणीकरण और मॉडल विकल्प

यदि इंटरैक्टिव ऑनबोर्डिंग में प्रदाता सेटअप चरण विफल हो जाता है (उदाहरण के लिए, स्थानीय साइन-इन के बिना CLI पुनः उपयोग विकल्प), तो विज़ार्ड बाहर निकलने के बजाय त्रुटि दिखाता है और प्रदाता चयनकर्ता पर वापस चला जाता है। स्पष्ट --auth-choice रन अब भी स्वचालन के लिए तुरंत विफल होते हैं।

Anthropic API कुंजी

यदि ANTHROPIC_API_KEY मौजूद है, तो उसका उपयोग करता है; अन्यथा कुंजी माँगता है, फिर उसे डेमन उपयोग के लिए सहेजता है।

Anthropic Claude CLI

इंटरैक्टिव ऑनबोर्डिंग/कॉन्फ़िगरेशन में पसंदीदा स्थानीय पथ; उपलब्ध होने पर मौजूदा Claude CLI साइन-इन का पुनः उपयोग करता है।

OpenAI Code सदस्यता (OAuth)

ब्राउज़र प्रवाह; code#state चिपकाएँ।

प्राथमिक मॉडल के बिना नए सेटअप में, Codex रनटाइम के माध्यम से agents.defaults.model को openai/gpt-5.6-sol पर सेट करता है।

OpenAI Code सदस्यता (डिवाइस पेयरिंग)

अल्पकालिक डिवाइस कोड वाला ब्राउज़र पेयरिंग प्रवाह।

OpenAI API कुंजी

यदि OPENAI_API_KEY मौजूद है, तो उसका उपयोग करता है; अन्यथा कुंजी माँगता है, फिर क्रेडेंशियल को प्रमाणीकरण प्रोफ़ाइल में संग्रहीत करता है।

प्राथमिक मॉडल के बिना नए सेटअप में, agents.defaults.model को openai/gpt-5.6 पर सेट करता है; बिना उपसर्ग वाली प्रत्यक्ष-API मॉडल ID, Sol टियर पर रिज़ॉल्व होती है।

OpenAI को जोड़ने या दोबारा प्रमाणित करने पर मौजूदा स्पष्ट प्राथमिक मॉडल सुरक्षित रहता है, जिसमें openai/gpt-5.5 शामिल है। यदि खाते में GPT-5.6 उपलब्ध नहीं है, तो openai/gpt-5.5 को स्पष्ट रूप से चुनें; OpenClaw इसे चुपचाप निम्न संस्करण पर नहीं ले जाता।

xAI (Grok) OAuth

योग्य SuperGrok या X Premium खातों के लिए ब्राउज़र साइन-इन। अधिकांश उपयोगकर्ताओं के लिए यह अनुशंसित xAI मार्ग है। OpenClaw, Grok मॉडल, Grok web_search, x_search, और code_execution के लिए परिणामी प्रमाणीकरण प्रोफ़ाइल संग्रहीत करता है।

xAI (Grok) डिवाइस कोड

localhost कॉलबैक के बजाय छोटे कोड वाला, रिमोट के अनुकूल ब्राउज़र साइन-इन। इसका उपयोग SSH, Docker, या VPS होस्ट से करें।

xAI (Grok) API कुंजी

XAI_API_KEY के लिए संकेत देता है और xAI को मॉडल प्रदाता के रूप में कॉन्फ़िगर करता है। इसका उपयोग तब करें जब सदस्यता OAuth के बजाय xAI Console API कुंजी चाहिए।

OpenCode

OPENCODE_API_KEY (या OPENCODE_ZEN_API_KEY) के लिए संकेत देता है और Zen या Go कैटलॉग चुनने देता है (एक API कुंजी दोनों के लिए पर्याप्त है)। सेटअप URL: opencode.ai/auth।

API कुंजी (सामान्य)

कुंजी आपके लिए संग्रहीत करता है।

Vercel AI Gateway

AI_GATEWAY_API_KEY के लिए संकेत देता है। अधिक विवरण: Vercel AI Gateway।

Cloudflare AI Gateway

खाता ID, Gateway ID, और CLOUDFLARE_AI_GATEWAY_API_KEY के लिए संकेत देता है। अधिक विवरण: Cloudflare AI Gateway।

MiniMax

कॉन्फ़िगरेशन स्वतः लिखा जाता है। होस्टेड डिफ़ॉल्ट MiniMax-M3 है; API-कुंजी सेटअप minimax/... का उपयोग करता है, और OAuth सेटअप minimax-portal/... का उपयोग करता है। अधिक विवरण: MiniMax।

StepFun

चीन या वैश्विक एंडपॉइंट पर StepFun मानक या Step Plan के लिए कॉन्फ़िगरेशन स्वतः लिखा जाता है। मानक में अभी step-3.5-flash शामिल है, और Step Plan में step-3.5-flash-2603 भी शामिल है। अधिक विवरण: StepFun।

Synthetic (Anthropic-संगत)

SYNTHETIC_API_KEY के लिए संकेत देता है। अधिक विवरण: Synthetic।

Ollama (क्लाउड और स्थानीय खुले मॉडल)

पहले Cloud + Local, Cloud only, या Local only के लिए संकेत देता है। Cloud only, https://ollama.com के साथ OLLAMA_API_KEY का उपयोग करता है। होस्ट-समर्थित मोड आधार URL (डिफ़ॉल्ट http://127.0.0.1:11434) के लिए संकेत देते हैं, उपलब्ध मॉडल खोजते हैं, और डिफ़ॉल्ट सुझाते हैं। Cloud + Local यह भी जाँचता है कि वह Ollama होस्ट क्लाउड पहुँच के लिए साइन इन है या नहीं। अधिक विवरण: Ollama।

Moonshot और Kimi Coding

Moonshot (Kimi K2) और Kimi Coding के कॉन्फ़िगरेशन स्वतः लिखे जाते हैं। अधिक विवरण: Moonshot AI (Kimi + Kimi Coding)।

कस्टम प्रदाता

OpenAI-संगत, OpenAI Responses-संगत, और Anthropic-संगत एंडपॉइंट के साथ काम करता है।

इंटरैक्टिव ऑनबोर्डिंग अन्य प्रदाता API कुंजी प्रवाहों जैसे ही API कुंजी भंडारण विकल्पों का समर्थन करती है:

API कुंजी अभी पेस्ट करें (सादा पाठ)
गोपनीय संदर्भ का उपयोग करें (परिवेश संदर्भ या कॉन्फ़िगर किया गया प्रदाता संदर्भ, पूर्व-जाँच सत्यापन सहित)

ऑनबोर्डिंग सामान्य विज़न मॉडल ID (GPT-4o/4.1/5.x, Claude 3/4, Gemini, Qwen-VL, LLaVA, Pixtral, और समान) के लिए छवि समर्थन का अनुमान लगाती है और केवल मॉडल का नाम अज्ञात होने पर पूछती है।

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

--auth-choice custom-api-key
--custom-base-url
--custom-model-id
--custom-api-key (वैकल्पिक; उपलब्ध न होने पर CUSTOM_API_KEY का उपयोग)
--custom-provider-id (वैकल्पिक)
--custom-compatibility <openai|openai-responses|anthropic> (वैकल्पिक; डिफ़ॉल्ट openai)
--custom-image-input / --custom-text-input (वैकल्पिक; अनुमानित मॉडल इनपुट क्षमता को ओवरराइड करता है)

छोड़ें

प्रमाणीकरण को बिना कॉन्फ़िगर किए छोड़ देता है।

मॉडल व्यवहार:

पहचाने गए विकल्पों में से डिफ़ॉल्ट मॉडल चुनें, या प्रदाता और मॉडल मैन्युअल रूप से दर्ज करें।
जब ऑनबोर्डिंग किसी प्रदाता प्रमाणीकरण विकल्प से शुरू होती है, तो मॉडल चयनकर्ता स्वचालित रूप से उस प्रदाता को प्राथमिकता देता है। Volcengine और BytePlus के लिए, यही प्राथमिकता उनके कोडिंग-प्लान प्रकारों (volcengine-plan/*, byteplus-plan/*) से भी मेल खाती है।
यदि उस पसंदीदा-प्रदाता फ़िल्टर से कोई परिणाम नहीं मिलता, तो कोई मॉडल न दिखाने के बजाय चयनकर्ता पूर्ण कैटलॉग पर वापस जाता है।
विज़ार्ड मॉडल जाँच चलाता है और कॉन्फ़िगर किया गया मॉडल अज्ञात होने या उसका प्रमाणीकरण अनुपलब्ध होने पर चेतावनी देता है।

क्रेडेंशियल और प्रोफ़ाइल पथ:

प्रमाणीकरण प्रोफ़ाइल (API कुंजियाँ + OAuth): ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
लेगेसी OAuth आयात: ~/.openclaw/credentials/oauth.json

क्रेडेंशियल भंडारण मोड:

डिफ़ॉल्ट ऑनबोर्डिंग व्यवहार API कुंजियों को प्रमाणीकरण प्रोफ़ाइल में सादा-पाठ मानों के रूप में स्थायी रूप से सहेजता है।
--secret-input-mode ref सादा-पाठ कुंजी भंडारण के बजाय संदर्भ मोड सक्षम करता है। इंटरैक्टिव सेटअप में, इनमें से कोई भी चुना जा सकता है:
- परिवेश चर संदर्भ (उदाहरण के लिए keyRef: { source: "env", provider: "default", id: "OPENAI_API_KEY" })
- प्रदाता उपनाम + ID वाला कॉन्फ़िगर किया गया प्रदाता संदर्भ (file या exec)
इंटरैक्टिव संदर्भ मोड सहेजने से पहले तेज़ पूर्व-जाँच सत्यापन चलाता है।
- परिवेश संदर्भ: वर्तमान ऑनबोर्डिंग परिवेश में चर नाम + गैर-रिक्त मान सत्यापित करता है।
- प्रदाता संदर्भ: प्रदाता कॉन्फ़िगरेशन सत्यापित करता है और अनुरोधित ID का समाधान करता है।
- पूर्व-जाँच विफल होने पर, ऑनबोर्डिंग त्रुटि दिखाती है और पुनः प्रयास करने देती है।
गैर-इंटरैक्टिव मोड में, --secret-input-mode ref केवल परिवेश-समर्थित है।
- ऑनबोर्डिंग प्रक्रिया परिवेश में प्रदाता का परिवेश चर सेट करें।
- इनलाइन कुंजी फ़्लैग (उदाहरण के लिए --openai-api-key) के लिए वह परिवेश चर सेट होना आवश्यक है; अन्यथा ऑनबोर्डिंग तुरंत विफल हो जाती है।
- कस्टम प्रदाताओं के लिए, गैर-इंटरैक्टिव ref मोड models.providers.<id>.apiKey को { source: "env", provider: "default", id: "CUSTOM_API_KEY" } के रूप में संग्रहीत करता है।
- उस कस्टम-प्रदाता स्थिति में, --custom-api-key के लिए CUSTOM_API_KEY सेट होना आवश्यक है; अन्यथा ऑनबोर्डिंग तुरंत विफल हो जाती है।
Gateway प्रमाणीकरण क्रेडेंशियल इंटरैक्टिव सेटअप में सादा-पाठ और SecretRef विकल्पों का समर्थन करते हैं:
- टोकन मोड: सादा-पाठ टोकन जनरेट/संग्रहीत करें (डिफ़ॉल्ट) या SecretRef का उपयोग करें।
- पासवर्ड मोड: सादा पाठ या SecretRef।
गैर-इंटरैक्टिव टोकन SecretRef पथ: --gateway-token-ref-env <ENV_VAR>।
मौजूदा सादा-पाठ सेटअप बिना किसी बदलाव के काम करते रहते हैं।

आउटपुट और आंतरिक विवरण

~/.openclaw/openclaw.json में सामान्य फ़ील्ड:

agents.defaults.workspace
--skip-bootstrap दिए जाने पर agents.defaults.skipBootstrap
agents.defaults.model / models.providers (यदि Minimax चुना गया हो)
tools.profile (सेट न होने पर स्थानीय ऑनबोर्डिंग डिफ़ॉल्ट रूप से "coding" का उपयोग करती है; मौजूदा स्पष्ट मान सुरक्षित रखे जाते हैं)
gateway.* (मोड, बाइंड, प्रमाणीकरण, tailscale)
session.dmScope (ऑनबोर्डिंग स्पष्ट मान सुरक्षित रखती है और अन्यथा इसे सेट नहीं करती, ताकि main डिफ़ॉल्ट सभी चैनलों के प्रत्यक्ष संदेशों को एजेंट के क्रमिक मुख्य सत्र में रखे—यह व्यक्तिगत-एजेंट डिफ़ॉल्ट है। साझा या बहु-उपयोगकर्ता इनबॉक्स के लिए, per-channel-peer का उपयोग करें; बहु-उपयोगकर्ता DM ट्रैफ़िक का पता चलने पर openclaw security audit पृथक्करण की अनुशंसा करता है)
channels.telegram.botToken, channels.discord.token, channels.matrix.*, channels.signal.*, channels.imessage.*
संकेतों के दौरान सहमति देने पर चैनल अनुमति-सूचियाँ (Discord, iMessage, Signal, Slack, Telegram, WhatsApp); Discord और Slack दर्ज किए गए नामों को ID में भी परिवर्तित करते हैं
skills.install.nodeManager
- setup --node-manager फ़्लैग npm, pnpm, या bun स्वीकार करता है।
- मैन्युअल कॉन्फ़िगरेशन बाद में भी skills.install.nodeManager: "yarn" सेट कर सकता है।
wizard.lastRunAt
wizard.lastRunVersion
wizard.lastRunCommit
wizard.lastRunCommand
wizard.lastRunMode
wizard.securityAcknowledgedAt

openclaw agents add, agents.list[] और वैकल्पिक bindings लिखता है।

WhatsApp क्रेडेंशियल ~/.openclaw/credentials/whatsapp/<accountId>/ के अंतर्गत जाते हैं। सक्रिय सत्र और ट्रांसक्रिप्ट ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite में संग्रहीत होते हैं। ~/.openclaw/agents/<agentId>/sessions/ निर्देशिका का उपयोग लेगेसी माइग्रेशन इनपुट और संग्रह/समर्थन आर्टिफ़ैक्ट के लिए किया जाता है।

इंस्टॉल किए गए ऐप की अनुशंसाएँ

मॉडल पहुँच जाँच सफल होने के बाद, macOS पर क्लासिक इंटरैक्टिव ऑनबोर्डिंग macOS गोपनीयता अनुमतियाँ माँगे बिना एप्लिकेशन नाम और बंडल ID स्कैन करती है। यह आधिकारिक plugin कैटलॉग और ClawHub में खोज करती है, फिर कॉन्फ़िगर किए गए मॉडल से नामों के गलत मिलान अस्वीकार करने और प्रासंगिक plugins या skills की अनुशंसा करने को कहती है। अनुशंसित मिलान डिफ़ॉल्ट रूप से चुने जाते हैं; वैकल्पिक मिलान के लिए स्पष्ट चयन आवश्यक है।

परिणाम स्क्रीन पहचाने गए एप्लिकेशन सूचीबद्ध करती है और दिखाती है: "ऐप नामों का मिलान आपके कॉन्फ़िगर किए गए मॉडल और ClawHub खोज का उपयोग करके किया गया।" इस ऑनबोर्डिंग चरण और Node ऐप इन्वेंटरी तक Gateway की पहुँच, दोनों को अक्षम करने के लिए wizard.appRecommendations को false पर सेट करें। स्कैन का उपयोग क्विकस्टार्ट या गैर-macOS ऑनबोर्डिंग में नहीं किया जाता।

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

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

bash

openclaw onboard --non-interactive --accept-risk \  --auth-choice apiKey \  --anthropic-api-key "$ANTHROPIC_API_KEY"

पूर्ण फ़्लैग संदर्भ और प्रदाता-विशिष्ट उदाहरण: openclaw onboard, CLI स्वचालन।

Gateway विज़ार्ड RPC

wizard.start
wizard.next
wizard.cancel
wizard.status

क्लाइंट (macOS ऐप और Control UI) ऑनबोर्डिंग तर्क को दोबारा लागू किए बिना चरण रेंडर कर सकते हैं।

Signal सेटअप व्यवहार

आधिकारिक signal-cli GitHub रिलीज़ से उपयुक्त रिलीज़ एसेट डाउनलोड करता है (नेटिव बिल्ड, केवल Linux x86-64)
अन्य प्लेटफ़ॉर्म (macOS, गैर-x64 Linux) पर इसके बजाय Homebrew से इंस्टॉल करता है
रिलीज़-एसेट इंस्टॉलेशन को ~/.openclaw/tools/signal-cli/<version>/ के अंतर्गत संग्रहीत करता है
कॉन्फ़िगरेशन में channels.signal.cliPath लिखता है
नेटिव Windows अभी समर्थित नहीं है; Linux इंस्टॉलेशन पथ पाने के लिए WSL2 के भीतर ऑनबोर्डिंग चलाएँ