--- read_when: - Je wilt Workboard-kaarten bekijken of aanmaken vanuit de terminal - Je wilt Workboard-workerruns starten vanuit de CLI - Je debugt het gedrag van de Workboard-CLI of slashcommando's summary: CLI-referentie voor `openclaw workboard`-kaarten, dispatch en workerruns title: Workboard-CLI x-i18n: generated_at: "2026-07-27T04:56:19Z" 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` is de terminalinterface voor de meegeleverde [Workboard-plugin](/nl/plugins/workboard). Hiermee kan een operator kaarten weergeven, een kaart maken, één kaart bekijken en de actieve Gateway opdracht geven gereed werk toe te wijzen aan subagent-workerruns. Schakel de plugin in voordat je de opdracht gebruikt: ```bash openclaw plugins enable workboard openclaw gateway restart ``` ## Gebruik ```bash openclaw workboard list [--board ] [--status ] [--include-archived] [--json] openclaw workboard create [--notes ] [--status ] [--priority ] [--agent ] [--board ] [--labels ] [--json] openclaw workboard show [--json] openclaw workboard move --status [--json] openclaw workboard dispatch [--board ] [--max-starts ] [--admin] [--url ] [--token ] [--timeout ] [--json] ``` De opdracht leest en schrijft dezelfde SQLite-database die eigendom is van de plugin en door het dashboard en de Workboard-agenttools wordt gebruikt. Kaart-id's zijn UUID's; opdrachten die een kaart-id accepteren, accepteren ook een eenduidig id-voorvoegsel (de compacte tekstuitvoer toont de eerste 8 tekens). Geldige waarden voor `status`: `triage`, `backlog`, `todo`, `scheduled`, `ready`, `running`, `review`, `blocked`, `done`. Geldige waarden voor `priority`: `low`, `normal`, `high`, `urgent`. ## `list` ```bash openclaw workboard list openclaw workboard list --board default --status ready openclaw workboard list --json ``` De tekstuitvoer is compact: ```text 7f4a2c10 ready high default agent-a Verouderde worker-Heartbeat herstellen ``` De kolommen zijn het id-voorvoegsel, de status, de prioriteit, het bord-id, het optionele agent-id en de titel. | Vlag | Doel | | -------------------- | --------------------------------------------- | | `--board ` | Resultaten beperken tot één bordnaamruimte | | `--status ` | Resultaten beperken tot één Workboard-status | | `--include-archived` | Gearchiveerde kaarten opnemen in compacte tekstuitvoer | | `--json` | De volledige kaartenlijst als machine-JSON afdrukken | De compacte tekstuitvoer verbergt standaard gearchiveerde kaarten, zodat de CLI overeenkomt met `/workboard list`. Geef `--include-archived` door om ze weer te geven. JSON-uitvoer behoudt altijd de volledige kaartenlijst, inclusief gearchiveerde kaarten, voor bestaande automatisering. ## `create` ```bash openclaw workboard create "Verouderde worker-Heartbeat herstellen" --priority high --labels bug,workboard openclaw workboard create "Workboard-documentatie schrijven" --status ready --agent docs-agent --board docs --notes "Behandel de CLI, slash-opdracht, toewijzing en SQLite-status." ``` | Vlag | Doel | | ----------------------- | --------------------------------------- | | `--notes ` | Initiële kaartnotities | | `--status ` | Initiële status, standaard `todo` | | `--priority ` | Prioriteit, standaard `normal` | | `--agent ` | De kaart aan een agent- of eigenaar-id toewijzen | | `--board ` | De kaart in een bordnaamruimte opslaan | | `--labels ` | Door komma's gescheiden labels | | `--json` | De gemaakte kaart als machine-JSON afdrukken | `create` schrijft rechtstreeks naar de SQLite-status van Workboard. De kaart is onmiddellijk zichtbaar op het tabblad Workboard in de Control UI en voor Workboard-tools. ## `show` ```bash openclaw workboard show 7f4a2c10 openclaw workboard show 7f4a2c10 --json ``` Tekstuitvoer toont de compacte kaartregel en notities. JSON-uitvoer retourneert de volledige kaartrecord, inclusief uitvoeringsmetadata, pogingen, opmerkingen, koppelingen, bewijs, artefacten, workerlogboeken, protocolstatus, diagnostiek en automatiseringsmetadata. Bewijsstatussen in JSON zijn door de worker gerapporteerde resultaten. `passed` registreert de zelfbeoordeling van de worker van de bijgevoegde opdracht of controle; dit is geen onafhankelijk verificatie- resultaat. ## `move` ```bash openclaw workboard move 7f4a2c10 --status review openclaw workboard move 7f4a2c10 --status done --json ``` `move` wijzigt de status van de kaart via hetzelfde handmatige operatorpad als wanneer een kaart in het dashboard wordt versleept. Het accepteert een volledig kaart-id of een eenduidig voorvoegsel. Actieve blokkeringen vanwege afhankelijkheden en planning blijven van toepassing. Operators mogen een geclaimde kaart verplaatsen zonder het agentclaimtoken; claimtokens blijven beperkt tot mutaties via agenttools en worden uit JSON-uitvoer verwijderd. ## `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` roept eerst de Gateway-RPC-methode `workboard.cards.dispatch` van de actieve Gateway aan. Deze gebruikt dezelfde subagentruntime als de toewijzingsactie in het dashboard, zodat gereedstaande kaarten workerruns met taaktracking en gekoppelde sessiesleutels worden. `--max-starts` gebruikt de aanvullende methode `workboard.cards.dispatchWithOptions`, zodat een oudere Gateway de optie weigert voordat workers worden gestart; start de Gateway na een upgrade opnieuw voordat je de vlag gebruikt. Kaarten met een toegewezen agent gebruiken agentspecifieke subagent-sessiesleutels; niet-toegewezen kaarten behouden een niet-gespecificeerde subagent-sleutel, zodat de geconfigureerde standaardagent van de Gateway behouden blijft. De toewijzingslus: 1. Promoveert kinderen waarvan de afhankelijkheden gereed zijn naar `ready`. 2. Blokkeert verlopen claims of workerruns waarvoor een time-out is opgetreden. 3. Registreert toewijzingsmetadata op gereedstaande kaarten. 4. Selecteert een kleine batch niet-geclaimde gereedstaande kaarten. 5. Claimt elke geselecteerde kaart voor de dispatcher of toegewezen agent. 6. Start een subagent-workerrun met begrensde kaartcontext en het claimtoken van de kaart. 7. Slaat het workerrun-id, de sessiesleutel, de taakkoppeling wanneer het Gateway-taakregister die rapporteert, de uitvoeringsstatus en het workerlogboek op de kaart op. De selectie is terughoudend: één toewijzing start standaard maximaal drie workers, slaat gearchiveerde of reeds geclaimde kaarten over en start per doorgang slechts één kaart per eigenaar of agent. Kaarten die al eigendom zijn van actief uitgevoerd werk of werk dat wordt beoordeeld, blijven staan voor een latere toewijzing. Geef `--max-starts ` met een positief geheel getal door om de limiet per doorgang te wijzigen; de regel van één kaart per eigenaar blijft van toepassing, waardoor het effectieve aantal starts lager kan zijn. Als het starten van een worker mislukt nadat een kaart is geclaimd, blokkeert Workboard die kaart, wist het de claim en registreert het de fout in de uitvoerings- en workerlogmetadata van de kaart. Zo blijven mislukte starts zichtbaar in plaats van de kaart ongemerkt terug te plaatsen in de wachtrij. Als er geen expliciet Gateway-doel is opgegeven en de lokale Gateway niet beschikbaar is of de Workboard-toewijzingsmethode nog niet beschikbaar stelt, valt de CLI terug op uitsluitend gegevenstoewijzing voor de lokale Workboard-status. Uitsluitend gegevenstoewijzing kan nog steeds afhankelijkheden promoveren, verouderde claims opruimen en workerruns met een time-out blokkeren, maar start geen workers. Authenticatie-, machtigings- en validatiefouten, en fouten voor een expliciet `--url`- of `--token`-doel, worden rechtstreeks gerapporteerd in plaats van de terugval te activeren. Tekstuitvoer rapporteert workerstarts: ```text toewijzing voltooid: gestart=2 fouten=0 ``` Terugvaluitvoer is expliciet: ```text gateway niet beschikbaar; alleen gegevenstoewijzing: gepromoveerd=1 geblokkeerd=0 ``` JSON-uitvoer bevat het toewijzingsresultaat. Door Gateway ondersteunde toewijzing kan `started` en `startFailures` bevatten; de terugval naar uitsluitend gegevens bevat `gatewayUnavailable: true`. Claimtokens worden uit de JSON-uitvoer van kaarten verwijderd. In het dashboard wordt hetzelfde toewijzingsresultaat als een korte samenvatting weergegeven, zodat een operator kan zien hoeveel kaarten zijn gestart, gepromoveerd, geblokkeerd, opnieuw geclaimd of mislukt zonder de kaartdetails te openen. ## Gelijkwaardigheid van slash-opdrachten Kanalen die opdrachten ondersteunen, kunnen de overeenkomstige slash-opdracht gebruiken: ```text /workboard list /workboard show 7f4a2c10 /workboard create Verouderde worker-Heartbeat herstellen /workboard move 7f4a2c10 --status review /workboard dispatch ``` Toewijzing via slash-opdrachten gebruikt ook de subagentruntime van de Gateway en volgt dus hetzelfde gedrag voor claims, workerstarts en fouten als het Gateway-pad van het dashboard en de CLI. `/workboard list` en `/workboard show` zijn leesopdrachten voor geautoriseerde afzenders van opdrachten. `/workboard create`, `/workboard move` en `/workboard dispatch` wijzigen de bordstatus en vereisen de eigenaarsstatus op chatinterfaces of een Gateway-client met `operator.write` of `operator.admin`. ## Machtigingen Het CLI-toewijzingspad vraagt normaal gesproken om de Gateway-bereiken `operator.write` en `operator.read`. Aan een werkruimte gebonden kaarten worden rechtstreeks uitgevoerd in een exact geconfigureerde agentwerkruimte; een worktree-aanvraag wordt beperkt tot die map in plaats van de host door de repository beheerde code te laten materialiseren. De geselecteerde worker moet schrijfbare, niet-gedeelde toegang tot de Docker-sandbox voor die exacte werkruimte hebben, een actieve containerhash die overeenkomt met de aangevraagde koppelingen en het beleid, en geen mogelijkheid om uit de host te ontsnappen. Geef `--admin` door om expliciet `operator.admin` aan te vragen, een andere hostcheckout toe te staan en de normale beheerde worktree-installatie te gebruiken; de verbinding mislukt als dat bereik niet voor de client is goedgekeurd. Een alleen-lezen Gateway-token kan Workboard-gegevens via leesmethoden bekijken, maar kan geen kaarten maken of workers toewijzen. Werkruimtelimieten veranderen verder niets aan het handmatig verplaatsen van kaarten voor aanroepers met machtiging om Workboard te wijzigen. Lokale opdrachten `list`, `create`, `show` en `move` werken met de lokale OpenClaw-statusmap die door het huidige profiel wordt gebruikt. Gebruik `--dev` of `--profile ` bij de opdracht `openclaw` op het hoogste niveau wanneer je een andere statushoofdmap nodig hebt. ## Problemen oplossen ### Er verschijnen geen kaarten Controleer of de plugin is ingeschakeld voor hetzelfde profiel en dezelfde statushoofdmap: ```bash openclaw plugins inspect workboard --runtime --json ``` Als het dashboard kaarten toont, maar de CLI niet, controleer dan of beide opdrachten dezelfde instelling `--dev` of `--profile` gebruiken. ### Toewijzing meldt uitsluitend gegevens Start de Gateway of start deze opnieuw: ```bash openclaw gateway restart openclaw gateway status --deep ``` Probeer vervolgens `openclaw workboard dispatch` opnieuw. Terugval naar uitsluitend gegevens is nuttig voor het opschonen van lokale status, maar voor workerruns is een actieve Gateway nodig. ### Toewijzing start niets Controleer of er ten minste één kaart met status `ready` zonder actieve claim is: ```bash openclaw workboard list --status ready ``` Kaarten kunnen ook worden overgeslagen wanneer dezelfde eigenaar al uitgevoerd werk of werk ter beoordeling heeft. Verplaats voltooid werk naar `done`, geef verouderde claims vrij via de Workboard-tools of voer de toewijzing opnieuw uit nadat de actieve worker is voltooid. ## Gerelateerd - [Workboard-plugin](/nl/plugins/workboard) - [CLI-referentie](/nl/cli) - [Slash-opdrachten](/nl/tools/slash-commands) - [Control UI](/nl/web/control-ui)