openclaw workboard è l’interfaccia terminale per il plugin Workboard incluso. Consente a un operatore di elencare le schede, creare una scheda, esaminarne una e chiedere al Gateway in esecuzione di assegnare il lavoro pronto alle esecuzioni dei worker subagent.
Abilitare il plugin prima di utilizzare il comando:
Utilizzo
status validi: triage, backlog, todo, scheduled, ready, running, review, blocked, done. Valori priority validi: low, normal, high, urgent.
list
Per impostazione predefinita, l’output testuale compatto nasconde le schede archiviate affinché la CLI corrisponda a
/workboard list. Passare --include-archived per mostrarle. L’output JSON conserva sempre l’elenco completo delle schede, incluse quelle archiviate, per le automazioni esistenti.
create
create scrive direttamente nello stato SQLite di Workboard. La scheda è immediatamente visibile nella scheda Workboard della Control UI e agli strumenti Workboard.
show
move
move modifica lo stato della scheda utilizzando lo stesso percorso manuale dell’operatore impiegato per trascinare una scheda nella dashboard. Accetta l’ID completo di una scheda o un prefisso non ambiguo. I blocchi attivi dovuti alle dipendenze e alla pianificazione continuano ad applicarsi. Gli operatori possono spostare una scheda rivendicata senza il token di rivendicazione del relativo agente; i token di rivendicazione rimangono limitati alle modifiche degli strumenti dell’agente e vengono omessi dall’output JSON.
dispatch
dispatch chiama innanzitutto il metodo RPC workboard.cards.dispatch del Gateway in esecuzione, che utilizza lo stesso runtime dei subagent dell’azione di assegnazione della dashboard, in modo che le schede pronte diventino esecuzioni dei worker monitorate come attività e dotate di chiavi di sessione collegate. --max-starts utilizza il metodo aggiuntivo workboard.cards.dispatchWithOptions, così un Gateway meno recente rifiuta l’opzione prima di avviare qualsiasi worker; dopo l’aggiornamento, riavviare il Gateway prima di utilizzare il flag. Le schede assegnate a un agente utilizzano chiavi di sessione dei subagent limitate all’agente; le schede non assegnate conservano una chiave dei subagent senza ambito, in modo da mantenere l’agente predefinito configurato nel Gateway.
Il ciclo di assegnazione:
- Promuove a
readyle schede figlie le cui dipendenze sono pronte. - Blocca le rivendicazioni scadute o le esecuzioni dei worker che hanno superato il tempo limite.
- Registra i metadati di assegnazione nelle schede pronte.
- Seleziona un piccolo gruppo di schede pronte non rivendicate.
- Rivendica ogni scheda selezionata per il dispatcher o l’agente assegnato.
- Avvia l’esecuzione di un worker subagent con il contesto limitato della scheda e il relativo token di rivendicazione.
- Memorizza nella scheda l’ID dell’esecuzione del worker, la chiave di sessione, il collegamento all’attività quando segnalato dal registro delle attività del Gateway, lo stato di esecuzione e il log del worker.
--max-starts <count> con un numero intero positivo per modificare il limite per passaggio; la regola di una scheda per proprietario continua ad applicarsi, pertanto il numero effettivo di avvii può essere inferiore.
Se l’avvio del worker non riesce dopo che una scheda è stata rivendicata, Workboard blocca la scheda, annulla la rivendicazione e registra l’errore nei metadati di esecuzione e del log del worker della scheda, mantenendo visibili gli avvii non riusciti anziché restituire silenziosamente la scheda alla coda.
Se non viene specificata una destinazione Gateway esplicita e il Gateway locale non è disponibile o non espone ancora il metodo di assegnazione di Workboard, la CLI ripiega su un’assegnazione dei soli dati nello stato locale di Workboard. L’assegnazione dei soli dati può comunque promuovere le dipendenze, eliminare le rivendicazioni obsolete e bloccare le esecuzioni scadute, ma non avvia worker. Gli errori di autenticazione, autorizzazione e convalida, nonché gli errori relativi a una destinazione --url o --token esplicita, vengono segnalati direttamente anziché attivare il ripiego.
L’output testuale segnala gli avvii dei worker:
started e startFailures; il ripiego sui soli dati include gatewayUnavailable: true. I token di rivendicazione vengono omessi dall’output JSON delle schede.
Nella dashboard, lo stesso risultato dell’assegnazione viene mostrato come un breve riepilogo, in modo che un operatore possa vedere quante schede sono state avviate, promosse, bloccate, recuperate o hanno generato errori senza aprirne i dettagli.
Parità dei comandi slash
I canali che supportano i comandi possono utilizzare il comando slash corrispondente:/workboard list e /workboard show sono comandi di lettura per i mittenti autorizzati dei comandi. /workboard create, /workboard move e /workboard dispatch modificano lo stato della board e richiedono lo stato di proprietario sulle interfacce di chat oppure un client Gateway con operator.write o operator.admin.
Autorizzazioni
Il percorso di assegnazione della CLI richiede normalmente gli ambiti Gatewayoperator.write e operator.read. Le schede associate a uno spazio di lavoro vengono eseguite direttamente in uno spazio di lavoro dell’agente configurato con precisione; una richiesta di worktree viene limitata a tale directory anziché consentire all’host di materializzare codice controllato dal repository. Il worker selezionato deve disporre di accesso in scrittura, non condiviso, alla sandbox Docker per quello spazio di lavoro esatto, di un hash del container attivo corrispondente ai mount e ai criteri richiesti e non deve avere alcuna possibilità di uscire dall’host. Passare --admin per richiedere esplicitamente operator.admin, consentire un altro checkout sull’host e utilizzare la normale configurazione del worktree gestito; la connessione non riesce se tale ambito non è approvato per il client. Un token Gateway di sola lettura può esaminare i dati di Workboard tramite i metodi di lettura, ma non può creare schede né assegnare worker. I limiti dello spazio di lavoro non modificano altrimenti lo spostamento manuale delle schede per i chiamanti autorizzati a modificare Workboard.
I comandi locali list, create, show e move operano sulla directory di stato locale di OpenClaw utilizzata dal profilo corrente. Utilizzare --dev o --profile <name> nel comando openclaw di livello superiore quando è necessaria una radice di stato diversa.
Risoluzione dei problemi
Non viene visualizzata alcuna scheda
Verificare che il plugin sia abilitato per lo stesso profilo e la stessa radice di stato:--dev o --profile.
L’assegnazione segnala la modalità dei soli dati
Avviare o riavviare il Gateway:openclaw workboard dispatch. Il ripiego sui soli dati è utile per la pulizia dello stato locale, ma le esecuzioni dei worker richiedono un Gateway attivo.
L’assegnazione non avvia nulla
Verificare che esista almeno una schedaready senza una rivendicazione attiva:
done, rilasciare le rivendicazioni obsolete tramite gli strumenti Workboard oppure eseguire nuovamente l’assegnazione al termine del worker attivo.