Workboard-Plugin

De Workboard-plugin voegt een optioneel bord in Kanban-stijl toe aan de Control UI: werkkaarten op agentformaat, toewijzing aan agents en een koppeling terug naar de taak, run en dashboardsessie van de kaart.

Workboard is bewust klein: het houdt lokaal operationeel werk bij voor één OpenClaw Gateway. Het is geen vervanging voor GitHub Issues, Linear, Jira of andere projectbeheersystemen voor teams.

Inschakelen

Workboard is gebundeld, maar standaard uitgeschakeld:

1. Open Plugins in de Control UI of gebruik /settings/plugins ten opzichte van het geconfigureerde basispad van de Control UI. Een basispad van /openclaw gebruikt bijvoorbeeld /openclaw/settings/plugins.
2. Zoek Workboard en kies Enable. Omdat Workboard bij OpenClaw is inbegrepen, is geen Install-actie nodig.
3. Als de UI meldt dat opnieuw opstarten vereist is, start je de Gateway opnieuw.

Het tabblad Workboard verschijnt in de dashboardnavigatie nadat de pluginruntime is geladen. Zolang de plugin is uitgeschakeld, blijft het tabblad verborgen in de navigatie. Als je de route /workboard rechtstreeks opent terwijl de plugin is uitgeschakeld of wordt geblokkeerd door plugins.allow/plugins.deny, wordt een status weergegeven waarin de plugin niet beschikbaar is, in plaats van kaartgegevens.

De equivalente CLI-workflow is:

openclaw plugins enable workboardopenclaw gateway restartopenclaw dashboard

Configuratie

Workboard heeft geen pluginspecifieke configuratie. Schakel de plugin in of uit met de standaard pluginvermelding:

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

openclaw plugins disable workboardopenclaw gateway restart

Kaartvelden

Kaarten bevatten ook compacte metagegevens voor pogingen, opmerkingen, koppelingen, bewijs, artefacten, automatiseringsinstellingen, bijlagen, workerlogboeken, workerprotocolstatus, claims, diagnostiek, meldingen, sjabloon-id, archiefstatus en detectie van verouderde sessies, plus een lijst met recente gebeurtenissen (created, edited, moved, linked, specified, decomposed, claimed, heartbeat, execution_updated, attempt_started, attempt_updated, comment_added, link_added, proof_added, artifact_added, attachment_added, diagnostic, notification, dispatch, orchestration, protocol_violation, archived, unarchived, stale). Met deze metagegevens kan een operator zien hoe een kaart door het bord is verplaatst zonder de gekoppelde sessie te openen; het is lokale operationele context, geen vervanging voor sessietranscripten of de geschiedenis van GitHub-issues.

De plugin en de Control UI gebruiken één Workboard-kaartcontract. Dashboardvernieuwingen behouden daarom de herkomst en autoriteit van de werkruimte, de claimstatus, diagnostische acties en volgnummers van meldingen, in plaats van een kleinere kopie van de kaart te projecteren die alleen voor de UI bestemd is. Onbekende diagnostische typen, diagnostische ernstniveaus en meldingstypen worden genegeerd totdat beide oppervlakken ze ondersteunen; ze worden nooit herschreven naar een andere geldige status.

Het geopende dashboard wordt bijgewerkt via plugin.workboard.changed-invalidaties. Elke gebeurtenis bevat alleen een store-epoch en revisie; de UI leest vervolgens de canonieke kaarten opnieuw via de normale operator.read-RPC. Meerdere revisies worden samengevoegd tot één vervolgleesactie. Workboard stelt die leesactie uit terwijl een kaart wordt versleept, bewerkt of geschreven en hervat deze nadat de lokale interactie is voltooid. Bij opnieuw verbinden wordt altijd een canonieke herlaadactie uitgevoerd. Er vindt geen routinematige volledige-kaartpolling plaats en Refresh blijft beschikbaar voor handmatig herstel.

Wanneer er meer dan één bord bestaat, bevat de werkbalk een Board-filter dat wordt ondersteund door permanente bordmetagegevens en niet alleen door de momenteel zichtbare kaarten. Lege en gearchiveerde borden blijven daardoor selecteerbaar. Kaarten zonder expliciete bord-id behoren tot het canonieke bord default. Elk bord heeft een canonieke pagina /workboard/<boardId> die als bladwijzer kan worden opgeslagen, gedeeld of vastgezet in de zijbalk. De eerder uitgebrachte vorm /workboard?board=<boardId> blijft een compatibiliteitsalias en leidt door naar die pagina, waarbij andere queryparameters behouden blijven. Als je All boards kiest, keer je terug naar /workboard.

