Workboard Plugin

Workboard Plugin Control UI में एक वैकल्पिक Kanban-शैली बोर्ड जोड़ता है। इसका उपयोग एजेंट-आकार के कार्य कार्ड इकट्ठा करने, उन्हें एजेंटों को असाइन करने, और लिंक किए गए पृष्ठभूमि कार्य, रन, और डैशबोर्ड सत्र को एक कार्ड से ट्रैक करने के लिए करें.

Workboard जानबूझकर छोटा है। यह OpenClaw Gateway के लिए स्थानीय संचालन कार्य ट्रैक करता है; यह GitHub Issues, Linear, Jira, या अन्य टीम प्रोजेक्ट प्रबंधन प्रणालियों का विकल्प नहीं है।

डिफ़ॉल्ट स्थिति

Workboard एक बंडल किया गया Plugin है और डिफ़ॉल्ट रूप से अक्षम रहता है जब तक आप इसे Plugin कॉन्फ़िग में सक्षम नहीं करते।

इसे इस तरह सक्षम करें:

openclaw plugins enable workboardopenclaw gateway restart

फिर डैशबोर्ड खोलें:

openclaw dashboard

Workboard टैब डैशबोर्ड नेविगेशन में दिखाई देता है। यदि टैब दिखाई दे रहा है लेकिन Plugin अक्षम है या plugins.allow / plugins.deny से अवरुद्ध है, तो व्यू स्थानीय कार्ड डेटा के बजाय Plugin-अनुपलब्ध स्थिति दिखाता है।

कार्ड में क्या होता है

हर कार्ड यह संग्रहीत करता है:

• शीर्षक और नोट्स
• स्थिति: triage, backlog, todo, scheduled, ready, running, review, blocked, या done
• प्राथमिकता: low, normal, high, या urgent
• लेबल
• वैकल्पिक एजेंट आईडी
• वैकल्पिक लिंक किया गया कार्य, रन, सत्र, या स्रोत URL
• कार्ड से शुरू किए गए Codex या Claude रन के लिए वैकल्पिक निष्पादन मेटाडेटा
• प्रयासों, टिप्पणियों, लिंक, प्रमाण, आर्टिफैक्ट, ऑटोमेशन, अटैचमेंट, वर्कर लॉग, वर्कर प्रोटोकॉल स्थिति, दावों, डायग्नॉस्टिक्स, सूचनाओं, टेम्पलेट्स, आर्काइव स्थिति, और पुराने-सत्र पहचान के लिए संक्षिप्त मेटाडेटा
• हाल के कार्ड इवेंट जैसे बनाए गए, मूव किए गए, लिंक किए गए, दावा किए गए, Heartbeat, प्रयास, प्रमाण, आर्टिफैक्ट, डायग्नॉस्टिक, सूचना, डिस्पैच, आर्काइव, पुराने, या एजेंट-अपडेट किए गए बदलाव

कार्ड Plugin की Gateway स्थिति में संग्रहीत होते हैं। वे Gateway स्थिति डायरेक्टरी के लिए स्थानीय होते हैं और उस Gateway की बाकी OpenClaw स्थिति के साथ चलते हैं।

Workboard प्रति-कार्ड संक्षिप्त मेटाडेटा रखता है ताकि ऑपरेटर लिंक किए गए सत्र को खोले बिना देख सकें कि कार्ड बोर्ड से कैसे गुजरा। इवेंट, प्रयास सारांश, प्रमाण स्निपेट, संबंधित लिंक, टिप्पणियां, आर्काइव मार्कर, और पुराने-सत्र मार्कर जानबूझकर स्थानीय मेटाडेटा हैं; वे सत्र ट्रांसक्रिप्ट या GitHub issue इतिहास का विकल्प नहीं हैं।

कार्ड निष्पादन और कार्य

बिना लिंक वाले कार्ड कार्ड से काम शुरू कर सकते हैं। स्वायत्त शुरुआत Gateway के कार्य-ट्रैक किए गए एजेंट रन पथ का उपयोग करती है, फिर Workboard परिणामी कार्य, रन आईडी, और सत्र कुंजी को वापस कार्ड से लिंक करता है। शुरुआत Gateway के कॉन्फ़िगर किए गए डिफ़ॉल्ट एजेंट और मॉडल का उपयोग करती है। Codex और Claude क्रियाएं वैकल्पिक स्पष्ट मॉडल विकल्प हैं:

