Workboard-plugin

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

Workboard is bewust klein gehouden: 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 relatief 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 de actie Install niet nodig.
3. Als de UI meldt dat opnieuw opstarten vereist is, start u de Gateway opnieuw.

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

De equivalente CLI-werkwijze is:

openclaw plugins enable workboardopenclaw gateway restartopenclaw dashboard

Configuratie

Workboard heeft geen pluginspecifieke configuratie. Schakel het in of uit met de standaardvermelding voor de plugin:

{  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, de protocolstatus van workers, 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 beheerder zien hoe een kaart over het bord is verplaatst zonder de gekoppelde sessie te openen. Het gaat om lokale operationele context, niet om een vervanging voor sessietranscripten of de geschiedenis van GitHub-issues.

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

Werk starten vanaf een kaart

Niet-gekoppelde kaarten kunnen rechtstreeks werk starten:

• Codex uitvoeren / Claude uitvoeren start een door een taak bijgehouden agentuitvoering met een expliciete engine, verzendt de prompt van de kaart en markeert de kaart als running. Codex-uitvoeringen gebruiken openai/gpt-5.6-sol; Claude-uitvoeringen gebruiken anthropic/claude-sonnet-4-6.
• Codex openen / Claude openen maakt een gekoppelde dashboardsessie zonder de prompt van de kaart te verzenden of de kaart te verplaatsen, voor handmatig werk dat aan het bord gekoppeld blijft.

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

Het dashboard vernieuwt de taakstatus vanuit het taakregister van de Gateway en koppelt taken aan kaarten op basis van taak-id, uitvoerings-id of gekoppelde sessiesleutel. Een taak in de wachtrij of in uitvoering houdt de levenscyclus van de kaart actief. Een voltooide, mislukte, verlopen of geannuleerde taak verplaatst de kaart naar review of blocked volgens dezelfde synchronisatieregel als voor gekoppelde sessies (zie Synchronisatie van de sessielevenscyclus).

Agenttools

Geclaimde kaarten weigeren mutaties via 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, maskeert metadata.claim.token als [redacted] (het token zelf wordt één keer, op het hoogste niveau, alleen 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; hiervoor is het token niet vereist.

Dispatch

Dispatch is lokaal binnen de Gateway: het start geen willekeurige besturingssysteemprocessen. Normale OpenClaw-subagentsessies blijven verantwoordelijk voor de uitvoering. Eén dispatchronde:

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

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

Selectie van werkers

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

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

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

Als een werker niet kan worden gestart nadat een kaart is geclaimd, blokkeert Workboard de kaart, wist het de claim, legt het de mislukte start van de uitvoering vast en voegt het een werklogregel toe, die zichtbaar is in het dashboard, de CLI-JSON, agenttools en kaartdiagnoses.

Ingangspunten

• 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 terugvaloptie voor beheerders: als de Gateway-aanroep mislukt met een verbindings-/onbeschikbaarheidsfout (of een unknown method-fout bij oudere Gateways), er geen expliciet --url/--token-doel is opgegeven en er geen geconfigureerde externe Gateway (OPENCLAW_GATEWAY_URL of gateway.mode: remote) van toepassing is, voert de CLI een gegevensgerichte dispatch uit op de lokale SQLite-status. Deze kan afhankelijkheden promoveren, verouderde claims opschonen en uitvoeringen met een verstreken tijdslimiet blokkeren, maar kan geen werkers starten. Authenticatie-, toestemmings- 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 legt deze intentie vast en stelt deze beschikbaar in de werkcontext; 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 "Fix stale card lifecycle" --priority high --labels bug,workboardopenclaw workboard show <card-id> [--json]openclaw workboard dispatch [--board <id>] [--json]

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

Zie Workboard-CLI voor alle vlaggen, JSON-uitvoer, terugvalgedrag van de Gateway, afhandeling van id-voorvoegsels, selectieregels voor dispatch en probleemoplossing.

/workboard list, /workboard show <card-id>, /workboard create <title> en /workboard dispatch weerspiegelen de CLI. List en show zijn leesbewerkingen voor elke geautoriseerde afzender van opdrachten. Create en dispatch vereisen de status van eigenaar op chatoppervlakken, of een Gateway-client met operator.write/operator.admin.

Synchronisatie van de sessielevenscyclus

Kaarten kunnen worden gekoppeld aan een bestaande dashboardsessie of aan een sessie die wordt aangemaakt wanneer je vanuit de kaart begint te werken. Gekoppelde kaarten tonen de levenscyclus van de sessie inline: actief, verouderd, gekoppeld inactief, voltooid, mislukt of ontbrekend. Je kunt ook een bestaande sessie vastleggen vanuit 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, indien beschikbaar, de notities met de recente gebruikersprompt plus het nieuwste antwoord van de assistent.

Als de gekoppelde sessie ontbreekt, blijft de kaart voor context gekoppeld en biedt deze nog steeds startopties om opnieuw te beginnen 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.

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

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

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

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

Dashboardwerkstroom

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

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.

Opslag

Workboard slaat duurzame gegevens op in een relationele SQLite-database die eigendom is van de Plugin, onder de statusmap van OpenClaw: borden, kaarten, labels, levenscyclusgebeurtenissen, uitvoeringspogingen, opmerkingen, afhankelijkheidskoppelingen, bewijs, artefactverwijzingen, metadata en binaire inhoud van bijlagen, diagnostiek, meldingen, workerlogboeken, protocolstatus en abonnementen bevinden zich allemaal in Workboard-tabellen (niet in sleutel-waarde-items van de Plugin). Een kaartexport behoudt het verhaal van het bord zonder de binaire inhoud van bijlagen inline op te nemen.

Installaties die Workboard in de .28-release hebben gebruikt, kunnen openclaw doctor --fix uitvoeren om de uitgebrachte verouderde naamruimten voor Plugin-status (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 operatorsessies kunnen kaarten weergeven, maar kunnen ze niet aanmaken, bewerken, verplaatsen of verwijderen.

Bij het starten van een kaart wordt niet de verwachte sessie geopend

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

Verzending start geen worker

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

openclaw workboard list --status ready

Als de CLI meldt dat verzending alleen gegevens verwerkt, start of herstart je de Gateway en probeer je het opnieuw. Verzending die alleen gegevens verwerkt, werkt de lokale bordstatus bij, maar kan geen uitvoeringen van subagent-workers starten. Kaarten kunnen ook worden overgeslagen wanneer een andere kaart voor dezelfde eigenaar of agent al wordt uitgevoerd of op beoordeling wacht; voltooi, blokkeer of geef dat actieve werk vrij voordat je meer werk voor dezelfde eigenaar verzendt.

Gerelateerd

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