Kaarten worden opgeslagen in de eigen Gateway-status van de plugin en worden samen met de rest van de OpenClaw-status van die Gateway verplaatst (zie Opslag).

Werk starten vanaf een kaart

Niet-gekoppelde kaarten kunnen rechtstreeks werk starten:

• Run Codex / Run Claude start een door een taak gevolgde agent-run met een expliciete engine, verzendt de kaartprompt en markeert de kaart als running. Codex- runs gebruiken openai/gpt-5.6-sol; Claude-runs gebruiken anthropic/claude-sonnet-4-6.
• Open Codex / Open Claude maakt een gekoppelde dashboardsessie zonder de kaartprompt te verzenden of de kaart te verplaatsen, voor handmatig werk dat aan het bord gekoppeld blijft.

Autonome starts gebruiken het pad voor door taken gevolgde agent-runs van de Gateway (standaardagent en -model, tenzij Codex/Claude expliciet wordt gekozen); Workboard koppelt vervolgens de resulterende taak, run-id en sessiesleutel terug aan de kaart. Elke gekoppelde uitvoering registreert ook een samenvatting van de poging (engine, modus, model, run-id, tijdstempels, status, doorlopend aantal mislukkingen), zodat herhaalde mislukkingen zichtbaar blijven.

Het dashboard vernieuwt de taakstatus vanuit het taaktboek van de Gateway en koppelt taken aan kaarten op basis van taak-id, run-id of gekoppelde sessiesleutel. Een taak die in de wachtrij staat of wordt uitgevoerd, houdt de levenscyclus van de kaart actief; een voltooide, mislukte, verlopen of geannuleerde taak verplaatst de kaart richting review of blocked volgens dezelfde synchronisatieregel als gekoppelde sessies (zie Synchronisatie van de sessielevenscyclus).

Agent-tools

Bewijsstatussen zijn door workers gerapporteerde uitkomsten, geen onafhankelijke verificatie. Een passed-vermelding betekent dat de worker meldt dat de opdracht of controle is geslaagd; gebruikers die een onafhankelijke kwaliteitscontrole nodig hebben, moeten de bijgevoegde opdracht, URL of het artefact inspecteren en hun eigen verificatie uitvoeren. workboard_proof retourneert de proofId van de nieuwe record. Wanneer workboard_complete de terminale status van datzelfde bewijs rapporteert, geef je proofId door, zodat de openstaande record ter plaatse wordt afgehandeld zonder zijn identiteit of tijdstempel te verliezen. Bewijs dat al dezelfde terminale status heeft, wordt ongewijzigd hergebruikt. Voltooiingsbewijs zonder proofId blijft alleen toevoegbaar, zodat een latere nieuwe poging oudere geschiedenis niet kan herschrijven enkel omdat de opdracht of notitie identiek is.

Geclaimde kaarten weigeren mutaties door agenttools van andere agents, tenzij de aanroeper het claimtoken bezit dat door workboard_claim is geretourneerd. Elke kaart die door een agenttool of Gateway-RPC-aanroep wordt geretourneerd, redigeert metadata.claim.token tot [redacted] (het token zelf wordt eenmalig, op het hoogste niveau en uitsluitend door workboard_claim geretourneerd), zodat dashboardbeheerders en andere agents de claimstatus kunnen inspecteren zonder ooit een bruikbaar token te zien. Herstel verloopt via workboard_promote/workboard_reassign/workboard_reclaim, waarvoor het token niet vereist is.

Dispatch

Dispatch is lokaal voor de Gateway: er worden geen willekeurige OS-processen gestart. Normale OpenClaw-subagentsessies blijven verantwoordelijk voor de uitvoering. Eén dispatchdoorgang:

1. Promoveert kaarten waarvan de afhankelijkheden gereed zijn.
2. Legt dispatchmetadata vast op gereedstaande kaarten.
3. Blokkeert verlopen claims of uitvoeringen waarvan de time-out is verstreken.
4. Markeert door het bord geconfigureerde triagekaarten als orchestratiekandidaten.
5. Claimt een kleine batch gereedstaande kaarten en start workeruitvoeringen via de subagentruntime van de Gateway.

Workers krijgen een begrensde kaartcontext plus het claimtoken dat nodig is om via de Workboard-tools een Heartbeat te verzenden of de kaart te voltooien of blokkeren.

