openclaw workboard is het terminaloppervlak voor de gebundelde
Workboard Plugin. Hiermee kan een operator kaarten weergeven, een
kaart maken, één kaart inspecteren en de draaiende Gateway vragen om klaarstaand werk naar
subagent-worker-runs te sturen.
Schakel de Plugin in voordat je de opdracht gebruikt:
Gebruik
list
| Vlag | Doel |
|---|---|
--board <id> | Beperk resultaten tot één board-naamruimte |
--status <status> | Beperk resultaten tot één Workboard-status |
--include-archived | Neem gearchiveerde kaarten op in compacte tekstuitvoer |
--json | Druk de volledige kaartenlijst af als machine-JSON |
/workboard list. Geef --include-archived mee om ze weer te geven. JSON-uitvoer
behoudt de volledige kaartenlijst, inclusief gearchiveerde kaarten, voor bestaande automatisering.
create
| Vlag | Doel |
|---|---|
--notes <text> | Initiële kaartnotities |
--status <status> | Initiële status, standaard todo |
--priority <priority> | Prioriteit, standaard normal |
--agent <id> | Wijs de kaart toe aan een agent- of eigenaar-id |
--board <id> | Sla de kaart op in een board-naamruimte |
--labels <items> | Door komma’s gescheiden labels |
--json | Druk de gemaakte kaart af als machine-JSON |
create schrijft rechtstreeks naar de Workboard SQLite-status. De kaart is direct
zichtbaar in het Workboard-tabblad van de Control UI en voor Workboard-tools.
show
dispatch
dispatch roept eerst de RPC-methode
workboard.cards.dispatch van de draaiende Gateway aan. Dat pad gebruikt dezelfde subagent-runtime als de
dispatch-actie in het dashboard, zodat ready-kaarten taakgevolgde worker-runs worden met
gekoppelde sessiesleutels. Kaarten met een toegewezen agent gebruiken agent-gebonden subagent-
sessiesleutels; niet-toegewezen kaarten behouden een niet-gebonden subagent-sleutel zodat de
geconfigureerde standaardagent van de Gateway behouden blijft.
De dispatchlus:
- Promoveert dependency-ready kinderen naar
ready. - Blokkeert verlopen claims of worker-runs met timeout.
- Registreert dispatchmetadata op ready-kaarten.
- Selecteert een kleine batch niet-geclaimde ready-kaarten.
- Claimt elke geselecteerde kaart voor de dispatcher of toegewezen agent.
- Start een subagent-worker-run met begrensde kaartcontext en het kaartclaim- token.
- Slaat de worker-run-id, sessiesleutel, taakkoppeling wanneer het Gateway-taakregister die rapporteert, uitvoeringsstatus en worker-log op de kaart op.
--url- of --token-doel, worden rechtstreeks gerapporteerd.
Tekstuitvoer rapporteert worker-starts:
started en startFailures bevatten; data-only fallback bevat
gatewayUnavailable: true. Claimtokens worden geredigeerd uit kaart-JSON-uitvoer.
In het dashboard wordt hetzelfde dispatchresultaat getoond als een korte samenvatting, zodat een
operator kan zien hoeveel kaarten zijn gestart, gepromoveerd, geblokkeerd, teruggeclaimd of
mislukt zonder kaartdetails te openen.
Pariteit van slash-commando’s
Kanalen met opdrachtondersteuning kunnen het bijbehorende slash-commando gebruiken:/workboard list en /workboard show zijn leesopdrachten voor geautoriseerde opdrachtzenders.
/workboard create en /workboard dispatch wijzigen boardstatus en
vereisen eigenaarstatus op chatoppervlakken of een Gateway-client met operator.write
of operator.admin.
Machtigingen
Het CLI-dispatchpad roept Gateway RPC aan met scopesoperator.read en
operator.write. Een alleen-lezen Gateway-token kan Workboard-gegevens inspecteren
via leesmethoden, maar kan geen kaarten maken of workers dispatchen.
Lokale opdrachten list, create en show werken op de lokale OpenClaw-statusmap
die door het huidige profiel wordt gebruikt. Gebruik --dev of --profile <name> op de
top-level opdracht openclaw wanneer je een andere statusroot nodig hebt.
Problemen oplossen
Er verschijnen geen kaarten
Controleer of de Plugin is ingeschakeld voor hetzelfde profiel en dezelfde statusroot:--dev of --profile gebruiken.
Dispatch meldt Data-Only
Start of herstart de Gateway:openclaw workboard dispatch opnieuw. Data-only fallback is nuttig voor lokaal
opschonen van status, maar worker-runs hebben een live Gateway nodig.
Dispatch start niets
Controleer of er minstens éénready-kaart zonder actieve claim is:
done, geef verouderde claims vrij via de Workboard-
tools, of voer dispatch opnieuw uit nadat de actieve worker klaar is.