openclaw workboard é a superfície de terminal do
Plugin Workboard incluído. Ele permite que um operador liste cartões, crie um
cartão, inspecione um cartão e peça ao Gateway em execução para despachar trabalho pronto para
execuções de trabalhadores de subagente.
Habilite o plugin antes de usar o comando:
Uso
list
| Opção | Finalidade |
|---|---|
--board <id> | Limitar resultados a um namespace de quadro |
--status <status> | Limitar resultados a um status do Workboard |
--include-archived | Incluir cartões arquivados na saída de texto compacta |
--json | Imprimir a lista completa de cartões como JSON de máquina |
/workboard list. Passe --include-archived para mostrá-los. A saída JSON
mantém a lista completa de cartões, incluindo cartões arquivados, para automações existentes.
create
| Opção | Finalidade |
|---|---|
--notes <text> | Observações iniciais do cartão |
--status <status> | Status inicial, padrão todo |
--priority <priority> | Prioridade, padrão normal |
--agent <id> | Atribuir o cartão a um agente ou ID de dono |
--board <id> | Armazenar o cartão em um namespace de quadro |
--labels <items> | Rótulos separados por vírgula |
--json | Imprimir o cartão criado como JSON de máquina |
create grava diretamente no estado SQLite do Workboard. O cartão fica imediatamente
visível na aba Workboard da Control UI e para as ferramentas do Workboard.
show
dispatch
dispatch primeiro chama o método RPC do Gateway em execução
workboard.cards.dispatch. Esse caminho usa o mesmo runtime de subagente que a
ação de despacho do painel, então cartões prontos se tornam execuções de trabalhadores rastreadas por tarefa com
chaves de sessão vinculadas. Cartões com um agente atribuído usam chaves de sessão de subagente
com escopo de agente; cartões não atribuídos mantêm uma chave de subagente sem escopo para que o agente padrão
configurado do Gateway seja preservado.
O loop de despacho:
- Promove filhos com dependências prontas para
ready. - Bloqueia reivindicações expiradas ou execuções de trabalhadores com timeout.
- Registra metadados de despacho em cartões prontos.
- Seleciona um pequeno lote de cartões prontos não reivindicados.
- Reivindica cada cartão selecionado para o despachante ou agente atribuído.
- Inicia uma execução de trabalhador de subagente com contexto limitado do cartão e o token de reivindicação do cartão.
- Armazena no cartão o ID da execução do trabalhador, a chave de sessão, o vínculo da tarefa quando o livro-razão de tarefas do Gateway o informa, o status de execução e o log do trabalhador.
--url ou --token são relatadas diretamente.
A saída de texto relata inicializações de trabalhadores:
started e startFailures; o fallback somente de dados inclui
gatewayUnavailable: true. Tokens de reivindicação são redigidos da saída JSON do cartão.
No painel, o mesmo resultado de despacho é mostrado como um resumo curto para que um
operador possa ver quantos cartões foram iniciados, promovidos, bloqueados, recuperados ou
falharam sem abrir os detalhes do cartão.
Paridade de Comandos de Barra
Canais compatíveis com comandos podem usar o comando de barra correspondente:/workboard list e /workboard show são comandos de leitura para remetentes de comando autorizados. /workboard create e /workboard dispatch alteram o estado do quadro e
exigem status de dono em superfícies de chat ou um cliente Gateway com operator.write
ou operator.admin.
Permissões
O caminho de despacho da CLI chama RPC do Gateway com escoposoperator.read e
operator.write. Um token de Gateway somente leitura pode inspecionar dados do Workboard
por métodos de leitura, mas não pode criar cartões nem despachar trabalhadores.
Os comandos locais list, create e show operam no diretório de estado local do OpenClaw
usado pelo perfil atual. Use --dev ou --profile <name> no comando
openclaw de nível superior quando precisar de uma raiz de estado diferente.
Solução de Problemas
Nenhum Cartão Aparece
Confirme se o plugin está habilitado para o mesmo perfil e raiz de estado:--dev ou --profile.
Despacho Diz Somente Dados
Inicie ou reinicie o Gateway:openclaw workboard dispatch. O fallback somente de dados é útil para limpeza de
estado local, mas execuções de trabalhadores precisam de um Gateway ativo.
Despacho Não Inicia Nada
Verifique se há pelo menos um cartãoready sem reivindicação ativa:
done, libere reivindicações obsoletas pelas ferramentas do Workboard
ou execute o despacho novamente depois que o trabalhador ativo terminar.