CI पाइपलाइन

​

पाइपलाइन का अवलोकन

​

तेज़ी से विफल होने का क्रम

1. preflight तय करता है कि कौन-सी लेन मौजूद होंगी। docs-scope और changed-scope लॉजिक इस जॉब के भीतर के चरण हैं, स्वतंत्र जॉब नहीं। कैनोनिकल main तुरंत शुरू होता है, लेकिन उसका समवर्ती समूह केवल एक पूर्ण रन को प्रवेश देता है और बाद के पुश को एक नवीनतम लंबित रन में समेकित करता है। Node-संबंधित मुख्य पुश यहाँ एकमात्र निर्भरता-डिस्क राइटर और उसके आकार के अनुरक्षण को भी क्रमबद्ध करते हैं, इससे पहले कि डाउनस्ट्रीम जॉब कुंजी माउंट कर सकें; Blacksmith किसी नए कमिट को केवल बाद के वर्कफ़्लो रन के लिए उपलब्ध करा सकता है, इसलिए उसी रन के उपभोक्ता मार्कर-जाँच वाला स्थानीय फ़ॉलबैक बनाए रखते हैं।
2. security-fast, check-*, check-additional-*, check-docs, और skills-python अधिक भारी आर्टिफ़ैक्ट और प्लेटफ़ॉर्म मैट्रिक्स जॉब की प्रतीक्षा किए बिना जल्दी विफल होते हैं।
3. build-artifacts और लोकेल जाँच तेज़ Linux लेन के साथ ओवरलैप होती हैं। Control UI और नेटिव ऐप स्रोत PR जनरेट किए गए लोकेल स्नैपशॉट/संसाधनों को बाहर रखते हैं; उनके क्रमबद्ध रीफ़्रेश वर्कफ़्लो पृष्ठभूमि में पृथक जनरेट किए गए PR की मरम्मत और स्वचालित मर्ज करते हैं। स्रोत CI अब भी पुराने स्रोत इन्वेंटरी और असुरक्षित स्थानीयकरण कॉल को अवरुद्ध करता है। जनरेट किए गए PR, मैन्युअल CI और रिलीज़ तैयारी पूर्ण अनूदित/प्लेटफ़ॉर्म-जनरेटेड समानता लागू करते हैं। कैनोनिकल release/YYYY.M.PATCH शाखाओं में अन्य जनरेट किए गए रिलीज़ आउटपुट के साथ रिलीज़-तैयारी लोकेल मरम्मत शामिल हो सकती है।
4. इसके बाद अधिक भारी प्लेटफ़ॉर्म और रनटाइम लेन विस्तृत होती हैं: checks-fast-core, checks-fast-contracts-plugins-*, checks-fast-contracts-channels-*, checks-node-*, checks-windows, macos-node, macos-swift, ios-build, और android।
5. openclaw/ci-gate प्रत्येक चयनित लेन की प्रतीक्षा करता है। प्रीफ़्लाइट और सुरक्षा को सफल होना आवश्यक है; डाउनस्ट्रीम जॉब केवल तभी स्किप हो सकते हैं, जब मैनिफ़ेस्ट ने उन्हें नहीं चुना हो। कोई विफल या रद्द की गई चयनित लेन समुच्चय को विफल कर देती है।

​

PR संदर्भ और साक्ष्य

​

दायरा और रूटिंग

• CI वर्कफ़्लो संपादन Node CI ग्राफ़, वर्कफ़्लो लिंटिंग और Windows लेन को सत्यापित करते हैं (ci.yml इसे निष्पादित करता है), लेकिन स्वयं iOS, Android या macOS नेटिव बिल्ड को बाध्य नहीं करते; वे प्लेटफ़ॉर्म लेन प्लेटफ़ॉर्म स्रोत परिवर्तनों तक दायरा-बद्ध रहते हैं।
• वर्कफ़्लो सैनिटी सभी वर्कफ़्लो YAML फ़ाइलों पर actionlint, zizmor, कंपोज़िट-ऐक्शन इंटरपोलेशन गार्ड और कॉन्फ़्लिक्ट-मार्कर गार्ड चलाता है। PR-दायरा-बद्ध security-fast जॉब बदली हुई वर्कफ़्लो फ़ाइलों पर zizmor भी चलाता है, ताकि वर्कफ़्लो सुरक्षा निष्कर्ष मुख्य CI ग्राफ़ में जल्दी विफल हों।
• main पुश पर दस्तावेज़ों की जाँच स्टैंडअलोन Docs वर्कफ़्लो द्वारा CI में उपयोग किए जाने वाले उसी ClawHub दस्तावेज़ मिरर के साथ की जाती है, ताकि मिश्रित कोड+दस्तावेज़ पुश CI check-docs शार्ड को भी कतार में न लगाएँ। दस्तावेज़ बदलने पर पुल रिक्वेस्ट और मैन्युअल CI अब भी CI से check-docs चलाते हैं।
• TUI PTY TUI परिवर्तनों के लिए checks-node-core-runtime-tui-pty Linux Node शार्ड में चलता है। शार्ड OPENCLAW_TUI_PTY_INCLUDE_LOCAL=1 के साथ test/vitest/vitest.tui-pty.config.ts चलाता है, इसलिए यह नियतात्मक TuiBackend फ़िक्स्चर लेन और केवल बाहरी मॉडल एंडपॉइंट को मॉक करने वाले धीमे tui --local स्मोक, दोनों को कवर करता है।
• केवल CI रूटिंग वाले संपादन, कोर-टेस्ट फ़िक्स्चर का छोटा समूह जिसे तेज़ टास्क सीधे चलाता है, और सीमित प्लगइन अनुबंध सहायक संपादन तेज़, केवल-Node मैनिफ़ेस्ट पथ का उपयोग करते हैं: preflight, security-fast, और केवल वे तेज़ लेन जिन्हें परिवर्तन छूता है — एकल checks-fast-core CI-रूटिंग टास्क, दो प्लगइन अनुबंध शार्ड या दोनों। यह पथ बिल्ड आर्टिफ़ैक्ट, Node 22 संगतता, चैनल अनुबंध, पूर्ण कोर शार्ड, बंडल किए गए प्लगइन शार्ड और अतिरिक्त गार्ड मैट्रिक्स छोड़ देता है।
• Windows Node जाँचें Windows-विशिष्ट प्रोसेस/पथ रैपर, npm/pnpm/UI रनर सहायक, पैकेज मैनेजर कॉन्फ़िगरेशन और उस लेन को निष्पादित करने वाली CI वर्कफ़्लो सतहों तक दायरा-बद्ध हैं; असंबंधित स्रोत, प्लगइन, इंस्टॉल-स्मोक और केवल-टेस्ट परिवर्तन Linux Node लेन पर रहते हैं।

