openclaw workboard ist die Terminal-Oberfläche für das gebündelte
Workboard-Plugin. Sie ermöglicht es einem Operator, Karten aufzulisten, eine
Karte zu erstellen, eine Karte zu prüfen und den laufenden Gateway anzuweisen, bereite Arbeit in
Subagent-Worker-Läufe zu dispatchen.
Aktivieren Sie das Plugin, bevor Sie den Befehl verwenden:
Verwendung
list
| Flag | Zweck |
|---|---|
--board <id> | Ergebnisse auf einen Board-Namespace begrenzen |
--status <status> | Ergebnisse auf einen Workboard-Status begrenzen |
--include-archived | Archivierte Karten in kompakter Textausgabe anzeigen |
--json | Die vollständige Kartenliste als Maschinen-JSON ausgeben |
/workboard list entspricht. Übergeben Sie --include-archived, um sie anzuzeigen. Die JSON-Ausgabe
behält für bestehende Automatisierung die vollständige Kartenliste einschließlich archivierter Karten bei.
create
| Flag | Zweck |
|---|---|
--notes <text> | Anfangsnotizen der Karte |
--status <status> | Anfangsstatus, Standard todo |
--priority <priority> | Priorität, Standard normal |
--agent <id> | Die Karte einem Agent oder einer Owner-ID zuweisen |
--board <id> | Die Karte in einem Board-Namespace speichern |
--labels <items> | Kommagetrennte Labels |
--json | Die erstellte Karte als Maschinen-JSON ausgeben |
create schreibt direkt in den Workboard-SQLite-Status. Die Karte ist sofort
im Workboard-Tab der Control UI und für Workboard-Tools sichtbar.
show
dispatch
dispatch ruft zuerst die laufende Gateway-RPC-Methode
workboard.cards.dispatch auf. Dieser Pfad verwendet dieselbe Subagent-Runtime wie die
Dispatch-Aktion des Dashboards, sodass bereite Karten zu aufgabenverfolgten Worker-Läufen mit
verknüpften Sitzungsschlüsseln werden. Karten mit zugewiesenem Agent verwenden agentbezogene
Subagent-Sitzungsschlüssel; nicht zugewiesene Karten behalten einen nicht bereichsgebundenen Subagent-Schlüssel bei, sodass der
konfigurierte Standard-Agent des Gateway erhalten bleibt.
Die Dispatch-Schleife:
- Stuft abhängigkeitsbereite untergeordnete Karten auf
readyhoch. - Blockiert abgelaufene Claims oder Worker-Läufe mit Zeitüberschreitung.
- Erfasst Dispatch-Metadaten auf bereiten Karten.
- Wählt einen kleinen Batch nicht beanspruchter bereiter Karten aus.
- Beansprucht jede ausgewählte Karte für den Dispatcher oder zugewiesenen Agent.
- Startet einen Subagent-Worker-Lauf mit begrenztem Kartenkontext und dem Claim-Token der Karte.
- Speichert die Worker-Lauf-ID, den Sitzungsschlüssel, die Aufgabenverknüpfung, wenn das Gateway-Aufgaben-Ledger sie meldet, den Ausführungsstatus und das Worker-Log auf der Karte.
--url oder --token werden direkt gemeldet.
Die Textausgabe meldet Worker-Starts:
started und startFailures enthalten; der datenbasierte Fallback enthält
gatewayUnavailable: true. Claim-Tokens werden in der Karten-JSON-Ausgabe redigiert.
Im Dashboard wird dasselbe Dispatch-Ergebnis als kurze Zusammenfassung angezeigt, sodass ein
Operator sehen kann, wie viele Karten gestartet, hochgestuft, blockiert, zurückgefordert oder
fehlgeschlagen sind, ohne Kartendetails zu öffnen.
Parität der Slash-Befehle
Befehlsfähige Kanäle können den entsprechenden Slash-Befehl verwenden:/workboard list und /workboard show sind Lesebefehle für autorisierte Befehlsabsender.
/workboard create und /workboard dispatch verändern den Board-Status und
erfordern Owner-Status auf Chat-Oberflächen oder einen Gateway-Client mit operator.write
oder operator.admin.
Berechtigungen
Der CLI-Dispatch-Pfad ruft Gateway-RPC mit den Scopesoperator.read und
operator.write auf. Ein schreibgeschütztes Gateway-Token kann Workboard-Daten
über Lesemethoden prüfen, aber keine Karten erstellen oder Worker dispatchen.
Lokale Befehle list, create und show arbeiten auf dem lokalen OpenClaw-Statusverzeichnis,
das vom aktuellen Profil verwendet wird. Verwenden Sie --dev oder --profile <name> auf dem
obersten openclaw-Befehl, wenn Sie einen anderen Status-Root benötigen.
Fehlerbehebung
Keine Karten werden angezeigt
Bestätigen Sie, dass das Plugin für dasselbe Profil und denselben Status-Root aktiviert ist:--dev oder --profile verwenden.
Dispatch meldet nur datenbasierten Betrieb
Starten oder starten Sie den Gateway neu:openclaw workboard dispatch. Der datenbasierte Fallback ist für die lokale
Statusbereinigung nützlich, aber Worker-Läufe benötigen einen Live-Gateway.
Dispatch startet nichts
Prüfen Sie, ob mindestens eineready-Karte ohne aktiven Claim vorhanden ist:
done, geben Sie veraltete Claims über die Workboard-Tools frei,
oder führen Sie Dispatch erneut aus, nachdem der aktive Worker fertig ist.