क्लाउड वर्कर्स

​

क्या कहाँ चलता है

​

आवश्यकताएँ

• एक वर्कर प्रदाता Plugin। बंडल किया गया crabbox Plugin Crabbox CLI चलाता है, जो क्लाउड बैकएंड (AWS, Hetzner और अन्य) में लीज़ की व्यवस्था करता है। crabbox बाइनरी PATH पर उपलब्ध होनी चाहिए (या settings.binary सेट करें) और प्रदाता क्रेडेंशियल पहले से कॉन्फ़िगर होने चाहिए। AWS प्रवेश के लिए Crabbox 0.38.1 या नया संस्करण आवश्यक है।
• Crabbox AWS वर्कर के लिए, प्रभावी aws.instanceProfile खाली होना चाहिए। प्रदाता आवंटन से पहले crabbox config show --json की जाँच करता है, फिर आवश्यक करता है कि crabbox inspect --json, EC2 DescribeInstances से providerMetadata.instanceProfileAttached: false रिपोर्ट करे। इंस्टेंस भूमिका वाली या प्रामाणिक मेटाडेटा के बिना लीज़ रोककर अस्वीकार कर दी जाती हैं।
• लीज़ की गई मशीन पर Node.js। सामान्य क्लाउड इमेज में प्रायः यह नहीं होता — इसे प्रोफ़ाइल के setup कमांड में इंस्टॉल करें।
• सत्र के स्वामित्व वाले प्रबंधित वर्कट्री वाला सत्र (worktree: true से बनाएँ)। डिस्पैच उस वर्कट्री की सामग्री स्थानांतरित करता है; सामान्य डायरेक्टरी मैनिफ़ेस्ट मिरर के रूप में सिंक होती हैं।

​

कॉन्फ़िगरेशन

{
  "cloudWorkers": {
    "profiles": {
      "aws": {
        "provider": "crabbox",
        "install": "bundle",
        "settings": {
          "provider": "aws",
          "class": "standard",
          "ttl": "8h",
          "idleTimeout": "45m",
          "setup": "test -x /usr/bin/node || (curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt-get install -y nodejs)"
        }
      }
    }
  }
}

​

सेटअप कमांड

​

इंस्टॉल चैनल

• bundle चल रहे Gateway के dist, छँटे हुए package.json, और बिल्ड द्वारा संदर्भित सभी वर्कस्पेस पैकेज को पैक करता है, जिन्हें एक सामग्री हैश कवर करता है। बॉक्स उस हैश के विरुद्ध मूल बंडल को सत्यापित करता है, फिर उत्पादन npm निर्भरताएँ इंस्टॉल करता है (स्क्रिप्ट अक्षम रहती हैं)। इसी प्रकार वर्कर पर डेवलपमेंट बिल्ड चलाया जाता है।
• npm प्रमाणित करता है कि रिलीज़ सार्वजनिक रजिस्ट्री पर मौजूद है, उसकी SHA-512 अखंडता पिन करता है, और Gateway से सटीक रूप से मेल खाने वाला openclaw@<version> इंस्टॉल करता है।

​

सत्र डिस्पैच करना

openclaw gateway call sessions.create \
  --params '{"key":"agent:main:big-refactor","worktree":true,"cwd":"/path/to/repo","worktreeName":"big-refactor"}'

openclaw gateway call sessions.dispatch \
  --timeout 1500000 \
  --params '{"key":"agent:main:big-refactor","profileId":"aws"}'

openclaw gateway call sessions.reclaim \
  --timeout 600000 \
  --params '{"key":"agent:main:big-refactor"}'

​

सुरक्षा मॉडल