• Plugin अनुबंध और चैनल अनुबंध, दोनों मानक GitHub रनर फ़ॉलबैक के साथ दो भारित Blacksmith-समर्थित शार्ड के रूप में चलते हैं।
• कोर यूनिट की तेज़/समर्थन लेन अलग-अलग चलती हैं; कोर रनटाइम इन्फ़्रा प्रक्रिया, साझा, हुक, सीक्रेट और तीन Cron डोमेन शार्ड में विभाजित होता है।
• ऑटो-रिप्लाई संतुलित वर्कर के रूप में चलता है, जिसमें रिप्लाई सबट्री एजेंट-रनर, कमांड, डिस्पैच, सेशन और स्टेट-रूटिंग शार्ड में विभाजित होती है।
• एजेंटिक Gateway/सर्वर (कंट्रोल-प्लेन) कॉन्फ़िगरेशन, निर्मित आर्टिफ़ैक्ट की प्रतीक्षा करने के बजाय चैट, प्रमाणीकरण, मॉडल, HTTP/Plugin, रनटाइम और स्टार्टअप लेन में विभाजित होते हैं।
• सामान्य CI केवल पृथक इन्फ़्रा इन्क्लूड-पैटर्न शार्ड को अधिकतम 64 टेस्ट फ़ाइलों वाले नियतात्मक बंडलों में पैक करता है, जिससे गैर-पृथक कमांड/Cron, स्टेटफ़ुल एजेंट्स-कोर या Gateway/सर्वर सुइट को मर्ज किए बिना Node मैट्रिक्स छोटा होता है। भारी निश्चित सुइट 8 vCPU पर बने रहते हैं, जबकि बंडल की गई और कम भार वाली लेन 4 vCPU का उपयोग करती हैं।
• कैनोनिकल रिपॉज़िटरी पर पुल रिक्वेस्ट, सिंथेटिक मर्ज्ड-ट्री डिफ़ के विरुद्ध बदले हुए टेस्ट रिज़ॉल्वर का पुनः उपयोग करती हैं। सटीक बदलाव एक लक्षित Node जॉब चलाते हैं; हर चयनित टेस्ट फ़ाइल को अपनी प्रक्रिया मिलती है, ताकि स्टेटफ़ुल सुइट का पृथक्करण अक्षुण्ण रहे। प्लानर सिबलिंग टेस्ट को इम्पोर्ट-ग्राफ़ आश्रितों के साथ संयोजित करता है और वर्कस्पेस पैकेज, पैकेज/लॉकफ़ाइल, साझा हार्नेस, स्प्लिट-कॉन्फ़िग, नाम बदले या हटाए गए बदलावों, सार्वजनिक एक्सटेंशन-अनुबंध बदलावों, विशेष शार्ड सेटअप वाले टेस्ट, आंशिक रूप से रिज़ॉल्व किए गए या खाली लक्ष्यों, अत्यधिक बड़े पाथ या लक्ष्य प्लान और प्लानर त्रुटियों के लिए मौजूदा 14-जॉब कॉम्पैक्ट पूर्ण-सुइट प्लान पर फ़ॉलबैक करता है। लक्षित प्लान हमेशा पूर्ण निर्मित-आर्टिफ़ैक्ट सीमा गेट बनाए रखते हैं, क्योंकि उसके रिपॉज़िटरी स्कैनर इम्पोर्ट से व्युत्पन्न नहीं किए जा सकते। main पुश वही पूर्ण कॉम्पैक्ट सुइट चलाते हैं: लंबित मध्यवर्ती पुश इवेंट को एकीकृत किया जा सकता है, इसलिए सबसे नए शेष रन को केवल उसके अंतिम एकल-पुश डिफ़ के बजाय संपूर्ण एकीकरण ट्री को सत्यापित करना आवश्यक है। मैन्युअल डिस्पैच और रिलीज़ गेट पूर्ण नामित प्रति-शार्ड मैट्रिक्स बनाए रखते हैं।
• पूर्ण Node मैट्रिक्स लगातार धीमे सीरियल टूलिंग, ऑटो-रिप्लाई कमांड शार्ड और व्यापक कोर-फ़ास्ट कैश राइटर को पहले प्रवेश देता है। इससे 28-जॉब सीमा बनी रहती है और साथ ही क्रिटिकल-पाथ कार्य तथा अगले रन के ट्रांसफ़ॉर्म सीड को बाद की वेव में खिसकने से रोका जाता है।
• व्यापक ब्राउज़र, QA, मीडिया और विविध Plugin टेस्ट साझा Plugin कैच-ऑल के बजाय अपने समर्पित Vitest कॉन्फ़िगरेशन का उपयोग करते हैं। इन्क्लूड-पैटर्न शार्ड CI शार्ड नाम का उपयोग करके टाइमिंग प्रविष्टियाँ रिकॉर्ड करते हैं, ताकि .artifacts/vitest-shard-timings.json पूरे कॉन्फ़िगरेशन को फ़िल्टर किए गए शार्ड से अलग पहचान सके।
• Linux Node शार्ड जॉब Vitest के प्रायोगिक फ़ाइलसिस्टम मॉड्यूल कैश को अपस्ट्रीम Actions कैश API के माध्यम से बनाए रखते हैं, जिसे Blacksmith अपने रनर पर पारदर्शी रूप से तेज़ करता है। प्रत्येक CI शार्ड केवल-रीस्टोर होता है और संरक्षित सीड को अपने रनर-स्थानीय रूट में अनपैक करता है; फिर शार्ड रैपर समवर्ती Vitest प्रक्रियाओं को अलग-अलग लाइव उपनिर्देशिकाएँ देता है। केवल रद्द न होने वाला दैनिक या स्पष्ट रूप से डिस्पैच किया गया वार्मर नया अपरिवर्तनीय आर्काइव सहेजता है, इसलिए पुल रिक्वेस्ट ट्रांसफ़ॉर्म प्रकाशित नहीं कर सकतीं या प्रति-PR कैश फ़ैमिली नहीं बना सकतीं। ट्रांसफ़ॉर्म-इनपुट फ़िंगरप्रिंट असंगत लॉकफ़ाइल, पैकेज, tsconfig और Vitest-कॉन्फ़िग पीढ़ियों को साफ़ करता है। संरक्षित राइटर अपने रीस्टोर किए गए कैश को 2 GiB से अधिक होने पर स्कैन करके 75% तक प्रून करता है। Vitest मॉड्यूल आईडी, स्रोत सामग्री, एनवायरनमेंट और रिज़ॉल्व किए गए ट्रांसफ़ॉर्म कॉन्फ़िगरेशन का हैश बनाता है, इसलिए सामान्य आंशिक स्रोत बदलाव अपरिवर्तित प्रविष्टियों को वार्म रखते हैं, जबकि बदले हुए मॉड्यूल सुरक्षित रूप से मिस होते हैं। मोटे रीस्टोर प्रीफ़िक्स वर्कफ़्लो रन के बीच सेतु बनाते हैं; सामान्य Actions कैश LRU और निष्क्रियता निष्कासन पुराने अपरिवर्तनीय आर्काइव को सीमित करते हैं।
• विश्वसनीय Linux Node जॉब, प्रत्येक समर्थित Node लाइन के लिए एक संरक्षित डिपेंडेंसी डिस्क से pnpm स्टोर और node_modules को भी बाइंड करते हैं। पैकेज मैनिफ़ेस्ट, इंस्टॉल सेटिंग, रनर प्लेटफ़ॉर्म और सटीक Node पैच डिस्क कुंजी से बाहर रहते हैं; सटीक रनटाइम और इंस्टॉल-इनपुट फ़िंगरप्रिंट तय करता है कि जॉब ट्री का पुनः उपयोग करेगा या पुनः इंस्टॉल करके उसी डिस्क को रीफ़्रेश करेगा। हैशिंग से पहले मैनिफ़ेस्ट को कैनोनिकल बनाया जाता है। ऑडिट किए गए प्रत्यक्ष रूट हुक केवल pnpm की इंस्टॉल लाइफ़साइकल स्क्रिप्ट बनाए रखते हैं, इसलिए फ़ॉर्मैटिंग और सामान्य टेस्ट/बिल्ड स्क्रिप्ट संपादन डिपेंडेंसी ट्री को वार्म रखते हैं; बिना ऑडिट वाली लाइफ़साइकल-हुक ड्रिफ़्ट तब तक फ़ेल-क्लोज़ होती है, जब तक उसके स्रोत इनपुट फ़िंगरप्रिंट अनुबंध में शामिल नहीं हो जाते। डिपेंडेंसी, पैकेज-मैनेजर, हुक-स्रोत और लॉकफ़ाइल बदलाव हमेशा स्नैपशॉट को अमान्य करते हैं। मिलता हुआ फ़िंगरप्रिंट आवश्यक है, लेकिन पर्याप्त नहीं: सेटअप इम्पोर्टर आर्काइव और मैनिफ़ेस्ट चेकसम भी जाँचता है, फिर postinstall द्वारा बनाए रखी गई रजिस्ट्री-समर्थित लॉकफ़ाइल डिपेंडेंसी को उन पैकेज मैनिफ़ेस्ट के विरुद्ध सत्यापित करता है जिन्हें Node उनके इम्पोर्टर से रिज़ॉल्व करता है। अनुपस्थित या पुरानी इम्पोर्टर सामग्री रूट होइस्ट प्रदान करने के बजाय नए इंस्टॉल पर फ़ॉलबैक करती है। ऐसी पुल रिक्वेस्ट जिसका केवल-पढ़ने योग्य स्नैपशॉट अनुपयोगी है, वर्कस्पेस बाइंड को अलग करके रनर-स्थानीय स्टोरेज में इंस्टॉल करती है, जिससे ऐसे क्लोन पर धीमी राइट से बचा जाता है जिसे वह प्रकाशित नहीं कर सकती। स्टिकी कोल्ड इंस्टॉल pnpm के आंतरिक फ़ेच पुनःप्रयास अक्षम करते हैं और क्रमशः वार्म होते स्टोर से अधिकतम तीन सीमित पूर्ण-इंस्टॉल प्रयास करते हैं; टाइमआउट फिर भी विफलता रहता है। सामग्री-सत्यापित रीस्टोर या फ़्रोज़न-लॉकफ़ाइल इंस्टॉल के बाद, सेटअप pnpm की अनावश्यक प्री-रन डिपेंडेंसी जाँच अक्षम करता है: रिपॉज़िटरी जानबूझकर Plugin-स्थानीय node_modules को प्रून करती है, जिसे pnpm अन्यथा पुराना मानकर शार्ड फ़ैनआउट के दौरान असुरक्षित समवर्ती निहित इंस्टॉल के माध्यम से सुधारता है। कैनोनिकल main प्रीफ़्लाइट एकमात्र राइटर है और प्रत्येक रीफ़्रेश पर स्टोर को मापता है तथा सेवानिवृत्त पैकेज संस्करणों द्वारा इसे 8 GiB से ऊपर धकेलने के बाद ही pnpm store prune चलाता है। राइटर जॉब पूरा होने के बाद भी Blacksmith स्नैपशॉट प्रकाशन असिंक्रोनस होता है, इसलिए नई कुंजी या फ़िंगरप्रिंट के बाद पहला रन कोल्ड रह सकता है; बाद के सामग्री-सत्यापित सटीक-मार्कर रीस्टोर रोलआउट का प्रमाण हैं। आवश्यक CI जॉब और पुल रिक्वेस्ट को डिस्पोज़ेबल क्लोन मिलते हैं, इसलिए डिपेंडेंसी बदलाव नई डिस्क, प्रतिस्पर्धी स्नैपशॉट या बिल्ड रद्द कर सकने वाला कैश लॉक नहीं बनाते।
• Node शार्ड और बिल्ड-आर्टिफ़ैक्ट जॉब अपरिवर्तनीय Actions कैश के माध्यम से Node के पोर्टेबल ऑन-डिस्क कम्पाइल कैश को भी रीस्टोर करते हैं। स्वतंत्र test और build नेमस्पेस उनके राइटर को एक-दूसरे के आर्काइव बदलने से रोकते हैं: शेड्यूल किया गया टेस्ट वार्मर संरक्षित टेस्ट सीड का स्वामी है, जबकि build-artifacts विश्वसनीय main पुश से प्रति UTC दिन अधिकतम एक संरक्षित बिल्ड आर्काइव प्रकाशित कर सकता है। PR और सामान्य टेस्ट जॉब केवल संरक्षित स्नैपशॉट पढ़ते हैं, इसलिए फ़ीचर-ब्रांच बाइटकोड कभी साझा सीड में प्रवेश नहीं करता और PR ट्रैफ़िक कोई कैश आर्काइव नहीं बनाता। यह अलग-अलग चेकआउट पाथ में Node द्वारा लोड किए गए ऑर्केस्ट्रेशन, बिल्ड टूलिंग और बाहरी डिपेंडेंसी के लिए V8 बाइटकोड का पुनः उपयोग करता है, जिसमें स्रोत ग्राफ़ का केवल कुछ भाग बदलने की स्थिति भी शामिल है। Vitest चाइल्ड प्रक्रियाएँ विरासत में मिले कम्पाइल कैश को अक्षम करती हैं, क्योंकि डायनेमिक कॉन्फ़िगरेशन के भीतर कवरेज सक्षम किया जा सकता है और बाइटकोड से स्क्रिप्ट डीसीरियलाइज़ होने पर V8 कवरेज स्रोत-स्थिति की सटीकता खो सकती है।
• बिल्ड-आर्टिफ़ैक्ट जॉब सामग्री-फ़िंगरप्रिंट किए गए build-all चरण आउटपुट को भी बनाए रखता है। CI की स्वयं निर्मित Plugin SDK घोषणाएँ रिपॉज़िटरी-स्वामित्व वाले संपूर्ण TypeScript/JSON स्रोत ग्राफ़ का हैश बनाती हैं, इंस्टॉल की गई और जनरेट की गई निर्देशिकाओं को बाहर रखती हैं और tsdown द्वारा dist साफ़ करने के बाद फ़्लैट घोषणाओं तथा पैकेज ब्रिज, दोनों को रीस्टोर करती हैं। उस ग्राफ़ के बाहर के दस्तावेज़, वर्कफ़्लो, Plugin और अन्य बदलाव घोषणा स्नैपशॉट का पुनः उपयोग कर सकते हैं; स्रोत बदलाव एक्सपोर्ट गेट चलने से पहले इसका पुनर्निर्माण करते हैं।
• पूर्ण घोषणा बिल्ड tsdown को AI, वर्कस्पेस-पैकेज और एकीकृत समूहों में विभाजित करते हैं। प्रत्येक समूह केवल घोषणाओं को कैश करता है, फिर भी उन घोषणाओं को रीस्टोर करने से पहले रनटाइम JavaScript का पुनर्निर्माण करता है। इसलिए कोर या Plugin बदलाव केवल बड़े एकीकृत ग्राफ़ को अमान्य करते हैं, जबकि वर्कस्पेस-पैकेज बदलाव सावधानीपूर्वक प्रत्येक आश्रित घोषणा समूह को अमान्य करते हैं। सार्वजनिक पूर्ण बिल्ड सामान्यतः अपरिवर्तनीय Actions कैश का उपयोग करते हैं; मोटी रीस्टोर कुंजियाँ आंशिक बदलावों को सीड करती हैं, प्रति-समूह सामग्री फ़िंगरप्रिंट पुराने डेटा को अस्वीकार करते हैं और GitHub का कैश कोटा पुरानी पीढ़ियों को निष्कासित करता है। इसके बजाय साप्ताहिक Node 22 लेन सफल main रन के बाद 14-दिन का आर्टिफ़ैक्ट प्रकाशित करती है और केवल उन्हीं आर्टिफ़ैक्ट को रीस्टोर करती है जिनकी अपरिवर्तनीय निर्माता पहचान main पर उस वर्कफ़्लो में रिज़ॉल्व होती है, जिससे PR कोड को साझा कैश में लिखने की अनुमति दिए बिना कोटा चर्न से बचा जाता है। निजी-QA घोषणाएँ Actions कैश में कभी बनाए नहीं रखी जातीं, क्योंकि कैश नेमस्पेस गोपनीयता सीमाएँ नहीं हैं।
• check-additional-* पूरक सीमा गार्ड सूची (scripts/run-additional-boundary-checks.mjs) को एक प्रॉम्प्ट-भारी शार्ड (check-additional-boundaries-a, जिसमें Codex प्रॉम्प्ट स्नैपशॉट ड्रिफ़्ट जाँच शामिल है) और शेष स्ट्राइप के लिए एक संयुक्त शार्ड (check-additional-boundaries-bcd) में बाँटता है; प्रत्येक स्वतंत्र गार्ड को समवर्ती रूप से चलाता है और प्रति-जाँच टाइमिंग प्रिंट करता है। पैकेज-सीमा कम्पाइल/कैनरी कार्य साथ रहता है और रनटाइम टोपोलॉजी आर्किटेक्चर, build-artifacts में अंतर्निहित Gateway वॉच कवरेज से अलग चलता है।
• 32-vCPU स्व-होस्टेड बिल्ड रनर पर, dist/ और dist-runtime/ के पहले ही बन जाने के बाद Gateway वॉच, चैनल टेस्ट और कोर समर्थन-सीमा शार्ड build-artifacts के भीतर एक साथ शुरू होते हैं। GitHub-होस्टेड फ़ॉलबैक रन Gateway वॉच को सीरियल रखते हैं, ताकि कम-कोर प्रतिस्पर्धा उसकी तत्परता समय-सीमा का उपभोग न कर सके।

