वर्कबोर्ड CLI

openclaw workboard बंडल किए गए Workboard Plugin के लिए टर्मिनल इंटरफ़ेस है। इससे ऑपरेटर कार्ड सूचीबद्ध कर सकता है, कार्ड बना सकता है, किसी एक कार्ड का निरीक्षण कर सकता है और चल रहे Gateway से तैयार कार्य को सबएजेंट वर्कर रन में भेजने के लिए कह सकता है।

कमांड का उपयोग करने से पहले Plugin सक्षम करें:

openclaw plugins enable workboardopenclaw gateway restart

उपयोग

openclaw workboard list [--board <id>] [--status <status>] [--include-archived] [--json]openclaw workboard create <title...> [--notes <text>] [--status <status>] [--priority <priority>] [--agent <id>] [--board <id>] [--labels <items>] [--json]openclaw workboard show <id> [--json]openclaw workboard move <id> --status <status> [--json]openclaw workboard dispatch [--board <id>] [--max-starts <count>] [--admin] [--url <url>] [--token <token>] [--timeout <ms>] [--json]

यह कमांड उसी Plugin-स्वामित्व वाले SQLite डेटाबेस को पढ़ता और लिखता है जिसका उपयोग डैशबोर्ड और Workboard एजेंट टूल करते हैं। कार्ड आईडी UUID होते हैं; कार्ड आईडी स्वीकार करने वाले कमांड एक असंदिग्ध आईडी उपसर्ग भी स्वीकार करते हैं (संक्षिप्त टेक्स्ट आउटपुट पहले 8 वर्ण दिखाता है)।

मान्य status मान: triage, backlog, todo, scheduled, ready, running, review, blocked, done। मान्य priority मान: low, normal, high, urgent।

list

openclaw workboard listopenclaw workboard list --board default --status readyopenclaw workboard list --json

टेक्स्ट आउटपुट संक्षिप्त होता है:

7f4a2c10  ready     high    default agent-a  पुराने वर्कर Heartbeat को ठीक करें

कॉलम में आईडी उपसर्ग, स्थिति, प्राथमिकता, बोर्ड आईडी, वैकल्पिक एजेंट आईडी और शीर्षक होते हैं।

संक्षिप्त टेक्स्ट आउटपुट डिफ़ॉल्ट रूप से संग्रहित कार्ड छिपाता है, ताकि CLI /workboard list से मेल खाए। उन्हें दिखाने के लिए --include-archived दें। मौजूदा ऑटोमेशन के लिए JSON आउटपुट संग्रहित कार्ड सहित पूरी कार्ड सूची हमेशा बनाए रखता है।

create

openclaw workboard create "पुराने वर्कर Heartbeat को ठीक करें" --priority high --labels bug,workboardopenclaw workboard create "Workboard दस्तावेज़ लिखें" --status ready --agent docs-agent --board docs --notes "CLI, स्लैश कमांड, डिस्पैच और SQLite स्थिति को शामिल करें।"

create सीधे Workboard SQLite स्थिति में लिखता है। कार्ड तुरंत Control UI के Workboard टैब और Workboard टूल में दिखाई देता है।

show

openclaw workboard show 7f4a2c10openclaw workboard show 7f4a2c10 --json

टेक्स्ट आउटपुट संक्षिप्त कार्ड पंक्ति और नोट्स प्रिंट करता है। JSON आउटपुट निष्पादन मेटाडेटा, प्रयासों, टिप्पणियों, लिंक, प्रमाण, आर्टिफ़ैक्ट, वर्कर लॉग, प्रोटोकॉल स्थिति, निदान और ऑटोमेशन मेटाडेटा सहित पूरा कार्ड रिकॉर्ड लौटाता है।

JSON में प्रमाण स्थितियाँ वर्कर द्वारा रिपोर्ट किए गए परिणाम हैं। passed संलग्न कमांड या जाँच के बारे में वर्कर का स्व-मूल्यांकन दर्ज करता है; यह स्वतंत्र सत्यापन परिणाम नहीं है।

move

openclaw workboard move 7f4a2c10 --status reviewopenclaw workboard move 7f4a2c10 --status done --json

