​

openclaw devices

​

सामान्य विकल्प

• --url <url>: Gateway WebSocket URL (कॉन्फ़िगर होने पर डिफ़ॉल्ट रूप से gateway.remote.url)
• --token <token>: Gateway टोकन (यदि आवश्यक हो)
• --password <password>: Gateway पासवर्ड (पासवर्ड प्रमाणीकरण)
• --timeout <ms>: RPC टाइमआउट
• --json: JSON आउटपुट (स्क्रिप्टिंग के लिए अनुशंसित)

​

कमांड

​

openclaw devices list

openclaw devices list
openclaw devices list --json

​

openclaw devices approve [requestId] [--latest]

openclaw devices approve
openclaw devices approve <requestId>
openclaw devices approve --latest

• यदि डिवाइस पहले से पेयर है और अधिक व्यापक स्कोप या भूमिका का अनुरोध करता है, तो OpenClaw मौजूदा स्वीकृति बनाए रखता है और नया लंबित अपग्रेड अनुरोध बनाता है। स्वीकृत करने से पहले openclaw devices list में Requested और Approved की तुलना करें, या --latest से पूर्वावलोकन करें।
• node भूमिका या किसी अन्य गैर-ऑपरेटर भूमिका को स्वीकृत करने के लिए operator.admin आवश्यक है। ऑपरेटर-डिवाइस स्वीकृतियों के लिए operator.pairing पर्याप्त है, लेकिन केवल तब, जब अनुरोधित ऑपरेटर स्कोप कॉलर के अपने स्कोप के भीतर रहें। ऑपरेटर स्कोप देखें।
• यदि gateway.nodes.pairing.autoApproveCidrs कॉन्फ़िगर किया गया है, तो मेल खाने वाले क्लाइंट IP से पहली बार आने वाले role: node अनुरोध इस सूची में दिखाई देने से पहले स्वतः स्वीकृत हो सकते हैं। यह डिफ़ॉल्ट रूप से अक्षम है; ऑपरेटर/ब्राउज़र क्लाइंट या अपग्रेड अनुरोधों पर कभी लागू नहीं होता।
• gateway.nodes.pairing.sshVerify (डिफ़ॉल्ट रूप से चालू) पहली बार आने वाले role: node अनुरोधों को स्वतः स्वीकृत करता है, जब Gateway SSH के माध्यम से नोड होस्ट पर डिवाइस कुंजी सत्यापित करता है। इसलिए अनुरोध दिखाई देने के कुछ ही समय बाद स्वीकृत हो सकते हैं। SSH सत्यापन अक्षम करने के लिए sshVerify: false सेट करें; यह autoApproveCidrs से स्वतंत्र है, इसलिए केवल मैन्युअल पेयरिंग के लिए उसे भी अनसेट करें।

​

openclaw devices reject <requestId>

openclaw devices reject <requestId>

​

openclaw devices remove <deviceId>

openclaw devices remove <deviceId>
openclaw devices remove <deviceId> --json

​

openclaw devices rename --device <id> --name <label>

openclaw devices rename --device <deviceId> --name "Kitchen Mac"
openclaw devices rename --device <deviceId> --name "Kitchen Mac" --json

• --name आवश्यक है, इसके आगे-पीछे के रिक्त स्थान हटाए जाते हैं, यह खाली नहीं हो सकता और अधिकतम 64 वर्णों तक सीमित है।
• प्रदर्शन सतहें (CLI सूची, Control UI इन्वेंटरी) क्लाइंट द्वारा बताए गए प्रदर्शन नाम के बजाय ऑपरेटर लेबल को प्राथमिकता देती हैं।
• गैर-एडमिन पेयर-डिवाइस कॉलर केवल अपने स्वयं के डिवाइस का नाम बदल सकता है। किसी अन्य डिवाइस का नाम बदलने के लिए operator.admin आवश्यक है।

​

openclaw devices clear --yes [--pending]

openclaw devices clear --yes
openclaw devices clear --yes --pending
openclaw devices clear --yes --pending --json

​

openclaw devices rotate --device <id> --role <role> [--scope <scope...>]

openclaw devices rotate --device <deviceId> --role operator --scope operator.read --scope operator.write