• Run Codex या Run Claude कार्य-समर्थित एजेंट रन शुरू करता है, कार्ड प्रॉम्प्ट भेजता है, और कार्ड को running चिह्नित करता है।
• Open Codex या Open Claude कार्ड प्रॉम्प्ट भेजे बिना या कार्ड को मूव किए बिना एक लिंक किया गया डैशबोर्ड सत्र बनाता है, ताकि आप बोर्ड से जुड़े रहते हुए मैन्युअल रूप से काम कर सकें।

निष्पादन मेटाडेटा चयनित इंजन, मोड, मॉडल रेफ, सत्र कुंजी, रन आईडी, उपलब्ध होने पर कार्य आईडी, और कार्ड पर लाइफसाइकल स्थिति संग्रहीत करता है। Codex निष्पादन openai/gpt-5.5 का उपयोग करते हैं; Claude निष्पादन anthropic/claude-sonnet-4-6 का उपयोग करते हैं।

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

डैशबोर्ड Gateway कार्य लेजर से कार्य स्थिति रीफ्रेश करता है और कार्य आईडी, रन आईडी, या लिंक की गई सत्र कुंजी से कार्यों को कार्ड से मिलाता है। यदि कोई कार्य कतार में है या चल रहा है, तो कार्ड लाइफसाइकल सक्रिय कार्य स्थिति दिखाता है। यदि कार्य पूरा होता है, विफल होता है, टाइम आउट होता है, या रद्द होता है, तो कार्ड लाइफसाइकल लिंक किए गए सत्रों वाली समान लाइफसाइकल सिंक का उपयोग करके समीक्षा या अवरुद्ध स्थिति की ओर बढ़ती है।

एजेंट समन्वय

Workboard बोर्ड-सचेत वर्कफ़्लो के लिए वैकल्पिक एजेंट टूल भी उपलब्ध कराता है:

• workboard_list दावा और डायग्नॉस्टिक स्थिति वाले संक्षिप्त कार्ड सूचीबद्ध करता है, वैकल्पिक बोर्ड फ़िल्टर के साथ।
• workboard_read एक कार्ड और नोट्स, प्रयासों, टिप्पणियों, लिंक, प्रमाण, आर्टिफैक्ट, पैरेंट परिणामों, हाल के असाइनी कार्य, और सक्रिय डायग्नॉस्टिक्स से बना सीमित वर्कर संदर्भ लौटाता है।
• workboard_create वैकल्पिक पैरेंट्स, टेनेंट, skills, बोर्ड, वर्कस्पेस मेटाडेटा, idempotency कुंजी, रनटाइम सीमा, और retry बजट के साथ कार्ड बनाता है।
• workboard_link पैरेंट कार्ड को चाइल्ड कार्ड से लिंक करता है। चिल्ड्रेन todo में रहते हैं जब तक हर पैरेंट done तक नहीं पहुंचता; फिर डिस्पैच प्रमोशन उन्हें ready में मूव करता है।
• workboard_claim कॉल करने वाले एजेंट के लिए कार्ड पर दावा करता है और बैकलॉग, todo, या ready कार्ड को running में मूव करता है।
• workboard_heartbeat लंबे रन के दौरान दावा Heartbeat रीफ्रेश करता है।
• workboard_release पूरा होने, विराम, या हैंडऑफ के बाद दावा रिलीज़ करता है और कार्ड को अगली स्थिति में मूव कर सकता है।
• workboard_complete और workboard_block अंतिम सारांशों, प्रमाण, आर्टिफैक्ट, बनाए-गए-कार्ड मैनिफेस्ट, और अवरोधक कारणों के लिए संरचित लाइफसाइकल टूल हैं। बनाए-गए-कार्ड मैनिफेस्ट में पूरे किए गए कार्ड से वापस लिंक किए गए कार्ड का संदर्भ होना चाहिए, जिससे काल्पनिक चिल्ड्रेन सारांशों से बाहर रहते हैं।
• workboard_attachment_add, workboard_attachment_read, और workboard_attachment_delete छोटे कार्ड अटैचमेंट Plugin SQLite स्थिति में संग्रहीत करते हैं, उन्हें कार्ड पर इंडेक्स करते हैं, और वर्कर संदर्भ में उपलब्ध कराते हैं।
• workboard_worker_log और workboard_protocol_violation वर्कर लॉग पंक्तियां दर्ज करते हैं और जब कोई स्वचालित वर्कर workboard_complete या workboard_block कॉल किए बिना रुकता है तो कार्ड ब्लॉक करते हैं।
• workboard_board_create, workboard_board_archive, और workboard_board_delete डिस्प्ले नाम, विवरण, आर्काइव स्थिति, और डिफ़ॉल्ट वर्कस्पेस जैसे स्थायी बोर्ड मेटाडेटा प्रबंधित करते हैं।
• workboard_runs कार्ड पर संग्रहीत स्थायी रन-प्रयास इतिहास लौटाता है।
• workboard_specify किसी मोटे triage या backlog कार्ड को स्पष्ट todo कार्ड में बदलता है और विनिर्देश सारांश कार्ड पर दर्ज करता है।
• workboard_decompose पैरेंट orchestration कार्ड को लिंक किए गए चिल्ड्रेन में फैलाता है, बोर्ड और टेनेंट मेटाडेटा विरासत में देता है, और बनाए-गए-कार्ड मैनिफेस्ट के साथ पैरेंट को पूरा कर सकता है।
• workboard_notify_subscribe, workboard_notify_list, workboard_notify_events, workboard_notify_advance, और workboard_notify_unsubscribe Plugin स्थिति में सूचना सदस्यताएं प्रबंधित करते हैं। इवेंट रीड replay-safe हैं; advance टूल टिकाऊ कर्सर को आगे बढ़ाता है ताकि कॉलर पूर्ण, विफल, या पुराने कार्ड इवेंट खोए बिना या दोबारा पढ़े बिना फिर से शुरू कर सकें।
• workboard_boards, workboard_stats, workboard_promote, workboard_reassign, workboard_reclaim, workboard_comment, workboard_proof, workboard_unblock, और workboard_dispatch एजेंट को बोर्ड नेमस्पेस निरीक्षण करने, कतार आंकड़े देखने, अटके काम को पुनर्प्राप्त करने, हैंडऑफ नोट्स जोड़ने, प्रमाण या आर्टिफैक्ट संदर्भ जोड़ने, अवरुद्ध काम को वापस todo में मूव करने, और dependency promotion या stale-claim cleanup को नज करने देते हैं।