• बंद वर्कर इनग्रेस। वर्कर टनल किए गए सॉकेट पर बंद मेथड अनुमतिसूची वाले समर्पित प्रोटोकॉल से संचार करते हैं — कोई वर्कर ऑपरेटर RPC को कॉल नहीं कर सकता।
• Gateway के स्वामित्व वाला टूल प्राधिकार। प्रत्येक टर्न से पहले, Gateway वर्कर के स्थिर कोडिंग-टूल कैटलॉग पर वर्तमान प्रोफ़ाइल, प्रदाता, एजेंट, समूह, प्रेषक, सैंडबॉक्स, प्रत्यायोजन, इनहेरिटेड और रनटाइम-कैप नीति लागू करता है। लॉन्च एनवेलप में केवल वही अंतिम बंद-शब्दावली उपसमुच्चय होता है। स्पष्ट रूप से सीमित शेड्यूल किए गए टर्न उस पहचान को बॉक्स में भेजे बिना या नया प्रेषक ओवरले फिर से लागू किए बिना अपने विश्वसनीय स्वामी-समूह संदर्भ का पुनः उपयोग करते हैं। वर्कर कैटलॉग से बाहर के टूल अनुपलब्ध रहते हैं; रिक्त परिणाम बिना किसी टूल के चलता है।
• निर्मित क्रेडेंशियल, संग्रहण में हैश किए गए। प्रत्येक डिस्पैच एक वर्कर क्रेडेंशियल बनाता है; Gateway केवल उसका हैश संग्रहीत करता है। क्रेडेंशियल रोटेशन और स्वामी-एपोक फ़ेंसिंग सुनिश्चित करते हैं कि प्रत्येक सेशन में अधिकतम एक सक्रिय स्वामी हो — दोबारा कनेक्ट होने वाले पुराने वर्कर को फ़ेंस किया जाता है, कभी मर्ज नहीं किया जाता।
• होस्ट-की पिनिंग। प्रोविज़न के समय प्रदाता को बॉक्स की SSH होस्ट कुंजी उपलब्ध करानी होगी; बूटस्ट्रैप सख्त पिनिंग के साथ कनेक्ट होता है और इसके बिना सुरक्षित रूप से विफल हो जाता है।
• बॉक्स पर कोई स्थायी मॉडल, फ़ोर्ज या क्लाउड क्रेडेंशियल नहीं। मॉडल प्रमाणीकरण Gateway पर रहता है (इनफ़रेंस {provider, model} संदर्भ द्वारा जाता है), वर्कस्पेस git कमिट फ़ोर्ज क्रेडेंशियल के बिना लिखे जाते हैं और सेटअप से पहले इंस्टेंस भूमिका के लिए Crabbox AWS लीज़ मेटाडेटा का आधिकारिक रूप से सत्यापन किया जाता है। सेटअप कमांड भी क्रेडेंशियल-मुक्त रखें।
• प्रदाता के स्वामित्व वाला ईग्रेस। रिवर्स टनल प्रत्यक्ष मॉडल एक्सेस की OpenClaw की आवश्यकता समाप्त कर देती है, लेकिन OpenClaw प्रदाता फ़ायरवॉल को फिर से नहीं लिखता। कार्य के लिए आवश्यक होने पर वर्कर प्रदाता में आउटबाउंड ट्रैफ़िक प्रतिबंधित करें।
• टिकाऊ, ठीक-एक-बार ट्रांसक्रिप्ट। वर्कर सेशन के लीफ़ के विरुद्ध तुलना-और-स्वैप प्रोटोकॉल के माध्यम से ट्रांसक्रिप्ट बैच कमिट करता है; पुराना बेस सशुल्क आउटपुट को डुप्लिकेट या रीबेस करने के बजाय रन को तुरंत रोक देता है।

​

समस्या निवारण