• लक्षित भूमिका उस डिवाइस के स्वीकृत पेयरिंग अनुबंध में पहले से मौजूद होनी चाहिए; रोटेशन नई अस्वीकृत भूमिका जारी नहीं कर सकता।
• --scope छोड़ने पर बाद के पुनः कनेक्शन में संग्रहीत टोकन के कैश किए गए स्वीकृत स्कोप दोबारा उपयोग होते हैं। स्पष्ट --scope मान देने पर भविष्य के कैश-टोकन पुनः कनेक्शन के लिए संग्रहीत स्कोप सेट बदल जाता है।
• गैर-एडमिन पेयर-डिवाइस कॉलर केवल अपने स्वयं के डिवाइस टोकन को रोटेट कर सकता है और लक्षित स्कोप सेट कॉलर के अपने ऑपरेटर स्कोप के भीतर रहना चाहिए; रोटेशन कॉलर के पास पहले से मौजूद टोकन से अधिक व्यापक टोकन न तो जारी कर सकता है, न बनाए रख सकता है।

​

openclaw devices revoke --device <id> --role <role>

openclaw devices revoke --device <deviceId> --role node

​

टिप्पणियाँ

• इन कमांड के लिए operator.pairing (या operator.admin) स्कोप आवश्यक है। गैर-ऑपरेटर डिवाइस भूमिकाओं के लिए हमेशा operator.admin आवश्यक है; ऑपरेटर स्कोप देखें।
• टोकन रोटेशन और निरस्तीकरण डिवाइस के स्वीकृत पेयरिंग भूमिका सेट और स्कोप आधार-रेखा के भीतर रहते हैं। कोई असंबद्ध कैश किया हुआ टोकन रिकॉर्ड टोकन-प्रबंधन लक्ष्य प्रदान नहीं करता।
• पेयर-डिवाइस टोकन सत्रों के लिए, विभिन्न डिवाइसों का प्रबंधन (remove, rename, rotate, revoke) केवल स्वयं तक सीमित है, जब तक कॉलर के पास operator.admin न हो।
• टोकन रोटेशन नया टोकन (संवेदनशील) लौटाता है — इसे गुप्त जानकारी की तरह संभालें।
• यदि स्थानीय लूपबैक पर पेयरिंग स्कोप उपलब्ध नहीं है और कोई स्पष्ट --url नहीं दिया गया है, तो list/approve स्थानीय पेयरिंग स्थिति पर फ़ॉलबैक कर सकते हैं।

​

टोकन विचलन पुनर्प्राप्ति चेकलिस्ट

1. वर्तमान Gateway टोकन स्रोत की पुष्टि करें:
   openclaw config get gateway.auth.token
   
2. पेयर किए गए डिवाइसों की सूची दिखाएँ और प्रभावित डिवाइस id पहचानें:
   openclaw devices list
   
3. प्रभावित डिवाइस के लिए ऑपरेटर टोकन रोटेट करें:
   openclaw devices rotate --device <deviceId> --role operator
   
4. यदि रोटेशन पर्याप्त नहीं है, तो पुरानी पेयरिंग हटाएँ और दोबारा स्वीकृत करें:
   openclaw devices remove <deviceId>
   openclaw devices list
   openclaw devices approve <requestId>
   
5. वर्तमान साझा टोकन/पासवर्ड के साथ क्लाइंट कनेक्शन का पुनः प्रयास करें।

• सामान्य पुनः कनेक्शन प्रमाणीकरण प्राथमिकता: पहले स्पष्ट साझा टोकन/पासवर्ड, फिर स्पष्ट deviceToken, फिर संग्रहीत डिवाइस टोकन और अंत में बूटस्ट्रैप टोकन।
• विश्वसनीय AUTH_TOKEN_MISMATCH पुनर्प्राप्ति एक सीमित पुनः प्रयास के लिए साझा टोकन और संग्रहीत डिवाइस टोकन, दोनों को अस्थायी रूप से एक साथ भेज सकती है।
• AUTH_SCOPE_MISMATCH का अर्थ है कि डिवाइस टोकन पहचाना गया था, लेकिन उसमें अनुरोधित स्कोप सेट नहीं है; साझा Gateway प्रमाणीकरण बदलने से पहले पेयरिंग/स्कोप स्वीकृति अनुबंध ठीक करें।

• डैशबोर्ड प्रमाणीकरण समस्या निवारण
• Gateway समस्या निवारण

​

Paperclip / openclaw_gateway की प्रथम-रन स्वीकृति

openclaw devices approve --latest

openclaw devices approve --latest --url <gateway-ws-url> --token <gateway-token>

{
  "adapterConfig": {
    "devicePrivateKeyPem": "<ed25519-private-key-pkcs8-pem>"
  }
}

​

संबंधित

• CLI संदर्भ
• नोड