दावा किए गए कार्ड अन्य एजेंटों से एजेंट-टूल mutations अस्वीकार करते हैं जब तक कॉलर के पास workboard_claim से लौटाया गया claim token न हो। डैशबोर्ड ऑपरेटर अब भी सामान्य Gateway RPC सतह का उपयोग करते हैं और कार्ड रिकवर या फिर से असाइन कर सकते हैं।

Workboard टिकाऊ बोर्ड डेटा को OpenClaw स्थिति डायरेक्टरी के अंतर्गत Plugin-स्वामित्व वाले relational SQLite डेटाबेस में संग्रहीत करता है। बोर्ड, कार्ड, लेबल, लाइफसाइकल इवेंट, रन प्रयास, टिप्पणियां, dependency links, प्रमाण, आर्टिफैक्ट संदर्भ, अटैचमेंट मेटाडेटा और blobs, डायग्नॉस्टिक्स, सूचनाएं, वर्कर लॉग, प्रोटोकॉल स्थिति, और सदस्यताएं Plugin key-value entries के बजाय Workboard तालिकाओं में स्थायी की जाती हैं। कार्ड export अब भी अटैचमेंट blob सामग्री inline किए बिना बोर्ड narrative को सुरक्षित रखता है।

.28 रिलीज़ में Workboard का उपयोग करने वाले इंस्टॉलेशन shipped legacy plugin-state namespaces (workboard.cards, workboard.boards, और workboard.notify) को relational database में migrate करने के लिए openclaw doctor --fix चला सकते हैं। यदि legacy workboard.attachments namespace मौजूद है, तो doctor उन attachment blobs को भी migrate करता है।

Workboard डायग्नॉस्टिक्स स्थानीय कार्ड मेटाडेटा से गणना किए जाते हैं। अंतर्निहित checks उन असाइन किए गए कार्ड को flag करते हैं जो बहुत लंबे समय तक प्रतीक्षा करते हैं, हालिया Heartbeat के बिना running cards, ध्यान मांगने वाले blocked cards, repeated failures, proof के बिना done cards, और running cards जिनके पास केवल loose session link है।

Dispatch जानबूझकर Gateway-local है। यह मनमाने operating system processes spawn नहीं करता; सामान्य OpenClaw subagent sessions अब भी execution के स्वामी हैं। Dispatch action dependency-ready cards को promote करता है, ready cards पर dispatch metadata record करता है, expired claims या timed-out runs को block करता है, board-configured triage cards को orchestration candidates के रूप में mark करता है, फिर ready cards की छोटी batch claim करता है और Gateway subagent runtime के माध्यम से worker runs शुरू करता है। Assigned cards agent:<id>:subagent:workboard-* worker session keys का उपयोग करते हैं; unassigned cards unscoped subagent:workboard-* keys का उपयोग करते हैं ताकि Gateway अब भी configured default agent resolve करे। Workers को bounded card context और वह claim token मिलता है जिसकी उन्हें Workboard tools के माध्यम से card को heartbeat, complete, या block करने के लिए आवश्यकता होती है।

