openclaw workboard बंडल किए गए Workboard Plugin के लिए टर्मिनल इंटरफ़ेस है। इससे ऑपरेटर कार्ड सूचीबद्ध कर सकता है, कार्ड बना सकता है, किसी एक कार्ड का निरीक्षण कर सकता है और चल रहे Gateway से तैयार कार्य को सबएजेंट वर्कर रन में भेजने के लिए कह सकता है।
कमांड का उपयोग करने से पहले Plugin सक्षम करें:
उपयोग
status मान: triage, backlog, todo, scheduled, ready, running, review, blocked, done। मान्य priority मान: low, normal, high, urgent।
list
संक्षिप्त टेक्स्ट आउटपुट डिफ़ॉल्ट रूप से संग्रहित कार्ड छिपाता है, ताकि CLI
/workboard list से मेल खाए। उन्हें दिखाने के लिए --include-archived दें। मौजूदा ऑटोमेशन के लिए JSON आउटपुट संग्रहित कार्ड सहित पूरी कार्ड सूची हमेशा बनाए रखता है।
create
create सीधे Workboard SQLite स्थिति में लिखता है। कार्ड तुरंत Control UI के Workboard टैब और Workboard टूल में दिखाई देता है।
show
passed संलग्न कमांड या जाँच के बारे में वर्कर का
स्व-मूल्यांकन दर्ज करता है; यह स्वतंत्र सत्यापन
परिणाम नहीं है।
move
move डैशबोर्ड में कार्ड खींचने वाले समान मैन्युअल-ऑपरेटर पथ का उपयोग करके कार्ड की स्थिति बदलता है। यह पूरी कार्ड आईडी या असंदिग्ध उपसर्ग स्वीकार करता है। सक्रिय निर्भरता और शेड्यूल होल्ड फिर भी लागू होते हैं। ऑपरेटर दावा किए गए कार्ड को उसके एजेंट दावा टोकन के बिना स्थानांतरित कर सकते हैं; दावा टोकन एजेंट-टूल परिवर्तनों तक सीमित रहते हैं और JSON आउटपुट से संपादित कर दिए जाते हैं।
dispatch
dispatch पहले चल रहे Gateway की RPC विधि workboard.cards.dispatch को कॉल करता है, जो डैशबोर्ड की डिस्पैच कार्रवाई वाले समान सबएजेंट रनटाइम का उपयोग करती है, इसलिए तैयार कार्ड लिंक की गई सत्र कुंजियों वाले कार्य-ट्रैक किए गए वर्कर रन बन जाते हैं। --max-starts योगात्मक workboard.cards.dispatchWithOptions विधि का उपयोग करता है, ताकि पुराना Gateway किसी भी वर्कर को शुरू करने से पहले विकल्प अस्वीकार कर दे; अपग्रेड के बाद फ़्लैग का उपयोग करने से पहले Gateway पुनः प्रारंभ करें। निर्दिष्ट एजेंट वाले कार्ड एजेंट-सीमित सबएजेंट सत्र कुंजियों का उपयोग करते हैं; अनिर्दिष्ट कार्ड बिना दायरे वाली सबएजेंट कुंजी बनाए रखते हैं, ताकि Gateway का कॉन्फ़िगर किया गया डिफ़ॉल्ट एजेंट सुरक्षित रहे।
डिस्पैच लूप:
- निर्भरता के लिए तैयार चाइल्ड कार्ड को
readyमें पदोन्नत करता है। - समाप्त दावों या समय-सीमा पार कर चुके वर्कर रन को अवरुद्ध करता है।
- तैयार कार्ड पर डिस्पैच मेटाडेटा दर्ज करता है।
- बिना दावे वाले तैयार कार्ड का एक छोटा बैच चुनता है।
- चुने गए प्रत्येक कार्ड पर डिस्पैचर या निर्दिष्ट एजेंट के लिए दावा करता है।
- सीमित कार्ड संदर्भ और कार्ड दावा टोकन के साथ सबएजेंट वर्कर रन शुरू करता है।
- वर्कर रन आईडी, सत्र कुंजी, Gateway कार्य लेजर द्वारा रिपोर्ट किए जाने पर कार्य लिंकेज, निष्पादन स्थिति और वर्कर लॉग को कार्ड पर संग्रहित करता है।
--max-starts <count> दें; प्रति स्वामी एक कार्ड का नियम फिर भी लागू होता है, इसलिए शुरू होने वाले वर्कर की प्रभावी संख्या कम हो सकती है।
यदि कार्ड पर दावा किए जाने के बाद वर्कर प्रारंभ करना विफल हो जाता है, तो Workboard उस कार्ड को अवरुद्ध करता है, दावा हटाता है और विफलता को कार्ड निष्पादन तथा वर्कर-लॉग मेटाडेटा में दर्ज करता है, जिससे विफल प्रारंभ कार्ड को चुपचाप कतार में लौटाने के बजाय दृश्यमान रहते हैं।
यदि कोई स्पष्ट Gateway लक्ष्य नहीं दिया गया है और स्थानीय Gateway अनुपलब्ध है या अभी तक Workboard डिस्पैच विधि उपलब्ध नहीं कराता, तो CLI स्थानीय Workboard स्थिति के विरुद्ध केवल-डेटा डिस्पैच पर वापस लौटता है। केवल-डेटा डिस्पैच फिर भी निर्भरताओं को पदोन्नत कर सकता है, पुराने दावे साफ़ कर सकता है और समय-सीमा पार कर चुके रन अवरुद्ध कर सकता है, लेकिन यह वर्कर शुरू नहीं करता। प्रमाणीकरण, अनुमति और सत्यापन विफलताएँ तथा स्पष्ट --url या --token लक्ष्य की विफलताएँ फ़ॉलबैक ट्रिगर करने के बजाय सीधे रिपोर्ट की जाती हैं।
टेक्स्ट आउटपुट वर्कर प्रारंभ की रिपोर्ट देता है:
started और startFailures शामिल हो सकते हैं; केवल-डेटा फ़ॉलबैक में gatewayUnavailable: true शामिल होता है। कार्ड JSON आउटपुट से दावा टोकन संपादित कर दिए जाते हैं।
डैशबोर्ड में वही डिस्पैच परिणाम संक्षिप्त सारांश के रूप में दिखाया जाता है, ताकि ऑपरेटर कार्ड विवरण खोले बिना देख सके कि कितने कार्ड शुरू, पदोन्नत, अवरुद्ध, पुनः प्राप्त या विफल हुए।
स्लैश कमांड समतुल्यता
कमांड-सक्षम चैनल संबंधित स्लैश कमांड का उपयोग कर सकते हैं:/workboard list और /workboard show अधिकृत कमांड प्रेषकों के लिए रीड कमांड हैं। /workboard create, /workboard move और /workboard dispatch बोर्ड स्थिति बदलते हैं और इनके लिए चैट इंटरफ़ेस पर स्वामी स्थिति या operator.write अथवा operator.admin वाला Gateway क्लाइंट आवश्यक है।
अनुमतियाँ
CLI डिस्पैच पथ सामान्यतः Gateway केoperator.write और operator.read दायरे का अनुरोध करता है। कार्यस्थान से बंधे कार्ड ठीक कॉन्फ़िगर किए गए एजेंट कार्यस्थान में सीधे चलते हैं; वर्कट्री अनुरोध को उसी डायरेक्टरी तक सीमित कर दिया जाता है, बजाय इसके कि होस्ट रिपॉज़िटरी-नियंत्रित कोड को मूर्त रूप दे। चुने गए वर्कर के पास ठीक उसी कार्यस्थान के लिए लिखने योग्य, गैर-साझा Docker सैंडबॉक्स पहुँच, अनुरोधित माउंट और नीति से मेल खाने वाला सक्रिय कंटेनर हैश तथा होस्ट से बाहर निकलने की कोई क्षमता नहीं होनी चाहिए। स्पष्ट रूप से operator.admin का अनुरोध करने, किसी अन्य होस्ट चेकआउट को अनुमति देने और सामान्य प्रबंधित-वर्कट्री सेटअप का उपयोग करने के लिए --admin दें; यदि वह दायरा क्लाइंट के लिए स्वीकृत नहीं है, तो कनेक्शन विफल हो जाता है। केवल-पढ़ने वाला Gateway टोकन रीड विधियों के माध्यम से Workboard डेटा का निरीक्षण कर सकता है, लेकिन वह कार्ड नहीं बना सकता या वर्कर डिस्पैच नहीं कर सकता। Workboard परिवर्तन अनुमति वाले कॉलर के लिए कार्यस्थान सीमाएँ अन्यथा कार्ड की मैन्युअल आवाजाही को नहीं बदलतीं।
स्थानीय list, create, show और move कमांड वर्तमान प्रोफ़ाइल द्वारा उपयोग की जाने वाली स्थानीय OpenClaw स्थिति डायरेक्टरी पर काम करते हैं। अलग स्थिति रूट की आवश्यकता होने पर शीर्ष-स्तरीय openclaw कमांड पर --dev या --profile <name> का उपयोग करें।
समस्या निवारण
कोई कार्ड दिखाई नहीं देता
पुष्टि करें कि Plugin समान प्रोफ़ाइल और स्थिति रूट के लिए सक्षम है:--dev या --profile सेटिंग का उपयोग करते हैं।
डिस्पैच केवल-डेटा बताता है
Gateway शुरू या पुनः प्रारंभ करें:openclaw workboard dispatch को पुनः आज़माएँ। केवल-डेटा फ़ॉलबैक स्थानीय स्थिति की सफ़ाई के लिए उपयोगी है, लेकिन वर्कर रन के लिए सक्रिय Gateway आवश्यक है।
डिस्पैच कुछ भी शुरू नहीं करता
सक्रिय दावे के बिना कम-से-कम एकready कार्ड की जाँच करें:
done में ले जाएँ, Workboard टूल के माध्यम से पुराने दावे हटाएँ या सक्रिय वर्कर समाप्त होने के बाद डिस्पैच फिर चलाएँ।