CLI commands
QR
openclaw qr
अपने वर्तमान Gateway कॉन्फ़िगरेशन से मोबाइल पेयरिंग QR और सेटअप कोड जनरेट करें।
openclaw qropenclaw qr --setup-code-onlyopenclaw qr --jsonopenclaw qr --remoteopenclaw qr --limitedopenclaw qr --url wss://gateway.example/wsआधिकारिक OpenClaw iOS और Android ऐप तब अपने-आप कनेक्ट हो जाते हैं, जब उनका सेटअप-कोड मेटाडेटा मेल खाता है। यदि कोई अनुरोध लंबित रहता है (उदाहरण के लिए, किसी गैर-आधिकारिक क्लाइंट या मेल न खाने वाले मेटाडेटा के कारण), तो उसकी समीक्षा करके उसे स्वीकृत करें:
openclaw devices listopenclaw devices approve <requestId>विकल्प
--remote:gateway.remote.urlको प्राथमिकता दें; यदि वह URL सेट नहीं है, तोgateway.tailscale.mode=serve|funnelका उपयोग करता है।device-pairPluginpublicUrlको अनदेखा करता है।--url <url>: पेलोड में उपयोग किए गए Gateway URL को ओवरराइड करें--public-url <url>: पेलोड में उपयोग किए गए सार्वजनिक URL को ओवरराइड करें--token <token>: उस Gateway टोकन को ओवरराइड करें जिसके विरुद्ध बूटस्ट्रैप प्रवाह प्रमाणित होता है--password <password>: उस Gateway पासवर्ड को ओवरराइड करें जिसके विरुद्ध बूटस्ट्रैप प्रवाह प्रमाणित होता है--limited: हस्तांतरित ऑपरेटर टोकन से प्रशासनिक Gateway एक्सेस हटाएँ--setup-code-only: केवल सेटअप कोड प्रिंट करें--no-ascii: ASCII QR रेंडरिंग छोड़ें--json: JSON उत्सर्जित करें (setupCode,gatewayUrl, वैकल्पिकgatewayUrls,auth,access, वैकल्पिकaccessDowngraded,urlSource)
--token और --password परस्पर अनन्य हैं।
सेटअप कोड की सामग्री
सेटअप कोड में साझा Gateway टोकन/पासवर्ड नहीं, बल्कि एक अपारदर्शी, अल्पकालिक bootstrapToken होता है। किसी wss:// एंडपॉइंट (या समान-होस्ट लूपबैक) के लिए, डिफ़ॉल्ट बूटस्ट्रैप प्रवाह जारी करता है:
scopes: []वाला एक प्राथमिकnodeटोकनoperator.admin,operator.approvals,operator.read,operator.talk.secrets, औरoperator.writeवाला एक पूर्ण नेटिव-मोबाइलoperatorहस्तांतरण टोकन
ऑपरेटर हस्तांतरण से operator.admin हटाते हुए उसी Node टोकन को बनाए रखने के लिए --limited का उपयोग करें। पेयरिंग-म्यूटेशन स्कोप कभी भी सेटअप कोड द्वारा हस्तांतरित नहीं किया जाता।
प्लेनटेक्स्ट LAN ws:// सेटअप उपलब्ध रहता है, लेकिन OpenClaw स्वचालित रूप से
सीमित प्रोफ़ाइल का उपयोग करता है, क्योंकि कोई नेटवर्क पर्यवेक्षक बेयरर बूटस्ट्रैप
टोकन को कैप्चर करके उससे पहले अनुरोध कर सकता है। पूर्ण एक्सेस पाने के लिए wss:// या Tailscale Serve कॉन्फ़िगर करें, फिर नया कोड
जनरेट करें।
Gateway URL निर्धारण
Tailscale/सार्वजनिक ws:// Gateway URL के लिए मोबाइल पेयरिंग सुरक्षित रूप से विफल होती है: इनके लिए Tailscale Serve/Funnel या wss:// Gateway URL का उपयोग करें। निजी LAN पते और .local Bonjour होस्ट प्लेन ws:// पर समर्थित रहते हैं, जिनमें ऊपर बताए अनुसार सीमित ऑपरेटर एक्सेस मिलता है।
जब चयनित Gateway URL gateway.bind=lan से आता है, तो OpenClaw स्थायी tailscale serve status --json रूट की भी जाँच करता है। सक्रिय Gateway के लूपबैक पोर्ट को प्रॉक्सी करने वाला कोई भी HTTPS Serve रूट फ़ॉलबैक के रूप में शामिल किया जाता है। QR कमांड यह फ़ॉलबैक केवल lan के लिए जोड़ता है; custom और tailnet अपने स्पष्ट रूप से विज्ञापित रूट बनाए रखते हैं। वर्तमान iOS क्लाइंट विज्ञापित रूट की क्रम से जाँच करते हैं और पहुँच योग्य पहले रूट को सहेजते हैं; पुराने क्लाइंट के लिए लेगेसी url फ़ील्ड अपरिवर्तित रहता है।
--remote के साथ, gateway.remote.url या gateway.tailscale.mode=serve|funnel में से एक आवश्यक है।
प्रमाणीकरण निर्धारण (--remote के बिना)
जब कोई CLI प्रमाणीकरण ओवरराइड पास नहीं किया जाता, तो स्थानीय Gateway प्रमाणीकरण SecretRefs का निर्धारण इस प्रकार होता है:
| शर्त | निर्धारित मान |
|---|---|
gateway.auth.mode="token", या ऐसा अनुमानित मोड जिसमें कोई प्रभावी पासवर्ड स्रोत नहीं है |
gateway.auth.token |
gateway.auth.mode="password", या ऐसा अनुमानित मोड जिसमें प्रमाणीकरण/परिवेश से कोई प्रभावी टोकन नहीं है |
gateway.auth.password |
gateway.auth.token और gateway.auth.password दोनों कॉन्फ़िगर हैं (SecretRefs सहित) और gateway.auth.mode सेट नहीं है |
विफल होता है; gateway.auth.mode स्पष्ट रूप से सेट करें |
प्रमाणीकरण निर्धारण (--remote)
यदि प्रभावी रूप से सक्रिय रिमोट क्रेडेंशियल SecretRefs के रूप में कॉन्फ़िगर हैं और न तो --token न ही --password पास किया गया है, तो कमांड सक्रिय Gateway स्नैपशॉट से उनका निर्धारण करता है। यदि Gateway उपलब्ध नहीं है, तो कमांड तुरंत विफल हो जाता है।
