FAQ: पहली बार का सेटअप

ऐसे स्थानीय AI एजेंट का उपयोग करें जो आपकी मशीन देख सकता हो। "मैं अटक गया हूँ" वाले अधिकतर मामले स्थानीय कॉन्फ़िगरेशन या परिवेश की समस्याएँ होते हैं, जिनकी कोई दूरस्थ सहायक जाँच नहीं कर सकता, इसलिए यह Discord पर पूछने से बेहतर है।

• Claude Code: https://www.anthropic.com/claude-code/
• OpenAI Codex: https://openai.com/codex/

एजेंट को संशोधन-योग्य (git) इंस्टॉलेशन के माध्यम से पूरा स्रोत चेकआउट दें, ताकि वह कोड + दस्तावेज़ पढ़ सके और आपके द्वारा चलाए जा रहे सटीक संस्करण का विश्लेषण कर सके:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

एजेंट से समाधान की चरण-दर-चरण योजना बनाने और उसकी निगरानी करने को कहें, फिर केवल आवश्यक कमांड चलाएँ - छोटे अंतर की जाँच करना अधिक आसान होता है।

सहायता माँगते समय (Discord या GitHub समस्या में) ये आउटपुट साझा करें:

कोई वास्तविक बग या समाधान मिला? समस्या दर्ज करें या PR भेजें: समस्याएँ / पुल रिक्वेस्ट।

त्वरित डीबग चक्र: कुछ खराब होने पर पहले 60 सेकंड। इंस्टॉलेशन दस्तावेज़: इंस्टॉल करें, इंस्टॉलर फ़्लैग, अपडेट करना।

पुराने Heartbeat tasks: ब्लॉक, openclaw doctor --fix के साथ स्वतंत्र रूप से निर्धारित Cron कार्यों में माइग्रेट हो जाते हैं।

दस्तावेज़: Heartbeat, स्वचालन।

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bashopenclaw onboard --install-daemon

स्रोत से (योगदानकर्ताओं/डेवलपर के लिए):

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm buildpnpm ui:buildopenclaw onboard

अभी तक वैश्विक इंस्टॉलेशन नहीं है? इसके बजाय pnpm openclaw onboard चलाएँ। यदि Control UI एसेट उपलब्ध नहीं हैं, तो ऑनबोर्डिंग उन्हें स्वयं बनाने की कोशिश करती है और विफल होने पर pnpm ui:build का उपयोग करती है।

सेटअप के तुरंत बाद ऑनबोर्डिंग आपके ब्राउज़र में एक साफ़ (बिना टोकन वाला) डैशबोर्ड URL खोलती है और सारांश में लिंक दिखाती है। उस टैब को खुला रखें; यदि वह नहीं खुला, तो दिखाई गई URL को उसी मशीन पर कॉपी/पेस्ट करें।

Localhost (वही मशीन):

• http://127.0.0.1:18789/ खोलें।
• यदि यह साझा-गुप्त प्रमाणीकरण माँगे, तो कॉन्फ़िगर किया गया टोकन या पासवर्ड Control UI सेटिंग में चिपकाएँ।
• टोकन स्रोत: gateway.auth.token (या OPENCLAW_GATEWAY_TOKEN)।
• पासवर्ड स्रोत: gateway.auth.password (या OPENCLAW_GATEWAY_PASSWORD)।
• अभी तक कोई साझा गुप्त मान कॉन्फ़िगर नहीं है? openclaw doctor --generate-gateway-token (या openclaw doctor --fix --generate-gateway-token) चलाएँ।

Localhost पर नहीं:

• Tailscale Serve (अनुशंसित): बाइंड को लूपबैक पर रखें, openclaw gateway --tailscale serve चलाएँ, https://<magicdns>/ खोलें। gateway.auth.allowTailscale: true के साथ, पहचान हेडर Control UI/WebSocket प्रमाणीकरण को पूरा करते हैं (साझा गुप्त मान चिपकाने की आवश्यकता नहीं, एक विश्वसनीय Gateway होस्ट माना जाता है); HTTP API को फिर भी साझा-गुप्त प्रमाणीकरण चाहिए, जब तक कि आप जानबूझकर निजी-प्रवेश none या विश्वसनीय-प्रॉक्सी HTTP प्रमाणीकरण का उपयोग न करें। एक ही क्लाइंट से एक साथ होने वाले गलत-प्रमाणीकरण Serve प्रयासों को विफल-प्रमाणीकरण सीमाकर्ता द्वारा दर्ज किए जाने से पहले क्रमबद्ध किया जाता है, इसलिए दूसरी गलत पुनः कोशिश पहले ही retry later दिखा सकती है।
• Tailnet bind: openclaw gateway --bind tailnet --token "<token>" चलाएँ (या पासवर्ड प्रमाणीकरण कॉन्फ़िगर करें), http://<tailscale-ip>:18789/ खोलें और डैशबोर्ड सेटिंग में मेल खाता साझा गुप्त मान चिपकाएँ।
• पहचान-सजग रिवर्स प्रॉक्सी: Gateway को किसी विश्वसनीय प्रॉक्सी के पीछे रखें, gateway.auth.mode: "trusted-proxy" सेट करें और प्रॉक्सी URL खोलें। समान-होस्ट लूपबैक प्रॉक्सी के लिए स्पष्ट gateway.auth.trustedProxy.allowLoopback: true आवश्यक है।
• SSH टनल: ssh -N -L 18789:127.0.0.1:18789 user@gateway-host, फिर http://127.0.0.1:18789/ खोलें। टनल पर भी साझा-गुप्त प्रमाणीकरण लागू होता है; पूछे जाने पर कॉन्फ़िगर किया गया टोकन या पासवर्ड चिपकाएँ।

बाइंड मोड और प्रमाणीकरण के विवरण के लिए डैशबोर्ड और वेब सतहें देखें।

वे अलग-अलग परतों को नियंत्रित करते हैं:

• approvals.exec - अनुमोदन संकेतों को चैट गंतव्यों पर अग्रेषित करता है।
• channels.<channel>.execApprovals - उस चैनल को exec अनुमोदनों के लिए मूल अनुमोदन क्लाइंट बनाता है।

होस्ट की exec नीति ही वास्तविक अनुमोदन द्वार रहती है; चैट कॉन्फ़िगरेशन केवल यह नियंत्रित करता है कि संकेत कहाँ दिखाई दें और लोग उनका उत्तर कैसे दें।

आपको दोनों की आवश्यकता शायद ही कभी होती है:

• यदि चैट पहले से कमांड और उत्तरों का समर्थन करती है, तो उसी चैट का /approve साझा पथ के माध्यम से काम करता है।
• जब कोई समर्थित मूल चैनल अनुमोदनकर्ताओं का सुरक्षित रूप से अनुमान लगा सकता है, तो channels.<channel>.execApprovals.enabled अनसेट या "auto" होने पर OpenClaw पहले-DM वाले मूल अनुमोदन स्वतः सक्षम करता है।
• जब मूल अनुमोदन कार्ड/बटन उपलब्ध हों, तो वही UI प्राथमिक होता है; मैन्युअल /approve कमांड का उल्लेख केवल तभी करें, जब टूल परिणाम बताए कि चैट अनुमोदन उपलब्ध नहीं हैं।
• approvals.exec का उपयोग केवल तब करें, जब संकेतों को अन्य चैट या स्पष्ट संचालन कक्षों तक भी पहुँचना हो।
• channels.<channel>.execApprovals.target: "channel" या "both" का उपयोग केवल तब करें, जब आप अनुमोदन संकेतों को मूल कक्ष/विषय में वापस पोस्ट करना चाहते हों।
• Plugin अनुमोदन अलग होते हैं: डिफ़ॉल्ट रूप से उसी चैट का /approve, वैकल्पिक approvals.plugin अग्रेषण, और केवल कुछ मूल चैनल उनके लिए भी मूल प्रबंधन बनाए रखते हैं।

संक्षेप में: अग्रेषण रूटिंग के लिए है, जबकि मूल क्लाइंट कॉन्फ़िगरेशन अधिक समृद्ध चैनल-विशिष्ट उपयोगकर्ता अनुभव के लिए है। Exec अनुमोदन देखें।

Node 22.22.3+, 24.15+, या 25.9+ आवश्यक है (Node 24 अनुशंसित)। pnpm रिपॉज़िटरी पैकेज मैनेजर है। Bun निर्भरताएँ इंस्टॉल कर सकता है और पैकेज स्क्रिप्ट चला सकता है, लेकिन वह OpenClaw CLI या Gateway नहीं चला सकता, क्योंकि उसमें node:sqlite उपलब्ध नहीं है।

हाँ, लेकिन पहले RAM जाँचें: Pi 5 और Pi 4 (2 GB+) सबसे उपयुक्त हैं; Pi 3B+ (1 GB) काम करता है लेकिन धीमा है; Pi Zero 2 W (512 MB) अनुशंसित नहीं है।

पूर्ण न्यूनतम: 1 GB RAM, 1 कोर, 500 MB खाली डिस्क और 64-बिट OS। चूँकि Pi केवल Gateway चलाता है (मॉडल क्लाउड API को कॉल करते हैं), इसलिए सामान्य क्षमता वाला Pi भी भार संभाल सकता है।

कोई छोटा Pi/VPS केवल Gateway को भी होस्ट कर सकता है, जबकि आप स्थानीय स्क्रीन/कैमरा/कैनवास या कमांड निष्पादन के लिए अपने लैपटॉप/फ़ोन पर नोड युग्मित कर सकते हैं। नोड देखें।

पूरा सेटअप मार्गदर्शन: Raspberry Pi।

• 64-बिट OS का उपयोग करें; 32-बिट Raspberry Pi OS का उपयोग न करें।
• 2 GB या उससे छोटे बोर्ड पर स्वैप जोड़ें।
• प्रदर्शन और दीर्घायु के लिए SD कार्ड के बजाय USB SSD को प्राथमिकता दें।
• संशोधन-योग्य (git) इंस्टॉलेशन को प्राथमिकता दें, ताकि आप लॉग देख सकें और तेज़ी से अपडेट कर सकें।
• चैनलों/Skills के बिना शुरू करें और उन्हें एक-एक करके जोड़ें।
• असामान्य बाइनरी विफलताएँ ("exec format error") आम तौर पर किसी वैकल्पिक स्किल टूल के लिए ARM64 बिल्ड उपलब्ध न होने के कारण होती हैं।

पूरी मार्गदर्शिका: Raspberry Pi। Linux भी देखें।

वह स्क्रीन Gateway के पहुँच योग्य और प्रमाणित होने पर निर्भर करती है। मॉडल प्रदाता कॉन्फ़िगर होने पर TUI भी पहली बार शुरू होते समय "Wake up, my friend!" स्वचालित रूप से भेजता है। यदि आपने मॉडल/प्रमाणीकरण सेटअप छोड़ दिया था, तो ऑनबोर्डिंग "मॉडल प्रमाणीकरण अनुपलब्ध" नोट दिखाती है और कुछ भी भेजे बिना TUI खोलती है — openclaw configure --section model से प्रदाता जोड़ें। यदि आपको सक्रिय करने वाली पंक्ति दिखती है, लेकिन कोई उत्तर नहीं मिलता और टोकन 0 पर रहते हैं, तो एजेंट कभी चला ही नहीं।

1. Gateway पुनः आरंभ करें:

openclaw gateway restart

2. स्थिति + प्रमाणीकरण जाँचें:

openclaw statusopenclaw models statusopenclaw logs --follow

3. अभी भी अटका है? चलाएँ:

openclaw doctor

यदि Gateway दूरस्थ है, तो पुष्टि करें कि टनल/Tailscale कनेक्शन चालू है और UI सही Gateway की ओर इंगित करता है। दूरस्थ पहुँच देखें।

हाँ। स्थिति डायरेक्टरी और वर्कस्पेस कॉपी करें, फिर Doctor एक बार चलाएँ:

1. नई मशीन पर OpenClaw इंस्टॉल करें।
2. पुरानी मशीन से $OPENCLAW_STATE_DIR (डिफ़ॉल्ट: ~/.openclaw) कॉपी करें।
3. अपना वर्कस्पेस (डिफ़ॉल्ट: ~/.openclaw/workspace) कॉपी करें।
4. openclaw doctor चलाएँ और Gateway सेवा पुनः आरंभ करें।

इससे कॉन्फ़िगरेशन, प्रमाणीकरण प्रोफ़ाइल, WhatsApp क्रेडेंशियल, सत्र और मेमोरी सुरक्षित रहते हैं - यदि आप दोनों स्थान कॉपी करते हैं, तो आपका बॉट बिल्कुल वैसा ही रहता है। दूरस्थ मोड में Gateway होस्ट सत्र संग्रह और वर्कस्पेस का स्वामी होता है।

महत्वपूर्ण: यदि आप केवल अपना वर्कस्पेस GitHub पर कमिट/पुश करते हैं, तो आप मेमोरी + बूटस्ट्रैप फ़ाइलों का बैकअप लेते हैं, लेकिन सत्र इतिहास या प्रमाणीकरण का नहीं। वे ~/.openclaw/ के अंतर्गत रहते हैं (उदाहरण के लिए ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite)।

संबंधित: माइग्रेट करना, डिस्क पर चीज़ें कहाँ रहती हैं, एजेंट वर्कस्पेस, Doctor, दूरस्थ मोड।

GitHub बदलाव-सूची देखें: https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md

नवीनतम प्रविष्टियाँ सबसे ऊपर होती हैं। यदि शीर्ष अनुभाग अप्रकाशित है, तो अगला दिनांकित अनुभाग जारी किया गया नवीनतम संस्करण है। प्रविष्टियाँ मुख्य विशेषताएँ, परिवर्तन, और सुधार के अंतर्गत समूहित होती हैं (आवश्यक होने पर दस्तावेज़/अन्य अनुभाग भी होते हैं)।

कुछ Comcast/Xfinity कनेक्शन Xfinity Advanced Security के माध्यम से docs.openclaw.ai को गलत तरीके से अवरुद्ध कर देते हैं। इसे अक्षम करें या docs.openclaw.ai को अनुमति-सूची में जोड़ें, फिर पुनः प्रयास करें। इसे अनब्लॉक कराने में हमारी सहायता करें: https://spa.xfinity.com/check_url_status।

अभी भी अवरुद्ध हैं? दस्तावेज़ GitHub पर मिरर किए गए हैं: https://github.com/openclaw/openclaw/tree/main/docs

स्थिर और बीटा अलग कोड लाइनें नहीं, बल्कि npm dist-tags हैं:

• latest = स्थिर
• beta = परीक्षण के लिए शुरुआती बिल्ड (जब बीटा उपलब्ध न हो या वर्तमान स्थिर रिलीज़ से पुराना हो, तो latest पर वापस जाता है)

कोई स्थिर रिलीज़ आम तौर पर पहले बीटा पर आती है, फिर एक स्पष्ट पदोन्नति चरण संस्करण संख्या बदले बिना उसी संस्करण को latest पर ले जाता है। अनुरक्षक सीधे latest पर भी प्रकाशित कर सकते हैं। इसीलिए पदोन्नति के बाद बीटा और स्थिर एक ही संस्करण की ओर संकेत कर सकते हैं।

देखें कि क्या बदला: CHANGELOG.md।

इंस्टॉल करने की एक-पंक्ति कमांड और बीटा व डेव के बीच अंतर के लिए अगला अकॉर्डियन देखें।

बीटा npm dist-tag beta है (पदोन्नति के बाद latest से मेल खा सकता है)। डेव main (git) का बदलता हुआ नवीनतम सिरा है; npm पर प्रकाशित होने पर यह dist-tag dev का उपयोग करता है।

एक-पंक्ति कमांड (macOS/Linux):

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

Windows इंस्टॉलर (PowerShell): iwr -useb https://openclaw.ai/install.ps1 | iex

अधिक विवरण: डेवलपमेंट चैनल और इंस्टॉलर फ़्लैग।

दो विकल्प:

1. डेव चैनल (मौजूदा इंस्टॉल):

openclaw update --channel dev

यह main के git checkout पर स्विच करता है, upstream पर rebase करता है, बिल्ड करता है और उस checkout से CLI इंस्टॉल करता है।

2. संशोधन-योग्य (git) इंस्टॉल (नई मशीन):

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

मैन्युअल clone को प्राथमिकता दें:

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm build

दस्तावेज़: अपडेट, डेवलपमेंट चैनल, इंस्टॉल।

मोटा अनुमान:

• इंस्टॉल: 2-5 मिनट।
• QuickStart ऑनबोर्डिंग: कुछ मिनट (लूपबैक Gateway, स्वचालित टोकन, डिफ़ॉल्ट वर्कस्पेस)।
• उन्नत/पूर्ण ऑनबोर्डिंग: जब प्रदाता साइन-इन, चैनल पेयरिंग, डेमन इंस्टॉल, नेटवर्क डाउनलोड या Skills के लिए अतिरिक्त सेटअप आवश्यक हो, तो अधिक समय लगता है।

विज़ार्ड यह समय-सीमा शुरुआत में दिखाता है। वैकल्पिक चरण छोड़ें और बाद में openclaw configure के साथ वापस आएँ।

प्रक्रिया अटकी हुई है? ऊपर मैं अटका हुआ हूँ देखें।

--verbose के साथ दोबारा चलाएँ:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --verbosecurl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta --verbosecurl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --verbose

install.ps1 में अलग से verbose स्विच नहीं है; इसके बजाय इसे Set-PSDebug -Trace 1 / -Trace 0 में लपेटें। फ़्लैग की पूरी संदर्भ-सूची: इंस्टॉलर फ़्लैग।

Windows की दो सामान्य समस्याएँ:

1) npm त्रुटि spawn git / git नहीं मिला

• Git for Windows इंस्टॉल करें और सुनिश्चित करें कि git PATH में है।
• PowerShell बंद करके दोबारा खोलें, फिर इंस्टॉलर फिर से चलाएँ।

2) इंस्टॉल के बाद openclaw पहचाना नहीं जाता

• आपका npm global bin फ़ोल्डर PATH में नहीं है।
• इसे जाँचें: npm config get prefix।
• उस डायरेक्टरी को अपने उपयोगकर्ता PATH में जोड़ें (\bin प्रत्यय की आवश्यकता नहीं है; अधिकांश सिस्टम पर यह %AppData%\npm होता है)।
• PowerShell बंद करके दोबारा खोलें।

डेस्कटॉप ऐप पसंद है? Windows Hub का उपयोग करें। केवल टर्मिनल वाला सेटअप: PowerShell इंस्टॉलर और WSL2 Gateway पथ, दोनों समर्थित हैं। दस्तावेज़: Windows।

आम तौर पर इसका कारण मूल Windows शेल में कंसोल कोड पेज का मेल न खाना होता है।

लक्षण: system.run/exec आउटपुट में चीनी टेक्स्ट अपठनीय वर्णों के रूप में दिखाई देता है; वही कमांड किसी दूसरे टर्मिनल प्रोफ़ाइल में ठीक दिखती है।

PowerShell में वैकल्पिक समाधान:

chcp 65001[Console]::InputEncoding = [System.Text.UTF8Encoding]::new($false)[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)$OutputEncoding = [System.Text.UTF8Encoding]::new($false)

फिर Gateway पुनः प्रारंभ करके दोबारा प्रयास करें:

openclaw gateway restart

नवीनतम OpenClaw पर भी यह समस्या दोहराई जा रही है? इसे ट्रैक/रिपोर्ट करें: समस्या #30640।

संशोधन-योग्य (git) इंस्टॉल का उपयोग करें, ताकि पूरा स्रोत और दस्तावेज़ स्थानीय रूप से उपलब्ध हों, फिर अपने बॉट (या Claude/Codex) से उसी फ़ोल्डर से पूछें, ताकि वह रिपॉज़िटरी पढ़कर सटीक उत्तर दे सके।

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

अधिक विवरण: इंस्टॉल और इंस्टॉलर फ़्लैग।

• Linux का त्वरित तरीका + सेवा इंस्टॉल: Linux।
• पूरा चरण-दर-चरण मार्गदर्शन: आरंभ करना।
• इंस्टॉलर + अपडेट: इंस्टॉल और अपडेट।

कोई भी Linux VPS काम करता है। सर्वर पर इंस्टॉल करें, फिर SSH/Tailscale के माध्यम से Gateway तक पहुँचें।

मार्गदर्शिकाएँ: exe.dev, Hetzner, Fly.io। रिमोट पहुँच: Gateway रिमोट।

सामान्य प्रदाताओं वाला होस्टिंग केंद्र:

• VPS होस्टिंग (सभी प्रदाता एक ही स्थान पर)
• Fly.io
• Hetzner
• exe.dev

क्लाउड में Gateway सर्वर पर चलता है और आप अपने लैपटॉप/फ़ोन से Control UI (या Tailscale/SSH) के माध्यम से उस तक पहुँचते हैं। आपकी स्थिति + वर्कस्पेस सर्वर पर रहते हैं, इसलिए होस्ट को सत्य का स्रोत मानें और उसका बैकअप लें।

स्थानीय स्क्रीन/कैमरा/कैनवस या अपने लैपटॉप पर कमांड चलाने के लिए नोड्स (Mac/iOS/Android/headless) को उस क्लाउड Gateway से पेयर करें, जबकि Gateway क्लाउड में ही रहता है।

केंद्र: प्लेटफ़ॉर्म। रिमोट पहुँच: Gateway रिमोट। नोड्स: नोड्स, नोड्स CLI।

संभव है, लेकिन अनुशंसित नहीं। अपडेट प्रवाह Gateway को पुनः प्रारंभ कर सकता है (जिससे सक्रिय सत्र टूट जाएगा), इसके लिए साफ़ git checkout की आवश्यकता हो सकती है और यह पुष्टि माँग सकता है। ऑपरेटर के रूप में शेल से अपडेट चलाना अधिक सुरक्षित है।

openclaw updateopenclaw update statusopenclaw update --channel stable|extended-stable|beta|devopenclaw update --tag <dist-tag|version>openclaw update --no-restart

किसी एजेंट से स्वचालित करना:

openclaw update --yes --no-restartopenclaw gateway restart

दस्तावेज़: अपडेट, अपडेट करना।

openclaw onboard अनुशंसित सेटअप पथ है। स्थानीय मोड में यह इन चरणों से ले जाता है:

1. मॉडल/प्रमाणीकरण - प्रदाता OAuth, API कुंजियाँ या मैन्युअल प्रमाणीकरण (LM Studio जैसे स्थानीय विकल्पों सहित); एक डिफ़ॉल्ट मॉडल चुनें।
2. वर्कस्पेस - स्थान + बूटस्ट्रैप फ़ाइलें।
3. Gateway - पोर्ट, बाइंड पता, प्रमाणीकरण मोड, Tailscale एक्सपोज़र।
4. चैनल - अंतर्निहित और आधिकारिक Plugin चैट चैनल: iMessage, Discord, Feishu, Google Chat, Mattermost, Microsoft Teams, QQ Bot, Signal, Slack, Telegram, WhatsApp और अन्य।
5. डेमन - LaunchAgent (macOS), systemd उपयोगकर्ता इकाई (Linux/WSL2) या मूल Windows Scheduled Task।
6. स्वास्थ्य जाँच - Gateway प्रारंभ करती है और सत्यापित करती है कि वह चल रहा है।
7. Skills - अनुशंसित स्किल और वैकल्पिक निर्भरताएँ इंस्टॉल करती है।