​

ClawSweeper गतिविधि अग्रेषण

• clawsweeper_item सटीक इश्यू और पुल रिक्वेस्ट समीक्षा अनुरोधों के लिए;
• clawsweeper_comment इश्यू टिप्पणियों में स्पष्ट ClawSweeper कमांड के लिए;
• clawsweeper_commit_review main पुश पर कमिट-स्तरीय समीक्षा अनुरोधों के लिए;
• github_activity सामान्य GitHub गतिविधि के लिए, जिसका ClawSweeper एजेंट निरीक्षण कर सकता है।

​

मैन्युअल डिस्पैच

gh workflow run ci.yml --ref release/YYYY.M.PATCH
gh workflow run ci.yml --ref main -f target_ref=<branch-or-sha> -f include_android=true
gh workflow run full-release-validation.yml --ref main -f ref=<branch-or-sha>

​

रनर

​

रनर पंजीकरण बजट

​

सतह रैचेट

• config/env-var-count-budget.txt, src/, packages/ और extensions/ के अंतर्गत उत्पादन स्रोत में अलग-अलग OPENCLAW_* नामों की संख्या सीमित करता है (परीक्षण और QA Lab शामिल नहीं)। इसकी जाँच node scripts/check-env-var-count.mjs करता है। एनवायरनमेंट वेरिएबल हटाते समय: उसी PR में संख्या घटाएँ। एक जोड़ना कॉन्फ़िगरेशन-सतह संबंधी निर्णय है — PR बॉडी में इसका औचित्य दें।
• docs/.generated/config-baseline.counts.json, प्रत्येक प्रकार (कोर/चैनल/Plugin) के openclaw.json स्कीमा प्रविष्टि की संख्या सीमित करता है। इसकी जाँच pnpm config:docs:check करता है; किसी भी स्कीमा परिवर्तन के बाद pnpm config:docs:gen के साथ फिर से जनरेट करें।

