openclaw workboard es la interfaz de terminal del plugin Workboard incluido. Permite a un operador enumerar tarjetas, crear una tarjeta, inspeccionar una tarjeta y solicitar al Gateway en ejecución que despache el trabajo listo a ejecuciones de trabajadores subagente.
Habilite el plugin antes de usar el comando:
Uso
status: triage, backlog, todo, scheduled, ready, running, review, blocked, done. Valores válidos de priority: low, normal, high, urgent.
list
La salida de texto compacta oculta las tarjetas archivadas de forma predeterminada para que la CLI coincida con
/workboard list. Pase --include-archived para mostrarlas. La salida JSON siempre conserva la lista completa de tarjetas, incluidas las archivadas, para la automatización existente.
create
create escribe directamente en el estado SQLite de Workboard. La tarjeta aparece de inmediato en la pestaña Workboard de la interfaz de control y para las herramientas de Workboard.
show
passed registra la
autoevaluación del trabajador sobre el comando o la comprobación adjuntos; no es un resultado
de verificación independiente.
move
move cambia el estado de la tarjeta mediante la misma ruta de operador manual que se utiliza al arrastrar una tarjeta en el panel. Acepta el identificador completo de una tarjeta o un prefijo inequívoco. Las retenciones activas por dependencias y programación siguen aplicándose. Los operadores pueden mover una tarjeta reclamada sin el token de reclamación de su agente; los tokens de reclamación siguen limitados a las mutaciones mediante herramientas del agente y se ocultan en la salida JSON.
dispatch
dispatch primero llama al método RPC workboard.cards.dispatch del Gateway en ejecución, que utiliza el mismo entorno de ejecución de subagentes que la acción de despacho del panel, por lo que las tarjetas listas se convierten en ejecuciones de trabajadores con seguimiento de tareas y claves de sesión vinculadas. --max-starts utiliza el método aditivo workboard.cards.dispatchWithOptions para que un Gateway anterior rechace la opción antes de iniciar trabajadores; reinicie el Gateway después de actualizar antes de usar la opción. Las tarjetas con un agente asignado utilizan claves de sesión de subagente limitadas al agente; las tarjetas sin asignar conservan una clave de subagente sin ámbito para mantener el agente predeterminado configurado del Gateway.
El bucle de despacho:
- Promueve a
readylos elementos secundarios cuyas dependencias están listas. - Bloquea las reclamaciones vencidas o las ejecuciones de trabajadores que han agotado el tiempo de espera.
- Registra metadatos de despacho en las tarjetas listas.
- Selecciona un pequeño lote de tarjetas listas sin reclamar.
- Reclama cada tarjeta seleccionada para el despachador o el agente asignado.
- Inicia una ejecución de trabajador subagente con un contexto de tarjeta limitado y el token de reclamación de la tarjeta.
- Almacena en la tarjeta el identificador de la ejecución del trabajador, la clave de sesión, la vinculación de tareas cuando el registro de tareas del Gateway la informa, el estado de ejecución y el registro del trabajador.
--max-starts <count> con un entero positivo para cambiar el límite por pasada; la regla de una tarjeta por propietario sigue aplicándose, por lo que el número efectivo de inicios puede ser menor.
Si el inicio del trabajador falla después de reclamar una tarjeta, Workboard bloquea esa tarjeta, elimina la reclamación y registra el fallo en los metadatos de ejecución y del registro del trabajador de la tarjeta, lo que mantiene visibles los inicios fallidos en lugar de devolver silenciosamente la tarjeta a la cola.
Si no se proporciona un destino explícito del Gateway y el Gateway local no está disponible o todavía no expone el método de despacho de Workboard, la CLI recurre al despacho exclusivo de datos sobre el estado local de Workboard. El despacho exclusivo de datos aún puede promover dependencias, limpiar reclamaciones obsoletas y bloquear ejecuciones que hayan agotado el tiempo de espera, pero no inicia trabajadores. Los fallos de autenticación, permisos y validación, así como los fallos de un destino --url o --token explícito, se notifican directamente en lugar de activar la alternativa.
La salida de texto informa de los inicios de trabajadores:
started y startFailures; la alternativa exclusiva de datos incluye gatewayUnavailable: true. Los tokens de reclamación se ocultan en la salida JSON de las tarjetas.
En el panel, el mismo resultado del despacho se muestra como un resumen breve para que un operador pueda ver cuántas tarjetas se iniciaron, promovieron, bloquearon, volvieron a reclamar o fallaron sin abrir los detalles de las tarjetas.
Equivalencia con el comando de barra diagonal
Los canales con capacidad para ejecutar comandos pueden usar el comando de barra diagonal equivalente:/workboard list y /workboard show son comandos de lectura para remitentes de comandos autorizados. /workboard create, /workboard move y /workboard dispatch modifican el estado del tablero y requieren la condición de propietario en las superficies de chat o un cliente del Gateway con operator.write o operator.admin.
Permisos
La ruta de despacho de la CLI normalmente solicita los ámbitosoperator.write y operator.read del Gateway. Las tarjetas vinculadas a un espacio de trabajo se ejecutan directamente en un espacio de trabajo exacto de un agente configurado; una solicitud de árbol de trabajo se limita a ese directorio en lugar de permitir que el host materialice código controlado por el repositorio. El trabajador seleccionado debe tener acceso de escritura a un entorno aislado de Docker no compartido para ese espacio de trabajo exacto, un hash de contenedor activo que coincida con los montajes y la política solicitados y ninguna capacidad para escapar al host. Pase --admin para solicitar explícitamente operator.admin, permitir otra copia de trabajo del host y utilizar la configuración normal de árboles de trabajo gestionados; la conexión falla si ese ámbito no está aprobado para el cliente. Un token del Gateway de solo lectura puede inspeccionar los datos de Workboard mediante métodos de lectura, pero no puede crear tarjetas ni despachar trabajadores. Los límites del espacio de trabajo no modifican de ningún otro modo el movimiento manual de tarjetas para los invocadores con permiso de modificación de Workboard.
Los comandos locales list, create, show y move operan en el directorio de estado local de OpenClaw utilizado por el perfil actual. Use --dev o --profile <name> en el comando de nivel superior openclaw cuando necesite una raíz de estado diferente.
Solución de problemas
No aparece ninguna tarjeta
Confirme que el plugin esté habilitado para el mismo perfil y la misma raíz de estado:--dev o --profile.
El despacho indica que es exclusivo de datos
Inicie o reinicie el Gateway:openclaw workboard dispatch. La alternativa exclusiva de datos resulta útil para limpiar el estado local, pero las ejecuciones de trabajadores necesitan un Gateway activo.
El despacho no inicia nada
Compruebe que haya al menos una tarjetaready sin una reclamación activa:
done, libere las reclamaciones obsoletas mediante las herramientas de Workboard o vuelva a ejecutar el despacho cuando finalice el trabajador activo.