यह शुरुआत में ही अपेक्षित अवधि बताती है और यदि आपका कॉन्फ़िगर किया गया मॉडल अज्ञात है या प्रमाणीकरण उपलब्ध नहीं है, तो चेतावनी देती है। पूरा विवरण: ऑनबोर्डिंग (CLI)।

नहीं। OpenClaw को API कुंजियों (Anthropic/OpenAI/अन्य) या केवल स्थानीय मॉडल के साथ चलाएँ, ताकि आपका डेटा आपके डिवाइस पर रहे। सदस्यताएँ (Claude Pro/Max, ChatGPT/Codex) उन प्रदाताओं से प्रमाणीकरण करने के वैकल्पिक तरीके हैं।

Anthropic के लिए: API कुंजी मानक उपयोग-के-अनुसार-भुगतान बिलिंग देती है; Claude CLI उसी होस्ट पर मौजूदा Claude Code लॉगिन का पुनः उपयोग करती है। Anthropic वर्तमान में Claude CLI के गैर-इंटरैक्टिव claude -p पथ को Agent SDK/प्रोग्रामेटिक उपयोग मानता है, जो अब भी आपकी सदस्यता की योजना सीमाओं से उपयोग करता है—सदस्यता व्यवहार पर निर्भर होने से पहले वर्तमान Anthropic बिलिंग दस्तावेज़ जाँचें। लंबे समय तक चलने वाले Gateway होस्ट और साझा स्वचालन के लिए Anthropic API कुंजी अधिक पूर्वानुमेय विकल्प है।

OpenAI Codex OAuth (ChatGPT/Codex सदस्यता) एजेंट मॉडल के लिए पूरी तरह समर्थित है। OpenClaw Qwen Cloud Coding Plan, MiniMax Coding Plan और Z.AI / GLM Coding Plan सहित होस्ट किए गए सदस्यता-शैली विकल्पों का भी समर्थन करता है।

दस्तावेज़: Anthropic, OpenAI, Qwen Cloud, MiniMax, Z.AI (GLM), स्थानीय मॉडल, मॉडल।

हाँ। OpenClaw Pro/Max/Team/Enterprise योजनाओं के लिए Claude CLI पुनः उपयोग का समर्थन करता है। Anthropic वर्तमान में OpenClaw द्वारा उपयोग किए जाने वाले claude -p पथ को आपकी योजना की सीमाओं के अधीन सदस्यता-योजना उपयोग मानता है, अलग निःशुल्क भत्ता नहीं—वर्तमान बिलिंग विवरण और Anthropic के अपने सहायता लेखों के लिंक के लिए Anthropic देखें। सर्वर-साइड के सर्वाधिक पूर्वानुमेय सेटअप के लिए इसके बजाय Anthropic API कुंजी का उपयोग करें।

हाँ, Claude CLI पुनः उपयोग के माध्यम से। claude -p/Agent SDK उपयोग के प्रति Anthropic का बिलिंग व्यवहार समय के साथ बदला है; विशिष्ट बिलिंग व्यवहार पर निर्भर होने से पहले वर्तमान स्थिति और Anthropic के सहायता लेखों के दिनांकित लिंक के लिए Anthropic देखें।

Anthropic setup-token प्रमाणीकरण भी अभी एक समर्थित टोकन पथ है, लेकिन उपलब्ध होने पर OpenClaw Claude CLI के पुनः उपयोग और claude -p को प्राथमिकता देता है। उत्पादन या बहु-उपयोगकर्ता वर्कलोड के लिए, Anthropic API कुंजी अधिक सुरक्षित और पूर्वानुमेय विकल्प बनी हुई है। अन्य सदस्यता-शैली के होस्टेड विकल्प: OpenAI, Qwen Cloud, MiniMax, Z.AI (GLM)।

वर्तमान अवधि के लिए आपका Anthropic कोटा/दर सीमा समाप्त हो गई है। Claude CLI पर, अवधि रीसेट होने की प्रतीक्षा करें या अपनी योजना अपग्रेड करें। Anthropic API कुंजी पर, Anthropic Console में उपयोग/बिलिंग जाँचें और आवश्यकतानुसार सीमाएँ बढ़ाएँ।

यदि संदेश विशेष रूप से Extra usage is required for long context requests है, तो अनुरोध Anthropic की 1M कॉन्टेक्स्ट विंडो (GA-सक्षम 1M Claude 4.x मॉडल, या पुराना params.context1m: true कॉन्फ़िगरेशन) उपयोग करने का प्रयास कर रहा है, और आपका वर्तमान क्रेडेंशियल दीर्घ-कॉन्टेक्स्ट बिलिंग के लिए पात्र नहीं है।

एक फ़ॉलबैक मॉडल सेट करें ताकि किसी प्रदाता की दर सीमित होने पर भी OpenClaw उत्तर देता रहे। मॉडल, OAuth, और दीर्घ कॉन्टेक्स्ट के लिए Anthropic 429 अतिरिक्त उपयोग आवश्यक देखें।

हाँ। OpenClaw में बंडल किया हुआ Amazon Bedrock (Converse) प्रदाता है। AWS env मार्कर मौजूद होने पर (AWS_ACCESS_KEY_ID, AWS_PROFILE, AWS_BEARER_TOKEN_BEDROCK), OpenClaw मॉडल खोज के लिए अंतर्निहित Bedrock प्रदाता को स्वतः सक्षम करता है; अन्यथा plugins.entries.amazon-bedrock.config.discovery.enabled: true सेट करें या मैन्युअल प्रदाता प्रविष्टि जोड़ें। Amazon Bedrock और मॉडल प्रदाता देखें। यदि आप प्रबंधित कुंजी प्रवाह पसंद करते हैं, तो Bedrock के सामने OpenAI-संगत प्रॉक्सी भी एक मान्य विकल्प है।