​

स्थानीय समकक्ष

pnpm changed:lanes                            # origin/main...HEAD के लिए स्थानीय changed-lane classifier का निरीक्षण करें
pnpm check:changed                            # स्मार्ट स्थानीय जाँच गेट: सीमा लेन के अनुसार बदली हुई फ़ॉर्मैटिंग/typecheck/lint/guards
pnpm check                                    # तेज़ स्थानीय गेट: prod tsgo + sharded lint + समानांतर तेज़ guards
pnpm check:test-types
pnpm check:timed                              # प्रत्येक चरण के समय सहित वही गेट
pnpm build:strict-smoke
pnpm check:architecture
pnpm test:gateway:watch-regression
OPENCLAW_TUI_PTY_INCLUDE_LOCAL=1 node scripts/run-vitest.mjs run --config test/vitest/vitest.tui-pty.config.ts
pnpm test                                     # vitest परीक्षण
pnpm test:changed                             # कम लागत वाले स्मार्ट बदले हुए Vitest लक्ष्य
pnpm test:ui                                  # Control UI यूनिट/ब्राउज़र सुइट
pnpm ui:i18n:check                            # जनरेट की गई Control UI लोकेल समानता (रिलीज़ गेट)
pnpm native:i18n:baseline                     # स्रोत-स्वामित्व वाली नेटिव निष्कर्षण इन्वेंट्री अपडेट करें
pnpm native:i18n:verify                       # स्रोत इन्वेंट्री + Android/Apple स्थानीयकरण सुरक्षा
pnpm native:i18n:check                        # सख्त अनुवादित/प्लेटफ़ॉर्म-जनरेटेड समानता (रिलीज़ गेट)
pnpm test:channels
pnpm test:contracts:channels
pnpm check:docs                               # दस्तावेज़ फ़ॉर्मैट + lint + टूटे हुए लिंक
pnpm build                                    # जब CI आर्टिफ़ैक्ट/स्मोक जाँच महत्वपूर्ण हों, तब dist बिल्ड करें
pnpm ios:build                                # iOS ऐप प्रोजेक्ट जनरेट और बिल्ड करें
pnpm ci:timings                               # नवीनतम origin/main push CI रन का सारांश दें
pnpm ci:timings:recent                        # हाल के सफल main CI रन की तुलना करें
node scripts/ci-run-timings.mjs <run-id>      # कुल समय, कतार समय और सबसे धीमे जॉब का सारांश दें
node scripts/ci-run-timings.mjs --latest-main # issue/comment शोर को अनदेखा करें और origin/main push CI चुनें
node scripts/ci-run-timings.mjs --recent 10   # हाल के सफल main CI रन की तुलना करें
pnpm test:perf:groups --full-suite --allow-failures --output .artifacts/test-perf/baseline-before.json
pnpm test:perf:groups:compare .artifacts/test-perf/baseline-before.json .artifacts/test-perf/after-agent.json
pnpm test:startup:memory
pnpm test:extensions:memory -- --json .artifacts/openclaw-performance/source/mock-provider/extension-memory.json
pnpm perf:kova:summary --report .artifacts/kova/reports/mock-provider/report.json --output .artifacts/kova/summary.md

