टूल-लूप पहचान

OpenClaw में दोहराए जाने वाले टूल-कॉल पैटर्न के लिए दो सहयोगी गार्डरेल हैं:

1. लूप पहचान (tools.loopDetection.enabled) — डिफ़ॉल्ट रूप से अक्षम। दोहराए गए पैटर्न और अज्ञात-टूल पुनः प्रयासों के लिए रोलिंग टूल-कॉल इतिहास देखता है।
2. पोस्ट-Compaction गार्ड (tools.loopDetection.postCompactionGuard) — डिफ़ॉल्ट रूप से सक्षम, जब तक tools.loopDetection.enabled स्पष्ट रूप से false न हो। हर compaction-retry के बाद सक्रिय होता है और जब एजेंट विंडो के भीतर वही (tool, args, result) ट्रिपल उत्सर्जित करता है, तो रन को रोक देता है।

दोनों एक ही tools.loopDetection ब्लॉक के अंतर्गत कॉन्फ़िगर किए जाते हैं, लेकिन पोस्ट-Compaction गार्ड तब चलता है जब भी मास्टर स्विच स्पष्ट रूप से बंद नहीं होता। दोनों सतहों को शांत करने के लिए tools.loopDetection.enabled: false सेट करें।

यह क्यों मौजूद है

• ऐसी दोहराई जाने वाली अनुक्रमों का पता लगाना जो प्रगति नहीं करते।
• उच्च-आवृत्ति वाले बिना-परिणाम लूप का पता लगाना (वही टूल, वही इनपुट, दोहराई गई त्रुटियां)।
• ज्ञात पोलिंग टूल के लिए विशिष्ट दोहराए गए-कॉल पैटर्न का पता लगाना।
• context-overflow फिर Compaction फिर समान-लूप चक्रों को अनिश्चित काल तक चलने से रोकना।

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

वैश्विक डिफ़ॉल्ट, हर दस्तावेज़ित फ़ील्ड के साथ:

{  tools: {    loopDetection: {      enabled: false, // master switch for the rolling-history detectors      historySize: 30,      warningThreshold: 10,      criticalThreshold: 20,      unknownToolThreshold: 10,      globalCircuitBreakerThreshold: 30,      detectors: {        genericRepeat: true,        knownPollNoProgress: true,        pingPong: true,      },      postCompactionGuard: {        windowSize: 3, // armed after compaction-retry; runs unless enabled is explicitly false      },    },  },}

प्रति-एजेंट ओवरराइड (वैकल्पिक):

{  agents: {    list: [      {        id: "safe-runner",        tools: {          loopDetection: {            enabled: true,            warningThreshold: 8,            criticalThreshold: 16,          },        },      },    ],  },}

फ़ील्ड व्यवहार

exec के लिए, बिना-प्रगति जांच स्थिर कमांड परिणामों की तुलना करती हैं और अवधि, PID, सेशन ID, और कार्यशील डायरेक्टरी जैसी परिवर्ती रनटाइम मेटाडेटा को अनदेखा करती हैं। जब कोई रन id उपलब्ध होता है, तो हालिया टूल-कॉल इतिहास का मूल्यांकन केवल उसी रन के भीतर किया जाता है ताकि शेड्यूल किए गए Heartbeat चक्र और नए रन पहले के रन से पुराने लूप काउंट विरासत में न लें।

अनुशंसित सेटअप

• छोटे मॉडलों के लिए, enabled: true सेट करें और थ्रेशोल्ड को उनके डिफ़ॉल्ट पर छोड़ दें। फ्लैगशिप मॉडलों को शायद ही रोलिंग-हिस्ट्री पहचान की आवश्यकता होती है और वे मास्टर स्विच को false पर छोड़ सकते हैं, जबकि पोस्ट-Compaction गार्ड से अब भी लाभ ले सकते हैं।
• थ्रेशोल्ड को warningThreshold < criticalThreshold < globalCircuitBreakerThreshold क्रम में रखें।
• यदि फ़ॉल्स पॉज़िटिव होते हैं:
  • warningThreshold और/या criticalThreshold बढ़ाएं।
  • वैकल्पिक रूप से globalCircuitBreakerThreshold बढ़ाएं।
  • केवल समस्या पैदा करने वाले विशिष्ट डिटेक्टर को अक्षम करें (detectors.<name>: false)।
  • कम सख्त ऐतिहासिक संदर्भ के लिए historySize घटाएं।
• सब कुछ अक्षम करने के लिए (पोस्ट-Compaction गार्ड सहित), tools.loopDetection.enabled: false स्पष्ट रूप से सेट करें।

पोस्ट-Compaction गार्ड

जब रनर context-overflow के बाद compaction-retry पूरा करता है, तो यह एक छोटी-विंडो गार्ड सक्रिय करता है जो अगले कुछ टूल कॉल को देखता है। यदि एजेंट विंडो के भीतर कई बार वही (toolName, argsHash, resultHash) ट्रिपल उत्सर्जित करता है, तो गार्ड निष्कर्ष निकालता है कि Compaction ने लूप नहीं तोड़ा और रन को compaction_loop_persisted त्रुटि के साथ रोक देता है।

गार्ड मास्टर tools.loopDetection.enabled फ़्लैग से नियंत्रित होता है, एक मोड़ के साथ: यह तब सक्षम रहता है जब फ़्लैग unset या true हो और केवल तब निष्क्रिय होता है जब फ़्लैग स्पष्ट रूप से false हो। यह जानबूझकर है। गार्ड उन Compaction लूप से बचने के लिए मौजूद है जो अन्यथा असीमित टोकन खर्च करेंगे, इसलिए बिना-कॉन्फ़िग उपयोगकर्ता को भी सुरक्षा मिलती है।

{  tools: {    loopDetection: {      // master switch; set false to disable the guard along with the rolling detectors      enabled: true,      postCompactionGuard: {        windowSize: 3, // default      },    },  },}

• कम windowSize अधिक सख्त है (रोकने से पहले कम प्रयास)।
• अधिक windowSize एजेंट को अधिक रिकवरी प्रयास देता है।
• परिणाम बदलने पर गार्ड कभी नहीं रोकता, केवल तब जब परिणाम विंडो में बाइट-समान हों।
• यह जानबूझकर संकीर्ण है: यह केवल compaction-retry के तुरंत बाद सक्रिय होता है।

लॉग और अपेक्षित व्यवहार

जब कोई लूप पहचाना जाता है, OpenClaw एक लूप इवेंट रिपोर्ट करता है और गंभीरता के आधार पर अगले टूल-चक्र को या तो मंद करता है या ब्लॉक करता है। यह सामान्य टूल एक्सेस को बनाए रखते हुए उपयोगकर्ताओं को अनियंत्रित टोकन खर्च और लॉकअप से बचाता है।

• चेतावनियां पहले आती हैं।
• जब पैटर्न चेतावनी थ्रेशोल्ड से आगे बने रहते हैं, तो suppression होता है।
• गंभीर थ्रेशोल्ड अगले टूल-चक्र को ब्लॉक करते हैं और रन रिकॉर्ड में स्पष्ट लूप-डिटेक्शन कारण सतह पर लाते हैं।
• पोस्ट-Compaction गार्ड आपत्तिजनक टूल नाम और समान-कॉल गिनती के साथ compaction_loop_persisted त्रुटियां उत्सर्जित करता है।

संबंधित