Werkruimtepaden volgen de bestaande bestandssysteembevoegdheden van de aanroeper. Gateway-clients met operator.write kunnen geconfigureerde agentwerkruimten gebruiken; operator.admin-clients kunnen andere host-check-outs gebruiken. Agenttools in een sandbox gebruiken de werkruimtetoegang van hun sandbox, terwijl niet-gesandboxte tools die uitsluitend voor werkruimten bestemd zijn hun geconfigureerde werkruimteroot gebruiken. Workboard legt die bevoegdheid vast wanneer een werkruimte wordt toegewezen en doorsnijdt deze tijdens dispatch opnieuw met de bevoegdheid van de huidige aanroeper, zodat een persistente kaart de toegang van een latere aanroeper niet kan uitbreiden. Bij oudere kaarten met een expliciete hostwerkruimte maar zonder vastgelegde bevoegdheid moet die werkruimte opnieuw worden opgeslagen voordat dispatch met volledige hosttoegang mogelijk is; kaarten zonder hostpad nemen bij hun eerste dispatch de bevoegdheid van de huidige aanroeper over.

Werkruimtegebonden dispatch accepteert een map of Git-check-out alleen wanneer de root van de repository exact overeenkomt met de doelwerkruimte van de agent. Een worktree-aanvraag wordt beperkt tot die map en als mapwerkruimte opgeslagen, zodat de host de check-out niet materialiseert of instelcode van de repository uitvoert. De doelworker moet voor precies die werkruimte een schrijfbare, niet-gedeelde Docker-sandbox gebruiken, zonder uitvoering met verhoogde bevoegdheden, persistente overrides voor uitvoering op de host/Node of niet-geclassificeerde Plugin- en MCP-tools. Workboard somt zijn geregistreerde tools op in plaats van een workboard_*-voorvoegsel te vertrouwen, en dispatch weigert een actieve Docker-container waarvan de live hash van mount/configuratie verouderd is. Dispatch rapporteert het incompatibele doelbeleid in plaats van een minder strikt geïsoleerde worker te starten. Dispatch met volledige hosttoegang kan andere lokale check-outs als doel gebruiken en behoudt de normale beheerde worktree-instelling.

Werkruimtebevoegdheid creëert geen tweede machtigingsmodel voor de levenscyclus van kaarten. Aanroepers die Workboard-kaarten mogen muteren, kunnen deze op elk oppervlak handmatig door dezelfde statussen verplaatsen; alleen-lezen toegang tot een werkruimte voorkomt uitsluitend workerdispatch waarvoor schrijfrechten nodig zijn.

Workerselectie

Elke cyclus start standaard maximaal 3 workers. Gereedstaande kaarten worden gesorteerd op prioriteit, vervolgens positie en daarna aanmaaktijd. Een cyclus start slechts één kaart per eigenaar/agent en slaat eigenaren over die al actief werk of reviewwerk op het bord hebben. Gearchiveerde kaarten, kaarten met een actieve claim en kaarten die niet de status ready hebben, worden nooit geselecteerd om workers te starten (ze kunnen nog steeds worden beïnvloed door de gegevenszijde van dispatch: verouderde claims opschonen, afhankelijkheden promoveren en time-outs opschonen).

Sessiesleutels zijn deterministisch per bord/kaart, zodat herhaalde dispatches teruggaan naar dezelfde workerlane in plaats van niet-gerelateerde sessies te maken:

• Toegewezen kaarten: agent:<agentId>:subagent:workboard-<boardId>-<cardId>
• Niet-toegewezen kaarten: subagent:workboard-<boardId>-<cardId> (Gateway bepaalt de geconfigureerde standaardagent)

Als een worker niet kan worden gestart nadat een kaart is geclaimd, blokkeert Workboard de kaart, verwijdert het de claim, registreert het de fout bij het starten van de run en voegt het een workerlogregel toe, zichtbaar in het dashboard, de CLI-JSON, agenttools en de kaartdiagnostiek.

Toegangspunten

• Dispatchactie in het dashboard
• openclaw workboard dispatch
• /workboard dispatch in een kanaal dat opdrachten ondersteunt

Alle drie gebruiken de subagentruntime van de Gateway wanneer de Gateway beschikbaar is. De CLI heeft één fallback voor operators: als de Gateway-aanroep mislukt met een verbindings-/onbeschikbaarheidsfout (of een unknown method-fout voor oudere Gateways), er geen expliciet --url-/--token-doel is en er geen geconfigureerde externe Gateway (OPENCLAW_GATEWAY_URL of gateway.mode: remote) van toepassing is, voert de CLI een dispatch uit die alleen gegevens verwerkt op basis van de lokale SQLite-status. Deze kan afhankelijkheden promoveren, verouderde claims opschonen en runs met een time-out blokkeren, maar kan geen workers starten. Authenticatie-, machtigings- en validatiefouten van een bereikbare Gateway worden niet als onbeschikbaarheid behandeld; ze worden weergegeven als opdrachtfouten. Hetzelfde geldt voor elke Gateway- fout wanneer een expliciet --url-/--token-doel is opgegeven.