​

OpenClaw प्रदर्शन

gh workflow run openclaw-performance.yml --ref main -f profile=diagnostic -f repeat=3
gh workflow run openclaw-performance.yml --ref main -f profile=smoke -f repeat=1 -f deep_profile=true -f live_openai_candidate=true
gh workflow run openclaw-performance.yml --ref main -f target_ref=v2026.5.2 -f profile=diagnostic -f repeat=3

• mock-provider: नियतात्मक नकली OpenAI-संगत प्रमाणीकरण वाले स्थानीय-बिल्ड रनटाइम पर Kova निदान परिदृश्य।
• mock-deep-profile: स्टार्टअप, Gateway और एजेंट-टर्न हॉटस्पॉट के लिए CPU/हीप/ट्रेस प्रोफ़ाइलिंग। शेड्यूल पर या deep_profile=true के साथ डिस्पैच करने पर चलता है।
• live-openai-candidate: एक वास्तविक OpenAI openai/gpt-5.6-luna एजेंट टर्न, जिसे OPENAI_API_KEY अनुपलब्ध होने पर छोड़ दिया जाता है। शेड्यूल पर या live_openai_candidate=true के साथ डिस्पैच करने पर चलता है।

​

पूर्ण रिलीज़ सत्यापन

gh workflow run openclaw-release-publish.yml \
  --ref main \
  -f tag=vYYYY.M.PATCH-beta.N \
  -f preflight_run_id=<successful-openclaw-npm-preflight-run-id> \
  -f full_release_validation_run_id=<successful-full-release-validation-run-id> \
  -f full_release_validation_run_attempt=<successful-full-release-validation-run-attempt> \
  -f npm_dist_tag=beta

pnpm ci:full-release --sha <full-sha>

• beta सबसे तेज़ OpenAI/मुख्य रिलीज़-महत्वपूर्ण लेन बनाए रखता है।
• stable स्थिर प्रदाता/बैकएंड समूह जोड़ता है।
• full व्यापक परामर्शात्मक प्रदाता/मीडिया मैट्रिक्स चलाता है।

​

लाइव और E2E शार्ड

