openclaw workboard è la superficie terminale per il
Plugin Workboard incluso. Consente a un operatore di elencare le schede, creare una
scheda, ispezionare una scheda e chiedere al Gateway in esecuzione di inoltrare il lavoro pronto a
esecuzioni worker dei sottoagenti.
Abilita il Plugin prima di usare il comando:
Uso
list
| Flag | Scopo |
|---|---|
--board <id> | Limita i risultati a un solo spazio dei nomi board |
--status <status> | Limita i risultati a un solo stato Workboard |
--include-archived | Include le schede archiviate nell’output testuale compatto |
--json | Stampa l’elenco completo delle schede come JSON macchina |
/workboard list. Passa --include-archived per mostrarle. L’output JSON
mantiene l’elenco completo delle schede, incluse le schede archiviate, per le automazioni esistenti.
create
| Flag | Scopo |
|---|---|
--notes <text> | Note iniziali della scheda |
--status <status> | Stato iniziale, predefinito todo |
--priority <priority> | Priorità, predefinita normal |
--agent <id> | Assegna la scheda a un agente o id proprietario |
--board <id> | Archivia la scheda in uno spazio dei nomi board |
--labels <items> | Etichette separate da virgole |
--json | Stampa la scheda creata come JSON macchina |
create scrive direttamente nello stato SQLite di Workboard. La scheda è immediatamente
visibile nella scheda Workboard della Control UI e agli strumenti Workboard.
show
dispatch
dispatch chiama prima il metodo RPC del Gateway in esecuzione
workboard.cards.dispatch. Quel percorso usa lo stesso runtime dei sottoagenti dell’azione di invio
della dashboard, quindi le schede pronte diventano esecuzioni worker tracciate come attività con
chiavi di sessione collegate. Le schede con un agente assegnato usano chiavi di sessione sottoagente
con ambito agente; le schede non assegnate mantengono una chiave sottoagente senza ambito, così l’agente
predefinito configurato del Gateway viene preservato.
Il ciclo di invio:
- Promuove i figli con dipendenze pronte a
ready. - Blocca assegnazioni scadute o esecuzioni worker scadute per timeout.
- Registra i metadati di invio sulle schede pronte.
- Seleziona un piccolo lotto di schede pronte non assegnate.
- Assegna ogni scheda selezionata al dispatcher o all’agente assegnato.
- Avvia un’esecuzione worker sottoagente con contesto scheda limitato e il token di assegnazione della scheda.
- Archivia sulla scheda l’id dell’esecuzione worker, la chiave di sessione, il collegamento all’attività quando il registro attività del Gateway lo segnala, lo stato di esecuzione e il log worker.
--url o --token vengono riportati direttamente.
L’output testuale riporta gli avvii dei worker:
started e startFailures; il ripiego solo dati include
gatewayUnavailable: true. I token di assegnazione vengono oscurati dall’output JSON delle schede.
Nella dashboard, lo stesso risultato di invio viene mostrato come breve riepilogo, così un
operatore può vedere quante schede sono state avviate, promosse, bloccate, recuperate o
fallite senza aprire i dettagli delle schede.
Parità dei comandi slash
I canali capaci di comandi possono usare il comando slash corrispondente:/workboard list e /workboard show sono comandi di lettura per mittenti di comandi autorizzati.
/workboard create e /workboard dispatch modificano lo stato della board e
richiedono lo stato di proprietario sulle superfici chat o un client Gateway con operator.write
o operator.admin.
Autorizzazioni
Il percorso di invio della CLI chiama RPC del Gateway con ambitioperator.read e
operator.write. Un token Gateway di sola lettura può ispezionare i dati Workboard
tramite metodi di lettura, ma non può creare schede né inviare worker.
I comandi locali list, create e show operano sulla directory di stato locale OpenClaw
usata dal profilo corrente. Usa --dev o --profile <name> sul
comando openclaw di livello superiore quando ti serve una radice di stato diversa.
Risoluzione dei problemi
Non compare nessuna scheda
Conferma che il Plugin sia abilitato per lo stesso profilo e la stessa radice di stato:--dev o --profile.
Dispatch indica solo dati
Avvia o riavvia il Gateway:openclaw workboard dispatch. Il ripiego solo dati è utile per la pulizia dello
stato locale, ma le esecuzioni worker richiedono un Gateway attivo.
Dispatch non avvia nulla
Verifica che ci sia almeno una schedaready senza un’assegnazione attiva:
done, rilascia le assegnazioni obsolete tramite gli strumenti Workboard
o esegui di nuovo dispatch dopo il completamento del worker attivo.