Bordmetadata kan autoDecompose, autoDecomposePerDispatch, defaultAssignee en orchestratorProfile instellen. OpenClaw registreert deze intentie en maakt die beschikbaar in de workercontext; de daadwerkelijke specificatie/opsplitsing verloopt nog steeds via de normale Workboard-tools.

CLI en slashopdracht

openclaw workboard list [--board <id>] [--status <status>] [--include-archived] [--json]openclaw workboard create "Verouderde levenscyclus van kaart herstellen" --priority high --labels bug,workboardopenclaw workboard show <card-id> [--json]openclaw workboard move <card-id> --status <status> [--json]openclaw workboard dispatch [--board <id>] [--json]

list-tekstuitvoer verbergt standaard gearchiveerde kaarten (--include-archived overschrijft dit); --json bevat altijd gearchiveerde kaarten, overeenkomstig het contract voor volledige kaarten dat bestaande scripts gebruiken. show en move accepteren een ondubbelzinnig id- voorvoegsel. list, create, show en move lezen/schrijven altijd rechtstreeks de lokale Pluginstatus. Alleen dispatch roept de actieve Gateway aan, met de hierboven beschreven fallback.

Zie Workboard-CLI voor alle vlaggen, JSON-uitvoer, Gateway- fallbackgedrag, verwerking van id-voorvoegsels, selectieregels voor dispatch en probleemoplossing.

/workboard list, /workboard show <card-id>, /workboard create <title>, /workboard move <card-id> --status <status> en /workboard dispatch weerspiegelen de CLI. Weergeven en tonen zijn leesbewerkingen voor elke gemachtigde afzender van opdrachten. Maken, verplaatsen en dispatch vereisen de eigenaarsstatus op chatinterfaces, of een Gateway- client met operator.write/operator.admin. Handmatige verplaatsingen door operators gebruiken hetzelfde gedrag voor het overschrijven van claims als slepen en neerzetten in het dashboard. De toegang tot de worktree volgt nog steeds dezelfde hierboven beschreven werkruimtegrens.

Synchronisatie van de sessielevenscyclus

Kaarten kunnen worden gekoppeld aan een bestaande dashboardsessie of aan een sessie die wordt gemaakt wanneer je werk vanuit de kaart start. Gekoppelde kaarten tonen de sessielevenscyclus inline: actief, verouderd, gekoppeld en inactief, voltooid, mislukt of ontbrekend. Je kunt ook een bestaande sessie vastleggen vanaf het tabblad Sessions met Add to Workboard; de kaart wordt aan die sessie gekoppeld, gebruikt het sessielabel of de recente gebruikersprompt als titel en vult notities vooraf in met de recente gebruikersprompt plus het laatste antwoord van de assistent, indien beschikbaar.

Als de gekoppelde sessie ontbreekt, blijft de kaart voor context gekoppeld en biedt deze nog steeds startbesturingselementen om opnieuw te starten in een nieuwe sessie. Als een actieve gekoppelde sessie geen recente activiteit meer rapporteert, markeert Workboard de kaart als stale en slaat dit op als metadata totdat de levenscyclus het wist.

Zolang een kaart zich in een actieve werkstatus bevindt, volgt Workboard de gekoppelde sessie:

Handmatige reviewstatussen hebben voorrang. Als je een kaart verplaatst naar review, blocked of done, stopt de automatische synchronisatie voor die kaart totdat je deze terugverplaatst naar todo of running.

Het starten van een kaart gebruikt normale Gateway-sessies; Workboard slaat alleen kaart- metadata en koppelingen op. Het gesprekstranscript, de modelselectie en de run- levenscyclus blijven in beheer van het reguliere sessiesysteem. Gebruik Stop op een actieve gekoppelde kaart om de actieve run af te breken. Workboard markeert die kaart als blocked, zodat deze zichtbaar blijft voor opvolging.

Nieuwe kaarten kunnen beginnen met Workboard-sjablonen (bugfix, docs, release, pr_review, plugin). Sjablonen vullen titel, notities, labels en prioriteit vooraf in; de sjabloon-id wordt opgeslagen als kaartmetadata.

Dashboardworkflow

