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 अनुपलब्ध है, तो कमांड तुरंत विफल हो जाता है।