• native-live-src-agents और native-live-src-agents-zai-coding
• native-live-src-gateway-core
• प्रोवाइडर-फ़िल्टर किए गए native-live-src-gateway-profiles जॉब
• native-live-src-gateway-backends
• native-live-src-infra
• native-live-test
• native-live-extensions-a-k
• native-live-extensions-l-n
• native-live-extensions-moonshot
• native-live-extensions-openai
• native-live-extensions-o-z-other
• native-live-extensions-xai
• अलग मीडिया ऑडियो/वीडियो शार्ड और प्रोवाइडर-फ़िल्टर किए गए संगीत शार्ड

​

पैकेज स्वीकृति

​

जॉब

1. resolve_package, workflow_ref को चेक आउट करता है, एक पैकेज कैंडिडेट रिज़ॉल्व करता है, .artifacts/docker-e2e-package/openclaw-current.tgz लिखता है, .artifacts/docker-e2e-package/package-candidate.json लिखता है, दोनों को package-under-test आर्टिफ़ैक्ट के रूप में अपलोड करता है, और GitHub चरण सारांश में स्रोत, वर्कफ़्लो रेफ़, पैकेज रेफ़, संस्करण, SHA-256, और प्रोफ़ाइल प्रिंट करता है।
2. package_integrity, package-under-test आर्टिफ़ैक्ट डाउनलोड करता है और scripts/check-openclaw-package-tarball.mjs के साथ सार्वजनिक पैकेज टारबॉल अनुबंध लागू करता है।
3. docker_acceptance, रिज़ॉल्व किए गए पैकेज स्रोत SHA (workflow_ref पर फ़ॉलबैक करते हुए) और package_artifact_name=package-under-test के साथ openclaw-live-and-e2e-checks-reusable.yml को कॉल करता है। पुनः प्रयोज्य वर्कफ़्लो उस आर्टिफ़ैक्ट को डाउनलोड करता है, टारबॉल इन्वेंटरी सत्यापित करता है, आवश्यकता होने पर पैकेज-डाइजेस्ट Docker इमेज तैयार करता है, और वर्कफ़्लो चेकआउट को पैक करने के बजाय उस पैकेज के विरुद्ध चयनित Docker लेन चलाता है। जब कोई प्रोफ़ाइल कई लक्षित docker_lanes चुनती है, तो पुनः प्रयोज्य वर्कफ़्लो पैकेज और साझा इमेज एक बार तैयार करता है, फिर उन लेन को विशिष्ट आर्टिफ़ैक्ट वाले समानांतर लक्षित Docker जॉब के रूप में फैलाता है।
4. package_telegram वैकल्पिक रूप से NPM Telegram Beta E2E को कॉल करता है। यह तब चलता है जब telegram_mode, none नहीं होता और पैकेज स्वीकृति द्वारा रिज़ॉल्व किए जाने पर वही package-under-test आर्टिफ़ैक्ट इंस्टॉल करता है; स्वतंत्र Telegram डिस्पैच अब भी प्रकाशित npm स्पेक इंस्टॉल कर सकता है।
5. summary, पैकेज रिज़ॉल्यूशन, अखंडता, Docker स्वीकृति, या वैकल्पिक Telegram लेन विफल होने पर वर्कफ़्लो को विफल करता है। advisory इनपुट परामर्शात्मक कॉलर के लिए स्वीकृति विफलताओं को चेतावनियों में घटा देता है।

​

कैंडिडेट स्रोत

• source=npm केवल openclaw@extended-stable, openclaw@beta, openclaw@latest, या openclaw@2026.4.27-beta.2 जैसे सटीक OpenClaw रिलीज़ संस्करण को स्वीकार करता है। इसका उपयोग प्रकाशित विस्तारित-स्थिर, प्रीरिलीज़, या स्थिर स्वीकृति के लिए करें।
• source=ref किसी विश्वसनीय package_ref ब्रांच, टैग, या पूर्ण कमिट SHA को पैक करता है। रिज़ॉल्वर OpenClaw ब्रांच/टैग फ़ेच करता है, सत्यापित करता है कि चयनित कमिट रिपॉज़िटरी ब्रांच इतिहास या किसी रिलीज़ टैग से पहुँच योग्य है, डिटैच्ड वर्कट्री में निर्भरताएँ इंस्टॉल करता है, और इसे scripts/package-openclaw-for-docker.mjs के साथ पैक करता है।
• source=url कोई सार्वजनिक HTTPS .tgz डाउनलोड करता है; package_sha256 आवश्यक है। यह पथ URL क्रेडेंशियल, गैर-डिफ़ॉल्ट HTTPS पोर्ट, निजी/आंतरिक/विशेष-उपयोग होस्टनाम या रिज़ॉल्व किए गए IP, और समान सार्वजनिक सुरक्षा नीति के बाहर के रीडायरेक्ट अस्वीकार करता है।
• source=trusted-url, .github/package-trusted-sources.json में नामित विश्वसनीय-स्रोत नीति से HTTPS .tgz डाउनलोड करता है; package_sha256 और trusted_source_id आवश्यक हैं। इसका उपयोग केवल मेंटेनर-स्वामित्व वाले एंटरप्राइज़ मिरर या निजी पैकेज रिपॉज़िटरी के लिए करें, जिन्हें कॉन्फ़िगर किए गए होस्ट, पोर्ट, पथ प्रीफ़िक्स, रीडायरेक्ट होस्ट, या निजी-नेटवर्क रिज़ॉल्यूशन की आवश्यकता होती है। यदि नीति बियरर प्रमाणीकरण घोषित करती है, तो वर्कफ़्लो निश्चित OPENCLAW_TRUSTED_PACKAGE_TOKEN सीक्रेट का उपयोग करता है; URL में एम्बेड किए गए क्रेडेंशियल अब भी अस्वीकार किए जाते हैं।
• source=artifact, artifact_run_id और artifact_name से एक .tgz डाउनलोड करता है; package_sha256 वैकल्पिक है लेकिन बाहरी रूप से साझा किए गए आर्टिफ़ैक्ट के लिए इसे दिया जाना चाहिए।

​

सुइट प्रोफ़ाइल