• sessions.dispatch एक अज्ञात मेथड है — कोई cloudWorkers.profiles कॉन्फ़िगर नहीं है, या कॉलर के पास operator.admin नहीं है।
• “क्लाउड वर्कर टर्न के लिए OpenClaw रनटाइम आवश्यक है” — ऐसा मॉडल चुनें जिसका कॉन्फ़िगर किया गया रनटाइम OpenClaw हो। claude-cli जैसे बाहरी CLI रनटाइम वर्कर इनफ़रेंस का समर्थन नहीं करते।
• “वर्कर बूटस्ट्रैप के लिए लीज़ किए गए होस्ट पर Node.js आवश्यक है” — settings.setup में Node इंस्टॉल जोड़ें (ऊपर देखें)।
• AWS इंस्टेंस-भूमिका सत्यापन विफल होता है — aws.instanceProfile (और यदि सेट हो, तो CRABBOX_AWS_INSTANCE_PROFILE) साफ़ करें। Crabbox 0.38.1 या नया संस्करण इंस्टॉल करें; पुराने बाइनरी AWS प्रवेश के लिए आवश्यक आधिकारिक providerMetadata.instanceProfileAttached अनुबंध उपलब्ध नहीं कराते।
• प्रदाता त्रुटि के साथ डिस्पैच विफल होता है — प्लेसमेंट रिकॉर्ड और environments.list अंतिम त्रुटि को रखते हैं, जिसमें सेटअप/बूटस्ट्रैप stderr टेल शामिल है। विफलता पर बॉक्स नष्ट कर दिए जाते हैं, इसलिए यह टेल प्राथमिक फ़ोरेंसिक साक्ष्य है।
• डिस्पैच करते समय क्लाइंट टाइमआउट — openclaw gateway call का डिफ़ॉल्ट टाइमआउट 10s है; --timeout उदारतापूर्वक पास करें (दोनों स्थितियों में डिस्पैच सर्वर की ओर चलता रहता है, और प्रोविज़निंग के दौरान पुनः प्रयास को session cannot dispatch from placement provisioning के साथ अस्वीकार कर दिया जाता है)।
• 2026.7.2 बीटा से अपग्रेड करने के बाद वर्कर पुनः प्राप्त किया गया — उन बीटा संस्करणों में पुराने वर्कर लॉन्च अनुबंध का उपयोग किया गया था। पुनः आरंभ होने पर OpenClaw किसी निष्क्रिय असंगत वर्कर को नष्ट करता है, सेशन और वर्कस्पेस बनाए रखता है, प्लेसमेंट को पुनः प्राप्त के रूप में चिह्नित करता है और अगले डिस्पैच या टर्न पर वर्तमान वर्कर प्रोविज़न करता है। यदि बीटा वर्कर को आरंभ होते समय बाधित किया गया हो, तो सफ़ाई के बाद उसे विफल चिह्नित किया जाता है; वर्तमान अनुबंध के साथ उसे प्रोविज़न करने के लिए डिस्पैच का पुनः प्रयास करें।
• क्लाउड वर्कस्पेस टकराव सूचना — टर्न पूरा हुआ और प्रत्येक सूचीबद्ध पथ का स्थानीय संस्करण रखा गया। क्लाउड संस्करण का निरीक्षण करने या उसे अपनाने के लिए सूचना में दिए गए स्टेज्ड-रेफ़ कमांड का उपयोग करें; गैर-टकराव वाले परिवर्तनों के लिए पुनः प्रयास आवश्यक नहीं है, क्योंकि वे पहले ही लागू किए जा चुके हैं।
• “पिछले क्लाउड टर्न के वर्कस्पेस परिणाम का मिलान अभी भी जारी है” — Gateway ने पिछले परिणाम के टिकाऊ फ़ेंस की थोड़ी देर प्रतीक्षा की और सेशन क्लेम प्राप्त नहीं कर सका। मिलान पूरा होने की प्रतीक्षा करें, फिर टर्न का पुनः प्रयास करें; Gateway को पुनः आरंभ करना सुरक्षित है क्योंकि पुनर्प्राप्ति मृत वर्कर को पुनः प्राप्त करने से पहले स्टेज किए गए परिणामों को सुरक्षित रखती है।
• लीज़ रखरखाव — crabbox list --provider <backend> सक्रिय लीज़ दिखाता है; crabbox stop --provider <backend> --id <lease> किसी लीज़ को मैन्युअल रूप से रिलीज़ करता है। निष्क्रिय लीज़ प्रोफ़ाइल के idleTimeout पर समाप्त हो जाती हैं।

​

संबंधित

• सैंडबॉक्सिंग — स्थानीय टूल निष्पादन के प्रभाव-क्षेत्र को कम करना
• सेशन CLI — संग्रहीत सेशन का निरीक्षण करना
• कॉन्फ़िगरेशन संदर्भ