OpenClaw OAuth (ChatGPT साइन-इन) के माध्यम से OpenAI Codex का समर्थन करता है। प्राथमिक मॉडल के बिना नया सेटअप ChatGPT/Codex सदस्यता प्रमाणीकरण और मूल Codex app-server निष्पादन के लिए सटीक openai/gpt-5.6-sol का उपयोग करता है। पुनः प्रमाणीकरण किसी मौजूदा स्पष्ट मॉडल को बनाए रखता है, जिसमें openai/gpt-5.5 शामिल है। यदि Codex कार्यस्थान GPT-5.6 उपलब्ध नहीं कराता, तो openai/gpt-5.5 स्पष्ट रूप से चुनें; OpenClaw चुपचाप डाउनग्रेड नहीं करता। पुराने Codex-उपसर्ग वाले मॉडल संदर्भ पुराने कॉन्फ़िगरेशन हैं जिन्हें openclaw doctor --fix सुधारता है। गैर-एजेंट OpenAI API सतहों के लिए प्रत्यक्ष OpenAI API-कुंजी पहुँच उपलब्ध रहती है और क्रमबद्ध openai API-कुंजी प्रोफ़ाइल के माध्यम से एजेंट मॉडल के लिए भी उपलब्ध है। मॉडल प्रदाता और ऑनबोर्डिंग (CLI) देखें।

OpenAI API कुंजियों और ChatGPT/Codex OAuth दोनों के लिए openai वर्तमान प्रदाता और प्रमाणीकरण-प्रोफ़ाइल आईडी है - OpenAI Codex इसमें समाहित है। पुराने कॉन्फ़िगरेशन और माइग्रेशन चेतावनियों में आपको अब भी पुराना openai-codex उपसर्ग दिखाई दे सकता है:

• openai/gpt-5.6-sol = एजेंट टर्न के लिए मूल Codex रनटाइम वाला नया ChatGPT/Codex सदस्यता सेटअप।
• openai/gpt-5.5 = मौजूदा कॉन्फ़िगरेशन या GPT-5.6 पहुँच के बिना खातों के लिए स्पष्ट समर्थित चयन।
• पुराने openai-codex/* मॉडल संदर्भ = पुराना रूट जिसे openclaw doctor --fix सुधारता है।
• openai/gpt-5.5 और क्रमबद्ध openai API-कुंजी प्रोफ़ाइल = OpenAI एजेंट मॉडल के लिए API-कुंजी प्रमाणीकरण।
• पुराने openai-codex प्रमाणीकरण प्रोफ़ाइल आईडी = पुराने आईडी जिन्हें openclaw doctor --fix माइग्रेट करता है।

प्रत्यक्ष OpenAI Platform बिलिंग चाहते हैं? OPENAI_API_KEY सेट करें। ChatGPT/Codex सदस्यता प्रमाणीकरण चाहते हैं? openclaw models auth login --provider openai चलाएँ। मॉडल संदर्भों को मानक openai/* प्रदाता के अंतर्गत रखें। नया सदस्यता सेटअप सटीक openai/gpt-5.6-sol का उपयोग करता है; doctor स्पष्ट openai/gpt-5.5 चयन को अपग्रेड किए बिना पुराने Codex-उपसर्ग वाले संदर्भों को सुधारता है।

Codex OAuth, OpenAI-प्रबंधित और योजना-निर्भर कोटा अवधियों का उपयोग करता है, जो एक ही खाते पर भी ChatGPT वेबसाइट/ऐप अनुभव से अलग हो सकती हैं।

openclaw models status वर्तमान में दिखाई देने वाली प्रदाता उपयोग/कोटा अवधियाँ दिखाता है, लेकिन ChatGPT-वेब पात्रताओं को प्रत्यक्ष API पहुँच में गढ़ता या सामान्यीकृत नहीं करता। प्रत्यक्ष OpenAI Platform बिलिंग/सीमा पथ के लिए, API कुंजी के साथ openai/* का उपयोग करें।

हाँ, पूरी तरह। OpenAI, OpenClaw जैसे बाहरी टूल/वर्कफ़्लो में सदस्यता OAuth उपयोग की स्पष्ट रूप से अनुमति देता है। ऑनबोर्डिंग आपके लिए OAuth प्रवाह चला सकता है।

OAuth, मॉडल प्रदाता, और ऑनबोर्डिंग (CLI) देखें।

Gemini CLI Plugin प्रमाणीकरण प्रवाह का उपयोग करता है, openclaw.json में क्लाइंट आईडी या सीक्रेट का नहीं।

1. Gemini CLI को स्थानीय रूप से इंस्टॉल करें ताकि gemini, PATH पर हो:
   • Homebrew: brew install gemini-cli
   • npm: npm install -g @google/gemini-cli
2. Plugin सक्षम करें: openclaw plugins enable google
3. लॉगिन करें: openclaw models auth login --provider google-gemini-cli --set-default
4. लॉगिन के बाद डिफ़ॉल्ट मॉडल: google/gemini-3.1-pro-preview (रनटाइम google-gemini-cli)
5. लॉगिन के बाद अनुरोध विफल हो रहे हैं? Gateway होस्ट पर GOOGLE_CLOUD_PROJECT या GOOGLE_CLOUD_PROJECT_ID सेट करें और पुनः प्रयास करें।

OAuth टोकन Gateway होस्ट पर प्रमाणीकरण प्रोफ़ाइल में संग्रहीत होते हैं। विवरण: Google, मॉडल प्रदाता।

आम तौर पर नहीं। OpenClaw को बड़ा कॉन्टेक्स्ट + मज़बूत सुरक्षा चाहिए; छोटे कार्ड कॉन्टेक्स्ट को छोटा कर देते हैं और प्रदाता-पक्ष के सुरक्षा फ़िल्टर छोड़ देते हैं। यदि आवश्यक हो, तो स्थानीय रूप से उपलब्ध सबसे बड़ा मॉडल बिल्ड (LM Studio) चलाएँ - स्थानीय मॉडल देखें। छोटे/क्वांटाइज़्ड मॉडल प्रॉम्प्ट-इंजेक्शन का जोखिम बढ़ाते हैं - सुरक्षा देखें।

क्षेत्र से बँधे एंडपॉइंट चुनें। OpenRouter, MiniMax, Kimi, और GLM के लिए US-होस्टेड विकल्प उपलब्ध कराता है; डेटा को उसी क्षेत्र में रखने के लिए US-होस्टेड वेरिएंट चुनें। आप इनके साथ Anthropic/OpenAI को models.mode: "merge" के माध्यम से सूचीबद्ध कर सकते हैं, ताकि आपके चुने हुए क्षेत्रीय प्रदाता का सम्मान करते हुए फ़ॉलबैक उपलब्ध रहें।

नहीं। OpenClaw macOS या Linux (WSL2 के माध्यम से Windows) पर चलता है। Mac mini एक लोकप्रिय हमेशा-चालू होस्ट विकल्प है, लेकिन छोटा VPS, होम सर्वर या Raspberry Pi-श्रेणी का बॉक्स भी काम करता है।

आपको Mac केवल macOS-विशिष्ट टूल के लिए चाहिए। iMessage के लिए, Messages में साइन-इन किए हुए किसी भी Mac पर imsg के साथ iMessage का उपयोग करें - यदि Gateway Linux या कहीं और चलता है, तो channels.imessage.cliPath को ऐसे SSH रैपर पर सेट करें जो उस Mac पर imsg चलाता हो। अन्य macOS-विशिष्ट टूल के लिए, Gateway को Mac पर चलाएँ या macOS Node पेयर करें।

दस्तावेज़: iMessage, Nodes, Mac रिमोट मोड।

आपको Messages में साइन-इन किया हुआ कोई macOS डिवाइस चाहिए - Mac mini होना आवश्यक नहीं है, कोई भी Mac काम करेगा। imsg के साथ iMessage का उपयोग करें; Gateway उस Mac पर या कहीं और SSH रैपर cliPath के साथ चल सकता है।

सामान्य सेटअप:

• Linux/VPS पर Gateway, channels.imessage.cliPath को ऐसे SSH रैपर पर सेट किया गया है जो Messages में साइन-इन किए हुए Mac पर imsg चलाता है।
• सबसे सरल एकल-मशीन सेटअप के लिए सब कुछ एक Mac पर।

दस्तावेज़: iMessage, Nodes, Mac रिमोट मोड।

हाँ। Mac mini Gateway चला सकता है, और आपका MacBook Pro एक Node (सहायक डिवाइस) के रूप में कनेक्ट होता है। Nodes Gateway नहीं चलाते - वे उस डिवाइस पर स्क्रीन/कैमरा/कैनवास और system.run जैसी क्षमताएँ जोड़ते हैं।

सामान्य पैटर्न: हमेशा-चालू Mac mini पर Gateway; MacBook Pro macOS ऐप या Node होस्ट चलाता है और Gateway से पेयर होता है। openclaw nodes status / openclaw nodes list से जाँचें।

दस्तावेज़: Nodes, Nodes CLI।

आप निर्भरताएँ इंस्टॉल करने या पैकेज स्क्रिप्ट चलाने के लिए Bun का उपयोग कर सकते हैं। OpenClaw CLI और Gateway को Node की आवश्यकता है क्योंकि मानक स्टेट स्टोर node:sqlite का उपयोग करता है; Bun वह API उपलब्ध नहीं कराता।

channels.telegram.allowFrom, मानव प्रेषक की Telegram उपयोगकर्ता आईडी (संख्यात्मक) है, बॉट उपयोगकर्ता नाम नहीं। सेटअप केवल संख्यात्मक उपयोगकर्ता आईडी माँगता है; openclaw doctor --fix पुरानी @username प्रविष्टियों को हल करने का प्रयास कर सकता है।

अधिक सुरक्षित (कोई तृतीय-पक्ष बॉट नहीं): अपने बॉट को DM करें, openclaw logs --follow चलाएँ, from.id पढ़ें।

आधिकारिक Bot API: अपने बॉट को DM करें, https://api.telegram.org/bot<bot_token>/getUpdates कॉल करें, message.from.id पढ़ें।

तृतीय-पक्ष (कम निजी): @userinfobot या @getidsbot को DM करें।

Telegram पहुँच नियंत्रण देखें।

हाँ, बहु-एजेंट रूटिंग के माध्यम से। प्रत्येक प्रेषक के WhatsApp DM (peer: { kind: "direct", id: "+15551234567" }) को अलग agentId से बाँधें, जिससे प्रत्येक व्यक्ति को अपना कार्यस्थान और सत्र स्टोर मिले। उत्तर फिर भी उसी WhatsApp खाते से आते हैं; DM पहुँच नियंत्रण (channels.whatsapp.dmPolicy / channels.whatsapp.allowFrom) प्रत्येक खाते के लिए वैश्विक है। बहु-एजेंट रूटिंग और WhatsApp देखें।

हाँ। बहु-एजेंट रूटिंग का उपयोग करें: प्रत्येक एजेंट को उसका अपना डिफ़ॉल्ट मॉडल दें, फिर आने वाले रूट (प्रदाता खाता या विशिष्ट पीयर) प्रत्येक एजेंट से बाँधें। उदाहरण कॉन्फ़िगरेशन: बहु-एजेंट रूटिंग। मॉडल और कॉन्फ़िगरेशन भी देखें।

हाँ, Linuxbrew के माध्यम से:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.profileeval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"brew install <formula>

systemd के माध्यम से OpenClaw चलाते समय: सुनिश्चित करें कि सेवा PATH में /home/linuxbrew/.linuxbrew/bin (या आपका brew उपसर्ग) शामिल है, ताकि brew द्वारा इंस्टॉल किए गए टूल गैर-लॉगिन शेल में हल हो सकें। हालिया बिल्ड Linux systemd सेवाओं पर सामान्य उपयोगकर्ता bin डायरेक्टरी भी पहले जोड़ते हैं (उदाहरण के लिए ~/.local/bin, ~/.npm-global/bin, ~/.local/share/pnpm, ~/.bun/bin) और सेट होने पर PNPM_HOME, NPM_CONFIG_PREFIX, BUN_INSTALL, VOLTA_HOME, ASDF_DATA_DIR, NVM_DIR, और FNM_DIR का सम्मान करते हैं।

• संशोधन योग्य (git) इंस्टॉल: पूर्ण स्रोत चेकआउट, संपादन योग्य, योगदानकर्ताओं के लिए सर्वोत्तम। आप स्थानीय रूप से बिल्ड करते हैं और कोड/दस्तावेज़ में पैच कर सकते हैं।
• npm इंस्टॉल: वैश्विक CLI इंस्टॉल, कोई रेपो नहीं, "बस इसे चलाने" के लिए सर्वोत्तम। अपडेट npm dist-tags से आते हैं।

दस्तावेज़: आरंभ करना, अपडेट करना।

हाँ, मौजूदा इंस्टॉल पर openclaw update --channel ... के साथ। इससे आपका डेटा नहीं मिटता—केवल OpenClaw कोड इंस्टॉल बदलता है। स्थिति (~/.openclaw) और कार्यस्थान (~/.openclaw/workspace) अपरिवर्तित रहते हैं।

npm से git:

openclaw update --channel dev

git से npm:

openclaw update --channel stable

पहले नियोजित मोड स्विच का पूर्वावलोकन करने के लिए --dry-run जोड़ें। अपडेटर Doctor की अनुवर्ती कार्रवाइयाँ चलाता है, लक्षित चैनल के लिए Plugin स्रोत रीफ़्रेश करता है और Gateway को पुनः आरंभ करता है, जब तक कि आप --no-restart न दें।

इंस्टॉलर किसी भी मोड को बाध्य भी कर सकता है:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method gitcurl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method npm

बैकअप सुझाव: डिस्क पर चीज़ें कहाँ रहती हैं।

24/7 विश्वसनीयता चाहिए? VPS का उपयोग करें। न्यूनतम झंझट चाहते हैं और स्लीप/पुनः आरंभ से कोई समस्या नहीं है? इसे स्थानीय रूप से चलाएँ।

लैपटॉप (स्थानीय Gateway)

• लाभ: सर्वर की कोई लागत नहीं, स्थानीय फ़ाइलों तक सीधी पहुँच, लाइव ब्राउज़र विंडो।
• हानियाँ: स्लीप/नेटवर्क रुकने पर यह डिस्कनेक्ट हो जाता है, OS अपडेट/रीबूट इसे बाधित करते हैं, इसे सक्रिय रखना आवश्यक है।

VPS / क्लाउड

• लाभ: हमेशा चालू, स्थिर नेटवर्क, लैपटॉप स्लीप की कोई समस्या नहीं, लगातार चलाए रखना आसान।
• हानियाँ: अक्सर हेडलेस (स्क्रीनशॉट का उपयोग करें), केवल दूरस्थ फ़ाइल पहुँच, अपडेट के लिए SSH आवश्यक।

WhatsApp/Telegram/Slack/Mattermost/Discord सभी VPS से ठीक काम करते हैं—वास्तविक समझौता हेडलेस ब्राउज़र और दृश्यमान विंडो के बीच है। ब्राउज़र देखें।

डिफ़ॉल्ट सुझाव: यदि पहले Gateway डिस्कनेक्ट हुआ है, तो VPS का उपयोग करें; जब आप Mac का सक्रिय रूप से उपयोग कर रहे हों और स्थानीय फ़ाइल पहुँच या दृश्यमान-ब्राउज़र UI स्वचालन चाहते हों, तो स्थानीय सेटअप बढ़िया है।

यह आवश्यक नहीं है, लेकिन विश्वसनीयता और पृथक्करण के लिए अनुशंसित है।

• समर्पित होस्ट (VPS/Mac mini/Raspberry Pi): हमेशा चालू, स्लीप/रीबूट से कम बाधाएँ, अधिक सुव्यवस्थित अनुमतियाँ, लगातार चलाए रखना आसान।
• साझा लैपटॉप/डेस्कटॉप: परीक्षण और सक्रिय उपयोग के लिए ठीक है, लेकिन मशीन के स्लीप होने या अपडेट होने पर रुकावटों की अपेक्षा रखें।

दोनों का सर्वोत्तम लाभ पाने के लिए: Gateway को एक समर्पित होस्ट पर रखें और स्थानीय स्क्रीन/कैमरा/exec टूल के लिए अपने लैपटॉप को Node के रूप में युग्मित करें। Nodes और सुरक्षा देखें।

• पूर्ण न्यूनतम: 1 vCPU, 1 GB RAM, ~500 MB डिस्क।
• अनुशंसित: अतिरिक्त क्षमता (लॉग, मीडिया, एकाधिक चैनल) के लिए 1-2 vCPU, 2 GB+ RAM। Node टूल और ब्राउज़र स्वचालन बहुत अधिक संसाधन उपयोग कर सकते हैं।

OS: Ubuntu LTS (या कोई भी आधुनिक Debian/Ubuntu)—सर्वाधिक परीक्षित Linux इंस्टॉल पथ।

दस्तावेज़: Linux, VPS होस्टिंग।

हाँ। VM को VPS की तरह समझें: इसे हमेशा चालू और पहुँच योग्य होना चाहिए तथा इसमें Gateway और आपके द्वारा सक्षम किए गए सभी चैनलों के लिए पर्याप्त RAM होनी चाहिए।

• पूर्ण न्यूनतम: 1 vCPU, 1 GB RAM।
• अनुशंसित: एकाधिक चैनल, ब्राउज़र स्वचालन या मीडिया टूल के लिए 2 GB+ RAM।
• OS: Ubuntu LTS या कोई अन्य आधुनिक Debian/Ubuntu।

Windows पर डेस्कटॉप सेटअप के लिए Windows Hub या व्यापक टूलिंग संगतता वाले Linux-शैली के Gateway VM के लिए WSL2 का उपयोग करें। Windows, VPS होस्टिंग देखें। VM में macOS चलाने के लिए: macOS VM देखें।