openclaw workboard est l’interface de terminal du
Plugin Workboard inclus. Elle permet à un opérateur de lister les cartes, de créer une
carte, d’inspecter une carte et de demander au Gateway en cours d’exécution de distribuer le travail prêt vers
des exécutions de workers sous-agents.
Activez le Plugin avant d’utiliser la commande :
Utilisation
list
| Indicateur | Objectif |
|---|---|
--board <id> | Limiter les résultats à un espace de noms de tableau |
--status <status> | Limiter les résultats à un statut Workboard |
--include-archived | Inclure les cartes archivées dans la sortie texte compacte |
--json | Afficher la liste complète des cartes en JSON exploitable par machine |
/workboard list. Passez --include-archived pour les afficher. La sortie JSON
conserve la liste complète des cartes, y compris les cartes archivées, pour les automatisations existantes.
create
| Indicateur | Objectif |
|---|---|
--notes <text> | Notes initiales de la carte |
--status <status> | Statut initial, par défaut todo |
--priority <priority> | Priorité, par défaut normal |
--agent <id> | Assigner la carte à un agent ou à un identifiant de propriétaire |
--board <id> | Stocker la carte dans un espace de noms de tableau |
--labels <items> | Libellés séparés par des virgules |
--json | Afficher la carte créée en JSON exploitable par machine |
create écrit directement dans l’état SQLite de Workboard. La carte est immédiatement
visible dans l’onglet Workboard de l’interface de contrôle et pour les outils Workboard.
show
dispatch
dispatch appelle d’abord la méthode RPC du Gateway en cours d’exécution
workboard.cards.dispatch. Ce chemin utilise le même runtime de sous-agent que l’action de
distribution du tableau de bord, de sorte que les cartes prêtes deviennent des exécutions de workers suivies comme tâches avec
des clés de session liées. Les cartes avec un agent assigné utilisent des clés de session de sous-agent
portées par l’agent ; les cartes non assignées conservent une clé de sous-agent sans portée afin que l’agent par défaut
configuré du Gateway soit préservé.
La boucle de distribution :
- Passe les enfants dont les dépendances sont prêtes à
ready. - Bloque les revendications expirées ou les exécutions de workers arrivées à expiration.
- Enregistre les métadonnées de distribution sur les cartes prêtes.
- Sélectionne un petit lot de cartes prêtes non revendiquées.
- Revendique chaque carte sélectionnée pour le répartiteur ou l’agent assigné.
- Démarre une exécution de worker sous-agent avec un contexte de carte borné et le jeton de revendication de la carte.
- Stocke l’identifiant d’exécution du worker, la clé de session, le lien de tâche lorsque le registre des tâches du Gateway le signale, le statut d’exécution et le journal du worker sur la carte.
--url ou --token sont signalés directement.
La sortie texte indique les démarrages de workers :
started et startFailures ; la bascule uniquement basée sur les données inclut
gatewayUnavailable: true. Les jetons de revendication sont expurgés de la sortie JSON des cartes.
Dans le tableau de bord, le même résultat de distribution est affiché sous forme de bref résumé afin qu’un
opérateur puisse voir combien de cartes ont démarré, été promues, bloquées, récupérées ou
échoué sans ouvrir les détails des cartes.
Parité des commandes slash
Les canaux compatibles avec les commandes peuvent utiliser la commande slash correspondante :/workboard list et /workboard show sont des commandes de lecture pour les expéditeurs de commandes autorisés.
/workboard create et /workboard dispatch modifient l’état du tableau et
exigent le statut de propriétaire sur les surfaces de discussion ou un client Gateway avec operator.write
ou operator.admin.
Autorisations
Le chemin de distribution de la CLI appelle la RPC du Gateway avec les portéesoperator.read et
operator.write. Un jeton Gateway en lecture seule peut inspecter les données Workboard
via des méthodes de lecture, mais il ne peut pas créer de cartes ni distribuer de workers.
Les commandes locales list, create et show opèrent sur le répertoire d’état OpenClaw local
utilisé par le profil courant. Utilisez --dev ou --profile <name> sur la
commande openclaw de premier niveau lorsque vous avez besoin d’une autre racine d’état.
Dépannage
Aucune carte n’apparaît
Confirmez que le Plugin est activé pour le même profil et la même racine d’état :--dev ou --profile.
La distribution indique uniquement des données
Démarrez ou redémarrez le Gateway :openclaw workboard dispatch. La bascule uniquement basée sur les données est utile pour le nettoyage de l’état
local, mais les exécutions de workers nécessitent un Gateway actif.
La distribution ne démarre rien
Vérifiez qu’il existe au moins une carteready sans revendication active :
done, libérez les revendications obsolètes via les outils Workboard,
ou relancez la distribution après la fin du worker actif.