Workboard-CLI

openclaw workboard is de terminalinterface voor de meegeleverde Workboard-plugin. 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:

openclaw plugins enable workboardopenclaw gateway restart

Gebruik

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]

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

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

De tekstuitvoer is compact:

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.

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

openclaw workboard create "Verouderde worker-Heartbeat herstellen" --priority high --labels bug,workboardopenclaw workboard create "Workboard-documentatie schrijven" --status ready --agent docs-agent --board docs --notes "Behandel de CLI, slash-opdracht, toewijzing en SQLite-status."

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

openclaw workboard show 7f4a2c10openclaw 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

openclaw workboard move 7f4a2c10 --status reviewopenclaw 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

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 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 <count> 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:

toewijzing voltooid: gestart=2 fouten=0

Terugvaluitvoer is expliciet:

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:

/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 <name> 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:

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:

openclaw gateway restartopenclaw 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:

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
• CLI-referentie
• Slash-opdrachten
• Control UI