• smoke — npm-onboard-channel-agent, gateway-network, config-reload
• package — npm-onboard-channel-agent, doctor-switch, update-channel-switch, skill-install, update-corrupt-plugin, upgrade-survivor, published-upgrade-survivor, root-managed-vps-upgrade, update-restart-auth, plugins-offline, plugin-update
• product — plugins-offline के बजाय लाइव plugins कवरेज वाला package सेट, साथ में mcp-channels, cron-mcp-cleanup, openai-web-search-minimal, openwebui
• full — OpenWebUI के साथ पूर्ण Docker रिलीज़-पथ खंड
• custom — सटीक docker_lanes; suite_profile=custom होने पर आवश्यक

​

लेगेसी संगतता अवधियाँ

• dist/postinstall-inventory.json में ज्ञात निजी QA प्रविष्टियाँ टारबॉल से छोड़ी गई फ़ाइलों की ओर संकेत कर सकती हैं;
• जब पैकेज वह फ़्लैग उजागर नहीं करता, तब doctor-switch, gateway install --wrapper स्थायित्व उप-मामले को छोड़ सकता है;
• update-channel-switch टारबॉल से प्राप्त नकली git फ़िक्स्चर से अनुपलब्ध pnpm patchedDependencies हटा सकता है और अनुपलब्ध स्थायी update.channel को लॉग कर सकता है;
• Plugin स्मोक परीक्षण पुरानी इंस्टॉल-रिकॉर्ड लोकेशन पढ़ सकते हैं या मार्केटप्लेस इंस्टॉल-रिकॉर्ड स्थायित्व की अनुपस्थिति स्वीकार कर सकते हैं;
• plugin-update कॉन्फ़िग मेटाडेटा माइग्रेशन की अनुमति दे सकता है, जबकि इंस्टॉल रिकॉर्ड और पुनः इंस्टॉल न करने वाला व्यवहार अपरिवर्तित रहना आवश्यक है।

​

उदाहरण

# उत्पाद-स्तरीय कवरेज के साथ वर्तमान बीटा पैकेज को सत्यापित करें।
gh workflow run package-acceptance.yml \
  --ref main \
  -f workflow_ref=main \
  -f source=npm \
  -f package_spec=openclaw@beta \
  -f suite_profile=product \
  -f telegram_mode=mock-openai

# पैकेज कवरेज के साथ प्रकाशित विस्तारित-स्थिर पैकेज को सत्यापित करें।
gh workflow run package-acceptance.yml \
  --ref main \
  -f workflow_ref=main \
  -f source=npm \
  -f package_spec=openclaw@extended-stable \
  -f suite_profile=package \
  -f telegram_mode=mock-openai

# वर्तमान हार्नेस के साथ किसी रिलीज़ ब्रांच को पैक और सत्यापित करें।
gh workflow run package-acceptance.yml \
  --ref main \
  -f workflow_ref=main \
  -f source=ref \
  -f package_ref=release/YYYY.M.PATCH \
  -f suite_profile=package \
  -f telegram_mode=mock-openai

# टारबॉल URL को सत्यापित करें। source=url के लिए SHA-256 अनिवार्य है।
gh workflow run package-acceptance.yml \
  --ref main \
  -f workflow_ref=main \
  -f source=url \
  -f package_url=https://example.com/openclaw-current.tgz \
  -f package_sha256=<64-char-sha256> \
  -f suite_profile=smoke

# नामित विश्वसनीय निजी मिरर नीति से टारबॉल को सत्यापित करें।
gh workflow run package-acceptance.yml \
  --ref main \
  -f workflow_ref=main \
  -f source=trusted-url \
  -f trusted_source_id=enterprise-artifactory \
  -f package_url=https://packages.example.internal:8443/artifactory/openclaw/openclaw-current.tgz \
  -f package_sha256=<64-char-sha256> \
  -f suite_profile=smoke

# किसी अन्य Actions रन द्वारा अपलोड किए गए टारबॉल का पुनः उपयोग करें।
gh workflow run package-acceptance.yml \
  --ref main \
  -f workflow_ref=main \
  -f source=artifact \
  -f artifact_run_id=<run-id> \
  -f artifact_name=package-under-test \
  -f suite_profile=custom \
  -f docker_lanes='install-e2e plugin-update'

​

इंस्टॉल स्मोक परीक्षण

• रूट Dockerfile स्मोक इमेज प्रत्येक लक्ष्य SHA के लिए एक बार बनाई जाती है, उसे अपरिवर्तनीय कलाकृति में वर्कफ़्लो संशोधन और निर्माता प्रयास से बाँधा जाता है, फिर CLI स्मोक, साझा-वर्कस्पेस CLI स्मोक हटाने वाले एजेंट, कंटेनर Gateway-नेटवर्क E2E और बंडल किए गए matrix Plugin बिल्ड-आर्ग स्मोक द्वारा लोड किया जाता है। Plugin स्मोक रनटाइम निर्भरता इंस्टॉल मिररिंग और प्रवेश-एस्केप निदान के बिना Plugin लोड होने की पुष्टि करता है।
• QR पैकेज इंस्टॉल और इंस्टॉलर/अपडेट Docker स्मोक परीक्षण (Rocky Linux इंस्टॉलर लेन और कॉन्फ़िगर करने योग्य update_baseline_version npm बेसलाइन के विरुद्ध अपडेट लेन सहित) अलग-अलग जॉब के रूप में चलते हैं, ताकि इंस्टॉलर कार्य को रूट इमेज स्मोक परीक्षणों के पीछे प्रतीक्षा न करनी पड़े।

​

स्थानीय Docker E2E

• इंस्टॉलर/अपडेट/Plugin-निर्भरता लेनों के लिए एक साधारण Node/Git रनर;
• एक कार्यात्मक इमेज, जो सामान्य कार्यक्षमता लेनों के लिए उसी टारबॉल को /app में इंस्टॉल करती है।

​

समायोज्य मान

​

पुनः उपयोग योग्य लाइव/E2E वर्कफ़्लो

​

रिलीज़-पथ खंड

• OPENCLAW_DOCKER_ALL_PROFILE=release-path
• OPENCLAW_DOCKER_ALL_CHUNK=core | package-update-openai | package-update-anthropic | package-update-core | plugins-runtime-plugins | plugins-runtime-services | plugins-runtime-install-a..h | openwebui

pnpm test:docker:rerun <run-id>      # Docker कलाकृतियाँ डाउनलोड करें और संयुक्त/प्रति-लेन लक्षित पुनः रन कमांड प्रिंट करें
pnpm test:docker:timings <summary>   # धीमी-लेन और चरण क्रिटिकल-पथ सारांश