Dispatch worker चयन

हर dispatch pass डिफ़ॉल्ट रूप से अधिकतम तीन workers शुरू करता है। Ready cards को priority, position, और creation time के अनुसार order किया जाता है, फिर duplicate active ownership से बचने के लिए filter किया जाता है। एक dispatch उसी pass में किसी दिए गए owner या agent के लिए केवल एक card शुरू करता है, और उन owners को skip करता है जिनके पास board पर पहले से running या review work है।

Archived cards, active claims वाले cards, और ready status के बिना cards worker starts के लिए select नहीं किए जाते। वे फिर भी dispatch के data side से प्रभावित हो सकते हैं जब stale claims, dependency promotion, या timeout cleanup लागू होता है।

Worker prompt और lifecycle

Worker prompt में card title, bounded notes और context, assigned board, और Workboard worker protocol शामिल होता है। इसमें claim owner और claim token भी शामिल होता है ताकि worker किसी अन्य actor द्वारा card take over किए बिना workboard_heartbeat, workboard_complete, या workboard_block call कर सके।

जब worker सफलतापूर्वक शुरू होता है, Workboard session key, run id, engine, mode, model label, status, और worker log को card पर store करता है। Session key board और card के लिए deterministic है, जिससे repeated dispatches unrelated sessions बनाने के बजाय उसी worker lane पर वापस route होते हैं।

यदि card claim होने के बाद worker शुरू नहीं किया जा सकता, तो Workboard card को block करता है, claim clear करता है, run-start failure record करता है, और worker log line append करता है। यह failure dashboard, CLI JSON, agent tools, और card diagnostics में visible है।

Dispatch entry points

Ready-card worker starts इनसे हो सकते हैं:

• dashboard dispatch action
• openclaw workboard dispatch
• command-capable channel पर /workboard dispatch

तीनों entry points Gateway उपलब्ध होने पर Gateway subagent runtime का उपयोग करते हैं। CLI में एक extra operator fallback है: यदि Gateway offline है या Workboard dispatch method expose नहीं करता और कोई explicit --url या --token target provide नहीं किया गया, तो यह local SQLite state के विरुद्ध data-only dispatch चलाता है। वह fallback dependencies promote कर सकता है, stale claims clean कर सकता है, और timed-out runs block कर सकता है, लेकिन workers शुरू नहीं कर सकता।

Board metadata में autoDecompose, autoDecomposePerDispatch, defaultAssignee, और orchestratorProfile जैसी orchestration settings शामिल हो सकती हैं। OpenClaw orchestration intent record करता है और उसे worker context में expose करता है; वास्तविक specification और decomposition अब भी सामान्य Workboard tools के माध्यम से होता है।

CLI और slash command

Plugin एक root CLI command register करता है:

openclaw workboard listopenclaw workboard create "Fix stale card lifecycle" --priority high --labels bug,workboardopenclaw workboard show <card-id>openclaw workboard dispatch

openclaw workboard dispatch चल रहे Gateway को कॉल करता है ताकि worker शुरू होने पर dashboard जैसा ही subagent runtime इस्तेमाल हो। अगर Gateway उपलब्ध नहीं है, तो यह data-only dispatch पर वापस चला जाता है ताकि dependency promotion, stale-claim cleanup, और timeout blocking फिर भी चल सकें। Auth, permission, और validation failures फिर भी command errors के रूप में दिखते हैं, जैसे explicit --url या --token targets के failures भी।

/workboard slash command वही compact operator path support करता है: /workboard list, /workboard show <card-id>, /workboard create <title>, और /workboard dispatch। List और show authorized command senders के लिए read operations हैं। Create और dispatch के लिए chat surfaces पर owner status या operator.write या operator.admin वाला Gateway client चाहिए।

command flags, JSON output, Gateway fallback behavior, unambiguous id-prefix handling, dispatch selection rules, और troubleshooting के लिए Workboard CLI देखें।

Session lifecycle sync

Cards को existing dashboard sessions से या card से काम शुरू करने पर बने session से link किया जा सकता है। Linked cards session lifecycle inline दिखाते हैं: running, stale, linked idle, done, failed, या missing।

अगर linked session missing है, तो card context के लिए linked रहता है और फिर भी start controls देता है ताकि आप fresh dashboard session में काम restart कर सकें। अगर active linked session recent activity report करना बंद कर देता है, तो Workboard card को stale mark करता है और marker को card metadata के रूप में store करता है जब तक lifecycle उसे clear नहीं कर देता।