move डैशबोर्ड में कार्ड खींचने वाले समान मैन्युअल-ऑपरेटर पथ का उपयोग करके कार्ड की स्थिति बदलता है। यह पूरी कार्ड आईडी या असंदिग्ध उपसर्ग स्वीकार करता है। सक्रिय निर्भरता और शेड्यूल होल्ड फिर भी लागू होते हैं। ऑपरेटर दावा किए गए कार्ड को उसके एजेंट दावा टोकन के बिना स्थानांतरित कर सकते हैं; दावा टोकन एजेंट-टूल परिवर्तनों तक सीमित रहते हैं और JSON आउटपुट से संपादित कर दिए जाते हैं।

dispatch

openclaw workboard dispatchopenclaw workboard dispatch --jsonopenclaw workboard dispatch --max-starts 10openclaw workboard dispatch --adminopenclaw workboard dispatch --url http://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"

dispatch पहले चल रहे Gateway की RPC विधि workboard.cards.dispatch को कॉल करता है, जो डैशबोर्ड की डिस्पैच कार्रवाई वाले समान सबएजेंट रनटाइम का उपयोग करती है, इसलिए तैयार कार्ड लिंक की गई सत्र कुंजियों वाले कार्य-ट्रैक किए गए वर्कर रन बन जाते हैं। --max-starts योगात्मक workboard.cards.dispatchWithOptions विधि का उपयोग करता है, ताकि पुराना Gateway किसी भी वर्कर को शुरू करने से पहले विकल्प अस्वीकार कर दे; अपग्रेड के बाद फ़्लैग का उपयोग करने से पहले Gateway पुनः प्रारंभ करें। निर्दिष्ट एजेंट वाले कार्ड एजेंट-सीमित सबएजेंट सत्र कुंजियों का उपयोग करते हैं; अनिर्दिष्ट कार्ड बिना दायरे वाली सबएजेंट कुंजी बनाए रखते हैं, ताकि Gateway का कॉन्फ़िगर किया गया डिफ़ॉल्ट एजेंट सुरक्षित रहे।

डिस्पैच लूप:

1. निर्भरता के लिए तैयार चाइल्ड कार्ड को ready में पदोन्नत करता है।
2. समाप्त दावों या समय-सीमा पार कर चुके वर्कर रन को अवरुद्ध करता है।
3. तैयार कार्ड पर डिस्पैच मेटाडेटा दर्ज करता है।
4. बिना दावे वाले तैयार कार्ड का एक छोटा बैच चुनता है।
5. चुने गए प्रत्येक कार्ड पर डिस्पैचर या निर्दिष्ट एजेंट के लिए दावा करता है।
6. सीमित कार्ड संदर्भ और कार्ड दावा टोकन के साथ सबएजेंट वर्कर रन शुरू करता है।
7. वर्कर रन आईडी, सत्र कुंजी, Gateway कार्य लेजर द्वारा रिपोर्ट किए जाने पर कार्य लिंकेज, निष्पादन स्थिति और वर्कर लॉग को कार्ड पर संग्रहित करता है।

चयन सतर्कतापूर्ण है: एक डिस्पैच डिफ़ॉल्ट रूप से अधिकतम तीन वर्कर शुरू करता है, संग्रहित या पहले से दावा किए गए कार्ड छोड़ देता है और एक ही पास में प्रत्येक स्वामी या एजेंट के लिए केवल एक कार्ड शुरू करता है। ऐसे कार्ड जिनके स्वामी के पास पहले से सक्रिय रूप से चल रहा या समीक्षा अधीन कार्य है, बाद के डिस्पैच के लिए छोड़ दिए जाते हैं। प्रत्येक पास की सीमा बदलने के लिए धनात्मक पूर्णांक के साथ --max-starts <count> दें; प्रति स्वामी एक कार्ड का नियम फिर भी लागू होता है, इसलिए शुरू होने वाले वर्कर की प्रभावी संख्या कम हो सकती है।

यदि कार्ड पर दावा किए जाने के बाद वर्कर प्रारंभ करना विफल हो जाता है, तो Workboard उस कार्ड को अवरुद्ध करता है, दावा हटाता है और विफलता को कार्ड निष्पादन तथा वर्कर-लॉग मेटाडेटा में दर्ज करता है, जिससे विफल प्रारंभ कार्ड को चुपचाप कतार में लौटाने के बजाय दृश्यमान रहते हैं।