1. Open het tabblad Workboard in de Control UI.
2. Maak een kaart met een titel, notities, prioriteit, labels, een optionele agent en een optioneel gekoppelde sessie, of open Sessions en kies Add to Workboard voor een bestaande sessie.
3. Sleep de kaart tussen kolommen, of focus het compacte statusbesturingselement en gebruik het menu of ArrowLeft/ArrowRight. Tijdens het slepen wordt de bronkaart gedimd en krijgen beschikbare doelkolommen een omlijning.
4. Start werk vanuit de kaart om een dashboardsessie te maken of opnieuw te gebruiken.
5. Open de gekoppelde sessie vanuit de kaart terwijl de agent werkt.
6. Laat de levenscyclussynchronisatie actief werk verplaatsen naar review/blocked en verplaats de kaart vervolgens handmatig naar done wanneer deze is geaccepteerd.

Sessiebordwidgets

Workboard levert twee native widgets voor sessiedashboards (zie Dashboards). De agent maakt ze vast met de tool dashboard met content: { kind: "plugin", pluginKind, props }, waarna ze worden weergegeven als eigen UI met livegegevens, zonder sandboxframe of toekenning van mogelijkheden:

• workboard:card met props: { cardId } toont één kaart met het status- besturingselement, de prioriteit en de toegewezen agent.
• workboard:mini met optioneel props: { boardId, limit } toont aantallen per status plus de belangrijkste gereedstaande/actieve kaarten en koppelt naar de volledige bordpagina. Zonder boardId worden alle borden samengevoegd; met boardId wordt het bereik beperkt tot dat bord (kaarten die zonder expliciete bord-id zijn gemaakt, staan op default).

Diagnostiek

Diagnostiek wordt berekend op basis van lokale kaartmetadata. Ingebouwde controles signaleren:

Machtigingen

Gateway-RPC-methoden vallen onder workboard.*:

Geen enkele RPC-methode vereist operator.admin. Browsers die zijn verbonden met alleen-lezen operatortoegang kunnen het bord bekijken, maar kunnen kaarten niet wijzigen. Een beheerdersbereik verruimt de geaccepteerde Workboard-hostpaden; het wijzigt de beschikbare methoden niet.

Opslag

Workboard slaat duurzame gegevens op in een relationele SQLite-database die eigendom is van de Plugin onder de OpenClaw-statusmap: borden, kaarten, labels, levenscyclusgebeurtenissen, runpogingen, opmerkingen, afhankelijkheidskoppelingen, bewijs, artefactverwijzingen, bijlagemetadata en -blobs, diagnostiek, notificaties, workerlogs, protocolstatus en abonnementen bevinden zich allemaal in Workboard-tabellen (niet in sleutel-waarde-items van de Plugin). Een kaart-export behoudt het bordverhaal zonder de inhoud van bijlageblobs inline op te nemen.

Installaties die Workboard in de release .28 gebruikten, kunnen openclaw doctor --fix uitvoeren om de meegeleverde verouderde naamruimten voor Pluginstatus (workboard.cards, workboard.boards, workboard.notify en, indien aanwezig, workboard.attachments) naar de relationele database te migreren.

Probleemoplossing

Het tabblad meldt dat Workboard niet beschikbaar is

openclaw plugins inspect workboard --runtime --json

Als plugins.allow is geconfigureerd, voeg je workboard eraan toe. Als plugins.deny workboard bevat, verwijder je dit voordat je de Plugin inschakelt.

Kaarten worden niet opgeslagen

Controleer of de browserverbinding operator.write-toegang heeft. Alleen-lezen operator- sessies kunnen kaarten weergeven, maar kunnen ze niet maken, bewerken, verplaatsen of verwijderen.

Het starten van een kaart opent niet de verwachte sessie

Controleer de agent-id en gekoppelde sessie van de kaart en open vervolgens Sessions of Chat om de werkelijke runstatus te bekijken.

Dispatch start geen worker

Controleer of er ten minste één ready-kaart zonder actieve claim is:

openclaw workboard list --status ready

Als de CLI alleen-gegevensdispatch meldt, start of herstart je de Gateway en probeer je het opnieuw. Alleen-gegevensdispatch werkt de lokale bordstatus bij, maar kan geen subagentworkerruns starten. Kaarten kunnen ook worden overgeslagen wanneer een andere kaart voor dezelfde eigenaar of agent al wordt uitgevoerd of op review wacht; voltooi, blokkeer of geef dat actieve werk vrij voordat je meer werk voor dezelfde eigenaar dispatcht.

Gerelateerd

• Control-UI
• Werkbord-CLI
• Plugins
• Plugins beheren
• Sessies