​

Plugin प्रीरिलीज़

​

QA Lab

• QA-Lab - All Lanes वर्कफ़्लो main पर हर रात और मैन्युअल डिस्पैच पर चलता है; यह मॉक समानता के साथ लाइव Matrix, Telegram, Discord, WhatsApp और Slack जॉब में फैलता है। लाइव जॉब qa-live-shared एनवायरनमेंट का उपयोग करते हैं; Telegram, Discord, WhatsApp और Slack Convex लीज़ का उपयोग करते हैं, जबकि Matrix अस्थायी स्थानीय क्रेडेंशियल उपलब्ध कराता है।

​

CodeQL

​

सुरक्षा श्रेणियाँ

​

प्लेटफ़ॉर्म-विशिष्ट सुरक्षा शार्ड

• CodeQL Android Critical Security — शेड्यूल किया गया Android सुरक्षा शार्ड। वर्कफ़्लो सैनिटी द्वारा स्वीकार किए गए सबसे छोटे Blacksmith Linux रनर पर CodeQL के लिए Android ऐप को मैन्युअल रूप से बिल्ड करता है। /codeql-critical-security/android के अंतर्गत अपलोड करता है।
• CodeQL macOS Critical Security — साप्ताहिक/मैन्युअल macOS सुरक्षा शार्ड। Blacksmith macOS पर CodeQL के लिए macOS ऐप को मैन्युअल रूप से बिल्ड करता है, अपलोड किए गए SARIF से निर्भरता बिल्ड परिणाम फ़िल्टर करता है और /codeql-critical-security/macos के अंतर्गत अपलोड करता है। इसे दैनिक डिफ़ॉल्ट से बाहर रखा गया है, क्योंकि साफ़ स्थिति में भी macOS बिल्ड अधिकांश रनटाइम लेता है।

​

गंभीर गुणवत्ता श्रेणियाँ

profile=all|agent-runtime-boundary|config-boundary|core-auth-secrets|channel-runtime-boundary|gateway-runtime-boundary|memory-runtime-boundary|mcp-process-runtime-boundary|network-runtime-boundary|plugin-boundary|plugin-sdk-package-contract|plugin-sdk-reply-runtime|provider-runtime-boundary|session-diagnostics-boundary

​

रखरखाव वर्कफ़्लो

​

Docs Agent

​

Test Performance Agent

​

मर्ज के बाद डुप्लिकेट PR

gh workflow run duplicate-after-merge.yml \
  -f landed_pr=70532 \
  -f duplicate_prs='70530,70592' \
  -f apply=true

​

स्थानीय जाँच गेट और बदली हुई रूटिंग

​

कॉन्फ़िग आधारभूत गणना रैचेट

• कोर उत्पादन बदलाव कोर प्रोड और कोर परीक्षण टाइपचेक के साथ कोर लिंट/गार्ड चलाते हैं;
• केवल कोर परीक्षण बदलाव सिर्फ़ कोर परीक्षण टाइपचेक के साथ कोर लिंट चलाते हैं;
• एक्सटेंशन उत्पादन बदलाव एक्सटेंशन प्रोड और एक्सटेंशन परीक्षण टाइपचेक के साथ एक्सटेंशन लिंट चलाते हैं;
• केवल एक्सटेंशन परीक्षण बदलाव एक्सटेंशन परीक्षण टाइपचेक के साथ एक्सटेंशन लिंट चलाते हैं;
• सार्वजनिक Plugin SDK या Plugin-अनुबंध बदलाव एक्सटेंशन टाइपचेक तक विस्तृत होते हैं, क्योंकि एक्सटेंशन इन कोर अनुबंधों पर निर्भर हैं (Vitest एक्सटेंशन स्वीप स्पष्ट परीक्षण कार्य बने रहते हैं);
• केवल रिलीज़ मेटाडेटा संस्करण वृद्धि लक्षित संस्करण/कॉन्फ़िग/रूट-निर्भरता जाँच चलाती है;
• अज्ञात रूट/कॉन्फ़िग बदलाव सुरक्षित रूप से सभी जाँच लेन पर विफल होते हैं।

​

Testbox सत्यापन

pnpm crabbox:run -- --help | sed -n '1,120p'

node scripts/crabbox-wrapper.mjs run --provider blacksmith-testbox --timing-json --shell -- "pnpm test <path-or-filter>"

version="$(git -C ../crabbox describe --tags --always --dirty | sed 's/^v//')" \
  && go build -C ../crabbox -trimpath -ldflags "-s -w -X github.com/openclaw/crabbox/internal/cli.version=${version}" -o bin/crabbox ./cmd/crabbox

pnpm crabbox:run -- --provider blacksmith-testbox \
  --blacksmith-org openclaw \
  --blacksmith-workflow .github/workflows/ci-check-testbox.yml \
  --blacksmith-job check \
  --blacksmith-ref main \
  --idle-timeout 90m \
  --ttl 240m \
  --timing-json \
  --shell -- \
  "corepack pnpm check:changed"

pnpm crabbox:run -- --provider blacksmith-testbox \
  --idle-timeout 90m \
  --ttl 240m \
  --timing-json \
  --shell -- \
  "corepack pnpm test <path-or-filter>"

pnpm crabbox:run -- --provider blacksmith-testbox \
  --idle-timeout 90m \
  --ttl 240m \
  --timing-json \
  --shell -- \
  "corepack pnpm test"

blacksmith testbox list --all
blacksmith testbox status --id <tbx_id>
blacksmith testbox stop --id <tbx_id>

node scripts/crabbox-wrapper.mjs run --provider blacksmith-testbox --id <tbx_id> --timing-json --shell -- "corepack pnpm test <path-or-filter>"
pnpm crabbox:stop -- <tbx_id>

CRABBOX_CAPACITY_REGIONS=eu-west-1,eu-west-2,eu-central-1,us-east-1,us-west-2 \
  pnpm crabbox:warmup -- --provider aws --class standard --market on-demand --idle-timeout 90m
pnpm crabbox:hydrate -- --provider aws --id <cbx_id-or-slug>
pnpm crabbox:run -- --provider aws --id <cbx_id-or-slug> --timing-json --shell -- "pnpm check:changed"
pnpm crabbox:stop -- --provider aws <cbx_id-or-slug>

​

संबंधित

• इंस्टॉलेशन का अवलोकन
• विकास चैनल