---
read_when:
    - आप टर्मिनल से Workboard कार्ड देखना या बनाना चाहते हैं
    - आप CLI से Workboard वर्कर रन डिस्पैच करना चाहते हैं
    - आप Workboard CLI या स्लैश कमांड के व्यवहार को डीबग कर रहे हैं
summary: '`openclaw workboard` कार्ड, डिस्पैच और वर्कर रन के लिए CLI संदर्भ'
title: वर्कबोर्ड CLI
x-i18n:
    generated_at: "2026-07-27T17:45:25Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: 640260ea6f5959b3aee1cdce76f2501097bff79e9bf1741bdd9ff7a8b43e1a7f
    source_path: cli/workboard.md
    workflow: 16
---

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

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

```bash
openclaw plugins enable workboard
openclaw gateway restart
```

## उपयोग

```bash
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`

```bash
openclaw workboard list
openclaw workboard list --board default --status ready
openclaw workboard list --json
```

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

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

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

| फ़्लैग                 | उद्देश्य                                       |
| -------------------- | --------------------------------------------- |
| `--board <id>`       | परिणामों को एक बोर्ड नेमस्पेस तक सीमित करें          |
| `--status <status>`  | परिणामों को Workboard की एक स्थिति तक सीमित करें         |
| `--include-archived` | संक्षिप्त टेक्स्ट आउटपुट में संग्रहित कार्ड शामिल करें |
| `--json`             | पूरी कार्ड सूची मशीन JSON के रूप में प्रिंट करें      |

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

## `create`

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

| फ़्लैग                    | उद्देश्य                                 |
| ----------------------- | --------------------------------------- |
| `--notes <text>`        | कार्ड के आरंभिक नोट्स                      |
| `--status <status>`     | आरंभिक स्थिति, डिफ़ॉल्ट `todo`          |
| `--priority <priority>` | प्राथमिकता, डिफ़ॉल्ट `normal`              |
| `--agent <id>`          | कार्ड को किसी एजेंट या स्वामी आईडी को सौंपें |
| `--board <id>`          | कार्ड को किसी बोर्ड नेमस्पेस पर संग्रहित करें     |
| `--labels <items>`      | अल्पविराम से अलग किए गए लेबल                  |
| `--json`                | बनाए गए कार्ड को मशीन JSON के रूप में प्रिंट करें  |

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

## `show`

```bash
openclaw workboard show 7f4a2c10
openclaw workboard show 7f4a2c10 --json
```

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

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

## `move`

```bash
openclaw workboard move 7f4a2c10 --status review
openclaw workboard move 7f4a2c10 --status done --json
```

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

## `dispatch`

```bash
openclaw workboard dispatch
openclaw workboard dispatch --json
openclaw workboard dispatch --max-starts 10
openclaw workboard dispatch --admin
openclaw 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` लक्ष्य की विफलताएँ फ़ॉलबैक ट्रिगर करने के बजाय सीधे रिपोर्ट की जाती हैं।

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

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

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

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

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

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

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

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

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

```bash
openclaw plugins inspect workboard --runtime --json
```

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

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

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

```bash
openclaw gateway restart
openclaw gateway status --deep
```

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

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

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

```bash
openclaw workboard list --status ready
```

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

## संबंधित

- [Workboard Plugin](/hi/plugins/workboard)
- [CLI संदर्भ](/hi/cli)
- [स्लैश कमांड](/hi/tools/slash-commands)
- [Control UI](/hi/web/control-ui)