आप Sessions tab से Add to Workboard के साथ existing dashboard session भी capture कर सकते हैं। Card उस session से linked होता है, session label या recent user prompt को title के रूप में इस्तेमाल करता है, और chat history उपलब्ध होने पर recent user prompt plus latest assistant response से notes seed करता है।

जब card अभी भी active work state में हो, Workboard linked session को follow करता है:

• active linked session -> running
• completed linked session -> review
• failed, killed, timed out, या aborted linked session -> blocked

Manual review states जीतते हैं। अगर आप card को review, blocked, या done में move करते हैं, तो Workboard उस card को auto-moving करना बंद कर देता है जब तक आप उसे वापस todo या running में move नहीं करते।

Dashboard workflow

1. Control UI में Workboard tab खोलें।
2. title, notes, priority, labels, optional agent, और optional linked session के साथ card बनाएं।
3. या existing session के लिए Sessions खोलें और Add to Workboard चुनें।
4. card को columns के बीच drag करें या card पर compact status control focus करें और उसका menu या ArrowLeft/ArrowRight इस्तेमाल करें।
5. dashboard session create या reuse करने के लिए card से काम शुरू करें।
6. agent के काम करते समय card से linked session खोलें।
7. lifecycle sync को running work को review या blocked में move करने दें, फिर accepted होने पर card को manually done में move करें।

Card शुरू करना normal Gateway sessions इस्तेमाल करता है। Workboard Plugin सिर्फ card metadata और links store करता है; conversation transcript, model selection, और run lifecycle regular session system के owned रहते हैं।

Live linked card पर Stop इस्तेमाल करके active session run abort करें। Workboard उस card को blocked mark करता है ताकि वह follow-up के लिए visible रहे।

New cards bugfixes, docs, releases, PR reviews, या plugin work के लिए Workboard templates से शुरू हो सकते हैं। Templates title, notes, labels, और priority prefill करते हैं, और selected template id card metadata के रूप में store होती है।

Permissions

Plugin Gateway RPC methods को workboard.* namespace के तहत register करता है:

• workboard.cards.list के लिए operator.read चाहिए
• workboard.cards.export के लिए operator.read चाहिए
• workboard.cards.diagnostics के लिए operator.read चाहिए
• workboard.cards.diagnostics.refresh के लिए operator.write चाहिए
• attachment list/get और notification event reads के लिए operator.read चाहिए
• notification cursor advancement के लिए operator.write चाहिए
• create, update, move, delete, comment, link, dependency link, proof, artifact, attachment add/delete, worker log, protocol violation, claim, heartbeat, release, complete, block, unblock, dispatch, bulk, और archive methods के लिए operator.write चाहिए

Read-only operator access से connected browsers board inspect कर सकते हैं लेकिन cards mutate नहीं कर सकते।

Configuration

आज Workboard में कोई plugin-specific config नहीं है। Standard plugin entry से इसे enable या disable करें:

{  plugins: {    entries: {      workboard: {        enabled: true,        config: {},      },    },  },}

इसे फिर से disable करें:

openclaw plugins disable workboardopenclaw gateway restart

Troubleshooting

Tab कहता है कि Workboard unavailable है

Plugin policy check करें:

openclaw plugins inspect workboard --runtime --json

अगर plugins.allow configured है, तो उस allowlist में workboard जोड़ें। अगर plugins.deny में workboard है, तो Plugin enable करने से पहले उसे remove करें।

Cards save नहीं होते

Confirm करें कि browser connection के पास operator.write access है। Read-only operator sessions cards list कर सकते हैं लेकिन उन्हें create, edit, move, या delete नहीं कर सकते।

Card शुरू करने पर expected session नहीं खुलता

Workboard normal dashboard sessions के links बनाता है। Card का agent id और linked session check करें, फिर actual run state inspect करने के लिए Sessions या Chat view खोलें।

Dispatch worker start नहीं करता

Confirm करें कि active claim के बिना कम से कम एक ready card है:

openclaw workboard list --status ready

अगर CLI data-only dispatch report करता है, तो Gateway start या restart करें और retry करें। Data-only dispatch local board state update करता है लेकिन subagent worker runs शुरू नहीं कर सकता।

Cards तब भी skipped हो सकते हैं जब same owner या agent के लिए कोई दूसरा card already running हो या review का wait कर रहा हो। Same owner के लिए और work dispatch करने से पहले उस active work को complete, block, या release करें।

Related

• Control UI
• Workboard CLI
• Plugins
• Plugins manage करें
• Sessions