यदि कोई स्पष्ट Gateway लक्ष्य नहीं दिया गया है और स्थानीय Gateway अनुपलब्ध है या अभी तक Workboard डिस्पैच विधि उपलब्ध नहीं कराता, तो CLI स्थानीय Workboard स्थिति के विरुद्ध केवल-डेटा डिस्पैच पर वापस लौटता है। केवल-डेटा डिस्पैच फिर भी निर्भरताओं को पदोन्नत कर सकता है, पुराने दावे साफ़ कर सकता है और समय-सीमा पार कर चुके रन अवरुद्ध कर सकता है, लेकिन यह वर्कर शुरू नहीं करता। प्रमाणीकरण, अनुमति और सत्यापन विफलताएँ तथा स्पष्ट --url या --token लक्ष्य की विफलताएँ फ़ॉलबैक ट्रिगर करने के बजाय सीधे रिपोर्ट की जाती हैं।

टेक्स्ट आउटपुट वर्कर प्रारंभ की रिपोर्ट देता है:

डिस्पैच पूरा हुआ: शुरू हुए=2 विफलताएँ=0

फ़ॉलबैक आउटपुट स्पष्ट होता है:

Gateway अनुपलब्ध; केवल डेटा डिस्पैच: पदोन्नत=1 अवरुद्ध=0

JSON आउटपुट में डिस्पैच परिणाम शामिल होता है। Gateway-समर्थित डिस्पैच में started और startFailures शामिल हो सकते हैं; केवल-डेटा फ़ॉलबैक में gatewayUnavailable: true शामिल होता है। कार्ड JSON आउटपुट से दावा टोकन संपादित कर दिए जाते हैं।

डैशबोर्ड में वही डिस्पैच परिणाम संक्षिप्त सारांश के रूप में दिखाया जाता है, ताकि ऑपरेटर कार्ड विवरण खोले बिना देख सके कि कितने कार्ड शुरू, पदोन्नत, अवरुद्ध, पुनः प्राप्त या विफल हुए।

स्लैश कमांड समतुल्यता

कमांड-सक्षम चैनल संबंधित स्लैश कमांड का उपयोग कर सकते हैं:

/workboard list/workboard show 7f4a2c10/workboard create पुराने वर्कर Heartbeat को ठीक करें/workboard move 7f4a2c10 --status review/workboard dispatch

स्लैश कमांड डिस्पैच भी Gateway सबएजेंट रनटाइम का उपयोग करता है, इसलिए यह डैशबोर्ड और CLI Gateway पथ वाले समान दावा, वर्कर-प्रारंभ और विफलता व्यवहार का पालन करता है।

/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 समान प्रोफ़ाइल और स्थिति रूट के लिए सक्षम है:

openclaw plugins inspect workboard --runtime --json

यदि डैशबोर्ड कार्ड दिखाता है लेकिन CLI नहीं, तो जाँचें कि दोनों कमांड समान --dev या --profile सेटिंग का उपयोग करते हैं।

डिस्पैच केवल-डेटा बताता है

Gateway शुरू या पुनः प्रारंभ करें:

openclaw gateway restartopenclaw gateway status --deep

फिर openclaw workboard dispatch को पुनः आज़माएँ। केवल-डेटा फ़ॉलबैक स्थानीय स्थिति की सफ़ाई के लिए उपयोगी है, लेकिन वर्कर रन के लिए सक्रिय Gateway आवश्यक है।

डिस्पैच कुछ भी शुरू नहीं करता

सक्रिय दावे के बिना कम-से-कम एक ready कार्ड की जाँच करें:

openclaw workboard list --status ready

जब उसी स्वामी के पास पहले से चल रहा या समीक्षा अधीन कार्य हो, तब भी कार्ड छोड़े जा सकते हैं। पूर्ण कार्य को done में ले जाएँ, Workboard टूल के माध्यम से पुराने दावे हटाएँ या सक्रिय वर्कर समाप्त होने के बाद डिस्पैच फिर चलाएँ।

संबंधित

• Workboard Plugin
• CLI संदर्भ
• स्लैश कमांड
• Control UI