Agent coordination
लक्ष्य
लक्ष्य
लक्ष्य वर्तमान OpenClaw सत्र से जुड़ा एक स्थायी उद्देश्य है। यह एजेंट और ऑपरेटर को लंबे समय तक चलने वाले कार्य के लिए एक साझा लक्ष्य देता है, बिना उस लक्ष्य को बैकग्राउंड कार्य, रिमाइंडर, Cron जॉब या स्थायी आदेश में बदले।
लक्ष्य सत्र की स्थिति हैं: वे सत्र कुंजी के साथ स्थानांतरित होते हैं, प्रक्रिया
पुनः आरंभ होने पर भी बने रहते हैं और /goal, मॉडल के लिए उपलब्ध लक्ष्य टूल और TUI
फ़ुटर में दिखाई देते हैं।
अलग किए गए कमांड के पूर्ण होने का परिणाम मूल उपयोगकर्ता-दृश्य थ्रेड पर लौटता है, इसलिए अगली बारी में वही लक्ष्य दिखाई देता रहता है, भले ही कमांड निष्पादन ने अलग सैंडबॉक्स नीति सत्र का उपयोग किया हो।
त्वरित शुरुआत
/goal start PR 87469 के लिए CI को सफल करें और सुधार पुश करें/goal/goal edit PR 87469 के लिए CI को सफल करें, सुधार पुश करें और दस्तावेज़ अपडेट करें/goal pause CI की प्रतीक्षा है/goal resume/goal complete पुश और सत्यापन पूरा हुआ/goal clearstart वैकल्पिक है: /goal get CI green for PR 87469 भी लक्ष्य बनाता है,
क्योंकि /goal के बाद का ऐसा कोई भी टेक्स्ट, जो ज्ञात कार्रवाई शब्द नहीं है,
नया उद्देश्य माना जाता है।
लक्ष्यों का उपयोग किसलिए होता है
लक्ष्य का उपयोग तब करें, जब किसी सत्र का कोई ठोस परिणाम हो जिसे कई बारियों के दौरान दृश्यमान रहना चाहिए:
- PR समापन: सुधार करें, सत्यापित करें, स्वतः समीक्षा करें, पुश करें और PR खोलें या अपडेट करें।
- डीबग प्रक्रिया: बग को पुनरुत्पादित करें, स्वामी सतह पहचानें, पैच लगाएँ और सुधार प्रमाणित करें।
- दस्तावेज़ चरण: संबंधित दस्तावेज़ पढ़ें, नया पृष्ठ लिखें, उसे परस्पर लिंक करें और दस्तावेज़ बिल्ड सत्यापित करें।
- रखरखाव कार्य: वर्तमान स्थिति जाँचें, सीमित बदलाव करें, सही जाँचें चलाएँ और हुए बदलावों की रिपोर्ट दें।
लक्ष्य कार्य कतार नहीं है। जब कार्य को अलग रहकर चलना हो, किसी समय-सारणी पर दोहराना हो, प्रबंधित उप-कार्यों में विभाजित होना हो या नीति के रूप में कायम रहना हो, तब Task Flow, कार्य, Cron जॉब या स्थायी आदेश का उपयोग करें।
कमांड संदर्भ
बिना आर्ग्युमेंट के /goal वर्तमान लक्ष्य का सारांश दिखाता है:
लक्ष्यस्थिति: सक्रियउद्देश्य: PR 87469 के लिए CI को सफल करें और सुधार पुश करेंउपयोग किए गए टोकन: 12kटोकन बजट: 12k/50k कमांड: /goal edit <objective>, /goal pause, /goal complete, /goal clear| कमांड | प्रभाव |
|---|---|
/goal या /goal status |
वर्तमान लक्ष्य दिखाएँ। |
/goal start <objective> |
वर्तमान सत्र के लिए नया लक्ष्य बनाएँ। |
/goal set <objective>, /goal create <objective> |
start के उपनाम। |
/goal <objective> |
यह भी नया लक्ष्य बनाता है (ऐसा कोई भी टेक्स्ट जो मान्य कार्रवाई शब्द नहीं है)। |
/goal edit <objective> |
वर्तमान उद्देश्य को नए शब्दों में लिखें; स्थिति और टोकन गणना अपरिवर्तित रहती है। |
/goal pause [note] |
सक्रिय लक्ष्य को रोकें। |
/goal resume [note] |
रोके गए, अवरुद्ध, उपयोग-सीमित या बजट-सीमित लक्ष्य को फिर शुरू करें। |
/goal complete [note] |
लक्ष्य को प्राप्त के रूप में चिह्नित करें। |
/goal done [note] |
complete का उपनाम। |
/goal block [note] |
लक्ष्य को अवरुद्ध के रूप में चिह्नित करें। |
/goal blocked [note] |
block का उपनाम। |
/goal clear |
सत्र से लक्ष्य हटाएँ। |
किसी सत्र में एक समय पर केवल एक लक्ष्य हो सकता है। वर्तमान लक्ष्य साफ़ किए जाने तक
दूसरा लक्ष्य शुरू करने पर Goal error: goal already exists त्रुटि मिलती है।
/goal start टोकन-बजट फ़्लैग स्वीकार नहीं करता; बजट केवल
मॉडल के लिए उपलब्ध create_goal टूल के माध्यम से निर्धारित किया जा सकता है।
स्थितियाँ
active: सत्र लक्ष्य को प्राप्त करने का प्रयास कर रहा है।paused: ऑपरेटर ने लक्ष्य रोक दिया है;/goal resumeइसे फिर सक्रिय करता है।blocked: एजेंट या ऑपरेटर ने वास्तविक अवरोध की सूचना दी है; नई जानकारी या स्थिति उपलब्ध होने पर/goal resumeइसे फिर सक्रिय करता है।budget_limited: कॉन्फ़िगर किया गया टोकन बजट पूरा हो गया है;/goal resumeनई बजट अवधि के साथ उसी उद्देश्य का प्रयास फिर शुरू करता है।usage_limited: भविष्य की उपयोग-सीमा रोक स्थिति के लिए आरक्षित;/goal resumeउसी तरह प्रयास फिर शुरू करता है।complete: लक्ष्य प्राप्त हो गया है। पूर्ण लक्ष्य अंतिम होते हैं; दूसरा लक्ष्य शुरू करने से पहले/goal clearका उपयोग करें।
/new और /reset वर्तमान सत्र का लक्ष्य साफ़ करते हैं, क्योंकि वे जानबूझकर
नए सत्र संदर्भ से शुरू करते हैं।
टोकन बजट
लक्ष्यों में वैकल्पिक धनात्मक टोकन बजट हो सकता है, जिसे
create_goal टूल के token_budget पैरामीटर से निर्धारित किया जाता है। बजट को
लक्ष्य बनाते समय सत्र की ताज़ा टोकन संख्या से मापा जाता है। यदि लक्ष्य शुरू होने पर सत्र में
केवल पुराना या अज्ञात टोकन स्नैपशॉट है, तो OpenClaw
अगले ताज़ा स्नैपशॉट की प्रतीक्षा करता है और उसे आधाररेखा के रूप में उपयोग करता है, ताकि लक्ष्य के
अस्तित्व में आने से पहले खर्च किए गए टोकन उसमें न गिने जाएँ।
जब उपयोग बजट तक पहुँचता है, तो लक्ष्य budget_limited में चला जाता है। इससे
लक्ष्य हटता या उद्देश्य मिटता नहीं है; यह ऑपरेटर और
एजेंट को बताता है कि लक्ष्य को फिर शुरू या साफ़ किए जाने तक उसे सक्रिय रूप से प्राप्त करने का प्रयास नहीं किया जा रहा है।
फिर शुरू करने पर वर्तमान ताज़ा टोकन
संख्या से नई बजट अवधि शुरू होती है।
टोकन बजट सत्र-लक्ष्य की सुरक्षा-सीमा है, बिलिंग सीमा नहीं। प्रदाता कोटा, लागत रिपोर्टिंग और संदर्भ-विंडो व्यवहार अब भी सामान्य OpenClaw उपयोग और मॉडल नियंत्रणों का उपयोग करते हैं।
मॉडल टूल
OpenClaw एजेंट हार्नेस के लिए तीन लक्ष्य टूल उपलब्ध कराता है:
| टूल | उद्देश्य |
|---|---|
get_goal |
वर्तमान सत्र लक्ष्य पढ़ें: स्थिति, उद्देश्य, टोकन उपयोग और टोकन बजट। |
create_goal |
लक्ष्य केवल तभी बनाएँ जब उपयोगकर्ता या सिस्टम निर्देश स्पष्ट रूप से इसका अनुरोध करें। सत्र में पहले से लक्ष्य होने पर विफल होता है। |
update_goal |
लक्ष्य को complete या blocked के रूप में चिह्नित करें। |
मॉडल चुपचाप लक्ष्य को रोक, फिर शुरू, साफ़ या प्रतिस्थापित नहीं कर सकता। ये
/goal और रीसेट कमांड के माध्यम से ऑपरेटर/सत्र नियंत्रण बने रहते हैं, ताकि एजेंट
लक्ष्य को चुपचाप बदले बिना उपलब्धि या वास्तविक अवरोध की
रिपोर्ट कर सके।
update_goal को लक्ष्य complete के रूप में केवल तभी चिह्नित करना चाहिए जब उद्देश्य
वास्तव में प्राप्त हो गया हो। इसे लक्ष्य blocked के रूप में केवल तभी चिह्नित करना चाहिए, जब वही
अवरोधक स्थिति कम-से-कम लगातार तीन लक्ष्य बारियों में दोहराई जाए, न कि
सामान्य कठिनाई या अधूरे परिष्कार के कारण।
प्रत्येक बारी में लक्ष्य संदर्भ
सक्रिय लक्ष्य वाली प्रत्येक उपयोगकर्ता/चैट बारी में यह उपयोगकर्ता-भूमिका संदर्भ पंक्ति शामिल होती है:
सक्रिय लक्ष्य: <objective> — इसे आगे बढ़ाएँ या इसकी स्थिति अपडेट करें (get_goal/update_goal)।OpenClaw लंबे उद्देश्यों को छोटा करके पंक्ति को संक्षिप्त रखता है। रोके गए, अवरुद्ध, बजट-सीमित, उपयोग-सीमित और पूर्ण लक्ष्य जोड़े नहीं जाते, इसलिए लक्ष्य को फिर शुरू किए जाने तक ऑपरेटर की रोक प्रभावी रहती है।
Control UI
वेब Control UI लक्ष्य को चैट कंपोज़र के ऊपर एक संक्षिप्त पिल के रूप में दिखाता है:
एक स्थिति आइकन, स्थिति लेबल (उदाहरण के लिए Pursuing goal), छोटा किया गया
उद्देश्य और लाइव बीता-समय टाइमर।
पिल में इनलाइन नियंत्रण होते हैं:
- पेंसिल कंपोज़र में
/goal edit <objective>पहले से भरता है, ताकि उद्देश्य को नए शब्दों में लिखकर सबमिट किया जा सके। - रोकें / फिर शुरू करें वर्तमान स्थिति के आधार पर
/goal pauseऔर/goal resumeके बीच टॉगल करता है। - ट्रैश
/goal clearभेजता है। - शेवरॉन पिल को विस्तृत करके पूरा उद्देश्य, नवीनतम स्थिति नोट, टोकन उपयोग और बीता समय दिखाता है।
जब कंपोज़र संदेश नहीं भेज सकता, तब कार्रवाई बटन छिपे रहते हैं (उदाहरण के लिए, Gateway कनेक्शन बंद होने पर); विस्तृत करने वाला शेवरॉन काम करता रहता है।
TUI
TUI फ़ुटर सक्रिय सत्र के लक्ष्य को एजेंट, सत्र और मॉडल फ़ील्ड के पास, टोकन/मोड संकेतकों से पहले दृश्यमान रखता है।
फ़ुटर के उदाहरण:
- टोकन बजट वाले सक्रिय लक्ष्य के लिए
Pursuing goal (12k/50k)। - रोके गए लक्ष्य के लिए
Goal paused (/goal resume)। - अवरुद्ध लक्ष्य के लिए
Goal blocked (/goal resume)। - उपयोग-सीमित लक्ष्य के लिए
Goal hit usage limits (/goal resume)। - बजट-सीमित लक्ष्य के लिए
Goal unmet (50k/50k)। - पूर्ण लक्ष्य के लिए
Goal achieved (42k)।
फ़ुटर को जानबूझकर संक्षिप्त रखा गया है। पूरे उद्देश्य,
नोट, टोकन बजट और उपलब्ध कमांड के लिए /goal का उपयोग करें।
चैनल व्यवहार
/goal कमांड-सक्षम OpenClaw सत्रों में काम करता है, जिनमें TUI और
टेक्स्ट कमांड की अनुमति देने वाली चैट सतहें शामिल हैं। लक्ष्य की स्थिति
ट्रांसपोर्ट से नहीं, सत्र कुंजी से जुड़ी होती है, इसलिए एक ही सत्र कुंजी साझा करने वाली दो सतहों को
वही लक्ष्य दिखाई देता है।
लक्ष्य स्थिति डिलीवरी निर्देश नहीं है: यह किसी चैनल से उत्तर भेजना अनिवार्य नहीं करती, कतार व्यवहार नहीं बदलती, टूल अनुमोदित नहीं करती और कार्य निर्धारित नहीं करती।
समस्या निवारण
| संदेश | अर्थ |
|---|---|
Goal error: goal already exists |
सत्र में पहले से लक्ष्य है। इसे जाँचने के लिए /goal, पूरा होने पर /goal complete या अलग उद्देश्य शुरू करने से पहले /goal clear का उपयोग करें। |
Goal error: goal not found |
सत्र में अभी कोई लक्ष्य नहीं है। /goal start <objective> से लक्ष्य शुरू करें। |
Goal error: goal is already complete |
लक्ष्य अंतिम स्थिति में है। दूसरा उद्देश्य शुरू या फिर शुरू करने से पहले इसे साफ़ करें। |
यदि टोकन उपयोग में 0 दिखाई देता है या वह पुराना लगता है, तो सक्रिय सत्र में शायद अभी
ताज़ा टोकन स्नैपशॉट नहीं है। जैसे-जैसे OpenClaw सत्र उपयोग
और ट्रांसक्रिप्ट से प्राप्त कुल संख्या दर्ज करता है, उपयोग रीफ़्रेश होता है।
