Plugin Workboard

El Plugin Workboard agrega un tablero opcional de estilo Kanban a la IU de control. Úsalo para recopilar tarjetas de trabajo del tamaño de un agente, asignarlas a agentes y hacer seguimiento de la tarea en segundo plano, la ejecución y la sesión del panel vinculadas desde una sola tarjeta.

Workboard es intencionalmente pequeño. Hace seguimiento del trabajo operativo local para un Gateway de OpenClaw; no es un reemplazo de GitHub Issues, Linear, Jira ni otros sistemas de gestión de proyectos de equipo.

Estado predeterminado

Workboard es un Plugin incluido y está deshabilitado de forma predeterminada salvo que lo habilites en la configuración de plugins.

Habilítalo con:

openclaw plugins enable workboardopenclaw gateway restart

Luego abre el panel:

openclaw dashboard

La pestaña Workboard aparece en la navegación del panel. Si la pestaña está visible pero el Plugin está deshabilitado o bloqueado por plugins.allow / plugins.deny, la vista muestra un estado de Plugin no disponible en lugar de datos de tarjetas locales.

Qué contienen las tarjetas

Cada tarjeta almacena:

• título y notas
• estado: triage, backlog, todo, scheduled, ready, running, review, blocked o done
• prioridad: low, normal, high o urgent
• etiquetas
• id de agente opcional
• tarea, ejecución, sesión o URL de origen vinculada opcional
• metadatos de ejecución opcionales para una ejecución de Codex o Claude iniciada desde la tarjeta
• metadatos compactos para intentos, comentarios, enlaces, pruebas, artefactos, automatización, adjuntos, registros de trabajador, estado de protocolo de trabajador, reclamaciones, diagnósticos, notificaciones, plantillas, estado de archivo y detección de sesiones obsoletas
• eventos recientes de tarjeta, como cambios creados, movidos, vinculados, reclamados, Heartbeat, intento, prueba, artefacto, diagnóstico, notificación, despacho, archivo, obsoleto o actualizados por agente

Las tarjetas se almacenan en el estado de Gateway del Plugin. Son locales al directorio de estado del Gateway y se mueven con el resto del estado de OpenClaw de ese Gateway.

Workboard conserva metadatos compactos por tarjeta para que los operadores puedan ver cómo una tarjeta se movió por el tablero sin abrir la sesión vinculada. Eventos, resúmenes de intentos, fragmentos de prueba, enlaces relacionados, comentarios, marcadores de archivo y marcadores de sesiones obsoletas son metadatos locales intencionalmente; no reemplazan las transcripciones de sesión ni el historial de incidencias de GitHub.

Ejecuciones y tareas de tarjetas

Las tarjetas no vinculadas pueden iniciar trabajo desde la tarjeta. Los inicios autónomos usan la ruta de ejecución de agente con seguimiento de tareas del Gateway; luego Workboard vincula la tarea resultante, el id de ejecución y la clave de sesión de vuelta a la tarjeta. El inicio usa el agente y el modelo predeterminados configurados del Gateway. Las acciones de Codex y Claude son opciones explícitas opcionales de modelo:

• Ejecutar Codex o Ejecutar Claude inicia una ejecución de agente respaldada por tarea, envía el prompt de la tarjeta y marca la tarjeta como running.
• Abrir Codex o Abrir Claude crea una sesión de panel vinculada sin enviar el prompt de la tarjeta ni mover la tarjeta, para que puedas trabajar manualmente mientras permanece adjunta al tablero.

Los metadatos de ejecución almacenan el motor, el modo, la referencia de modelo, la clave de sesión, el id de ejecución, el id de tarea cuando está disponible y el estado del ciclo de vida seleccionados en la tarjeta. Las ejecuciones de Codex usan openai/gpt-5.5; las ejecuciones de Claude usan anthropic/claude-sonnet-4-6.

Cada ejecución vinculada también registra un resumen de intento en el mismo registro de tarjeta. El resumen de intento conserva el motor, el modo, el modelo, el id de ejecución, las marcas de tiempo, el estado y el recuento acumulado de fallos para que los fallos repetidos sigan visibles en el tablero.

El panel actualiza el estado de las tareas desde el libro mayor de tareas del Gateway y empareja las tareas con las tarjetas por id de tarea, id de ejecución o clave de sesión vinculada. Si una tarea está en cola o en ejecución, el ciclo de vida de la tarjeta muestra el estado activo de la tarea. Si la tarea termina, falla, agota el tiempo de espera o se cancela, el ciclo de vida de la tarjeta avanza hacia el estado de revisión o bloqueado usando la misma sincronización de ciclo de vida que las sesiones vinculadas.

Coordinación de agentes

Workboard también expone herramientas de agente opcionales para flujos de trabajo conscientes del tablero:

• workboard_list enumera tarjetas compactas con estado de reclamación y diagnóstico, con un filtro de tablero opcional.
• workboard_read devuelve una tarjeta más contexto de trabajador limitado creado a partir de notas, intentos, comentarios, enlaces, pruebas, artefactos, resultados principales, trabajo reciente del asignado y diagnósticos activos.
• workboard_create crea una tarjeta con padres opcionales, tenant, skills, tablero, metadatos de espacio de trabajo, clave de idempotencia, límite de tiempo de ejecución y presupuesto de reintentos.
• workboard_link vincula una tarjeta principal a una tarjeta secundaria. Las secundarias permanecen en todo hasta que todos los padres alcanzan done; entonces la promoción de despacho las mueve a ready.
• workboard_claim reclama una tarjeta para el agente llamante y mueve tarjetas de backlog, todo o ready a running.
• workboard_heartbeat actualiza el Heartbeat de la reclamación durante ejecuciones más largas.
• workboard_release libera la reclamación tras completarse, pausarse o transferirse, y puede mover la tarjeta a un estado siguiente.
• workboard_complete y workboard_block son herramientas estructuradas de ciclo de vida para resúmenes finales, pruebas, artefactos, manifiestos de tarjetas creadas y motivos de bloqueo. Los manifiestos de tarjetas creadas deben referenciar tarjetas vinculadas de vuelta a la tarjeta completada, lo que mantiene a las tarjetas secundarias fantasma fuera de los resúmenes.
• workboard_attachment_add, workboard_attachment_read y workboard_attachment_delete almacenan pequeños adjuntos de tarjeta en el estado SQLite del Plugin, los indexan en la tarjeta y los exponen en el contexto del trabajador.
• workboard_worker_log y workboard_protocol_violation registran líneas de registro de trabajador y bloquean tarjetas cuando un trabajador automatizado se detiene sin llamar a workboard_complete o workboard_block.
• workboard_board_create, workboard_board_archive y workboard_board_delete gestionan metadatos de tablero persistidos, como nombre para mostrar, descripción, estado de archivo y espacio de trabajo predeterminado.
• workboard_runs devuelve el historial persistido de intentos de ejecución almacenado en una tarjeta.
• workboard_specify convierte una tarjeta aproximada de triage o backlog en una tarjeta todo aclarada y registra el resumen de especificación en la tarjeta.
• workboard_decompose despliega una tarjeta principal de orquestación en secundarias vinculadas, hereda metadatos de tablero y tenant, y puede completar la principal con un manifiesto de tarjetas creadas.
• workboard_notify_subscribe, workboard_notify_list, workboard_notify_events, workboard_notify_advance y workboard_notify_unsubscribe gestionan suscripciones de notificación en el estado del Plugin. Las lecturas de eventos son seguras para reproducción; la herramienta de avance mueve el cursor durable para que los llamantes puedan reanudar sin perder ni leer dos veces eventos de tarjetas completadas, fallidas u obsoletas.
• workboard_boards, workboard_stats, workboard_promote, workboard_reassign, workboard_reclaim, workboard_comment, workboard_proof, workboard_unblock y workboard_dispatch permiten que un agente inspeccione espacios de nombres de tableros, vea estadísticas de colas, recupere trabajo atascado, agregue notas de transferencia, adjunte referencias de prueba o artefacto, mueva trabajo bloqueado de vuelta a todo y empuje la promoción de dependencias o la limpieza de reclamaciones obsoletas.

Las tarjetas reclamadas rechazan mutaciones de herramientas de agente de otros agentes salvo que el llamante tenga el token de reclamación devuelto por workboard_claim. Los operadores del panel siguen usando la superficie RPC normal del Gateway y pueden recuperar o reasignar tarjetas.

Workboard almacena datos duraderos de tablero en una base de datos relacional SQLite propiedad del Plugin bajo el directorio de estado de OpenClaw. Tableros, tarjetas, etiquetas, eventos de ciclo de vida, intentos de ejecución, comentarios, enlaces de dependencia, pruebas, referencias de artefactos, metadatos y blobs de adjuntos, diagnósticos, notificaciones, registros de trabajador, estado de protocolo y suscripciones persisten en tablas de Workboard en lugar de entradas clave-valor del Plugin. Una exportación de tarjeta sigue preservando la narrativa del tablero sin incrustar el contenido de blobs de adjuntos.

Las instalaciones que usaron Workboard en la versión .28 pueden ejecutar openclaw doctor --fix para migrar los espacios de nombres de estado de Plugin heredados enviados (workboard.cards, workboard.boards y workboard.notify) a la base de datos relacional. Si hay un espacio de nombres heredado workboard.attachments, presente, doctor también migra esos blobs de adjuntos.

Los diagnósticos de Workboard se calculan a partir de metadatos de tarjetas locales. Las comprobaciones integradas marcan tarjetas asignadas que esperan demasiado, tarjetas en ejecución sin Heartbeat reciente, tarjetas bloqueadas que necesitan atención, fallos repetidos, tarjetas terminadas sin prueba y tarjetas en ejecución que solo tienen un enlace de sesión laxo.

El despacho es intencionalmente local al Gateway. No genera procesos arbitrarios del sistema operativo; las sesiones normales de subagente de OpenClaw siguen siendo dueñas de la ejecución. La acción de despacho promueve tarjetas listas por dependencias, registra metadatos de despacho en tarjetas listas, bloquea reclamaciones expiradas o ejecuciones con tiempo agotado, marca tarjetas de triage configuradas por el tablero como candidatas de orquestación, luego reclama un pequeño lote de tarjetas listas e inicia ejecuciones de trabajadores a través del runtime de subagentes del Gateway. Las tarjetas asignadas usan claves de sesión de trabajador agent:<id>:subagent:workboard-*; las tarjetas no asignadas usan claves sin ámbito subagent:workboard-* para que el Gateway siga resolviendo el agente predeterminado configurado. Los trabajadores reciben contexto de tarjeta limitado más el token de reclamación que necesitan para enviar Heartbeat, completar o bloquear la tarjeta a través de las herramientas de Workboard.

Selección de trabajadores de despacho

Cada pasada de despacho inicia como máximo tres trabajadores de forma predeterminada. Las tarjetas listas se ordenan por prioridad, posición y hora de creación, y luego se filtran para evitar propiedad activa duplicada. Un despacho inicia solo una tarjeta para un propietario o agente determinado en la misma pasada, y omite propietarios que ya tienen trabajo en ejecución o en revisión en el tablero.

Las tarjetas archivadas, las tarjetas con reclamaciones activas y las tarjetas sin estado ready no se seleccionan para inicios de trabajadores. Aun así, pueden verse afectadas por el lado de datos del despacho cuando se aplican reclamaciones obsoletas, promoción de dependencias o limpieza de tiempos de espera.

Prompt y ciclo de vida del trabajador

El prompt del trabajador incluye el título de la tarjeta, notas y contexto limitados, el tablero asignado y el protocolo de trabajador de Workboard. También incluye el propietario de la reclamación y el token de reclamación para que el trabajador pueda llamar a workboard_heartbeat, workboard_complete o workboard_block sin que otro actor tome el control de la tarjeta.

Cuando un trabajador se inicia correctamente, Workboard almacena la clave de sesión, el id de ejecución, el motor, el modo, la etiqueta de modelo, el estado y el registro de trabajador en la tarjeta. La clave de sesión es determinista para el tablero y la tarjeta, lo que hace que los despachos repetidos se enruten de vuelta al mismo carril de trabajador en lugar de crear sesiones no relacionadas.

Si un trabajador no puede iniciarse después de reclamar una tarjeta, Workboard bloquea la tarjeta, borra la reclamación, registra el fallo de inicio de ejecución y agrega una línea de registro de trabajador. Ese fallo es visible en el panel, JSON de CLI, herramientas de agente y diagnósticos de tarjeta.

Puntos de entrada de despacho

Los inicios de trabajadores de tarjetas listas pueden ocurrir desde:

• la acción de despacho del panel
• openclaw workboard dispatch
• /workboard dispatch en un canal compatible con comandos

Los tres puntos de entrada usan el runtime de subagentes del Gateway cuando el Gateway está disponible. La CLI tiene un respaldo adicional para operadores: si el Gateway está sin conexión o no expone el método de despacho de Workboard y no se proporcionó ningún destino explícito --url o --token, ejecuta despacho solo de datos contra el estado SQLite local. Ese respaldo puede promover dependencias, limpiar reclamaciones obsoletas y bloquear ejecuciones con tiempo agotado, pero no puede iniciar trabajadores.

Los metadatos del tablero pueden incluir ajustes de orquestación como autoDecompose, autoDecomposePerDispatch, defaultAssignee y orchestratorProfile. OpenClaw registra la intención de orquestación y la expone en el contexto de trabajador; la especificación y descomposición reales siguen ocurriendo a través de las herramientas normales de Workboard.

CLI y comando slash

El Plugin registra un comando CLI raíz:

openclaw workboard listopenclaw workboard create "Fix stale card lifecycle" --priority high --labels bug,workboardopenclaw workboard show <card-id>openclaw workboard dispatch

openclaw workboard dispatch llama al Gateway en ejecución para que los inicios de workers usen el mismo runtime de subagente que el panel. Si el Gateway no está disponible, recurre a un dispatch solo de datos para que la promoción de dependencias, la limpieza de claims obsoletos y el bloqueo por timeout puedan seguir ejecutándose. Los fallos de autenticación, permisos y validación siguen apareciendo como errores de comando, al igual que los fallos para destinos explícitos --url o --token.

El comando slash /workboard admite la misma ruta compacta de operador: /workboard list, /workboard show <card-id>, /workboard create <title> y /workboard dispatch. List y show son operaciones de lectura para remitentes de comandos autorizados. Create y dispatch requieren estado de propietario en superficies de chat o un cliente de Gateway con operator.write u operator.admin.

Consulta CLI de Workboard para las flags de comando, salida JSON, comportamiento de fallback del Gateway, manejo inequívoco de prefijos de id, reglas de selección de dispatch y solución de problemas.

Sincronización del ciclo de vida de la sesión

Las tarjetas pueden vincularse a sesiones existentes del panel o a la sesión creada cuando inicias trabajo desde una tarjeta. Las tarjetas vinculadas muestran el ciclo de vida de la sesión en línea: en ejecución, obsoleta, vinculada inactiva, finalizada, fallida o ausente.

Si falta la sesión vinculada, la tarjeta permanece vinculada para contexto y sigue ofreciendo controles de inicio para que puedas reiniciar el trabajo en una sesión nueva del panel. Si una sesión vinculada activa deja de informar actividad reciente, Workboard marca la tarjeta como obsoleta y almacena el marcador como metadatos de la tarjeta hasta que el ciclo de vida lo borre.

También puedes capturar una sesión existente del panel desde la pestaña Sessions con Add to Workboard. La tarjeta se vincula a esa sesión, usa la etiqueta de sesión o el prompt reciente del usuario como título, y rellena notas a partir del prompt reciente del usuario más la última respuesta del asistente cuando el historial de chat está disponible.

Workboard sigue la sesión vinculada mientras la tarjeta aún está en un estado de trabajo activo:

• sesión vinculada activa -> running
• sesión vinculada completada -> review
• sesión vinculada fallida, detenida, agotada por timeout o abortada -> blocked

Los estados de revisión manual prevalecen. Si mueves una tarjeta a review, blocked o done, Workboard deja de mover automáticamente esa tarjeta hasta que la devuelvas a todo o running.

Flujo de trabajo del panel

1. Abre la pestaña Workboard en la Control UI.
2. Crea una tarjeta con título, notas, prioridad, etiquetas, agente opcional y sesión vinculada opcional.
3. O abre Sessions y elige Add to Workboard para una sesión existente.
4. Arrastra la tarjeta entre columnas o enfoca el control de estado compacto en la tarjeta y usa su menú o ArrowLeft/ArrowRight.
5. Inicia trabajo desde la tarjeta para crear o reutilizar una sesión del panel.
6. Abre la sesión vinculada desde la tarjeta mientras el agente trabaja.
7. Deja que la sincronización del ciclo de vida mueva el trabajo en ejecución a revisión o bloqueado, luego mueve manualmente la tarjeta a finalizado cuando se acepte.

Iniciar una tarjeta usa sesiones normales de Gateway. El Plugin Workboard solo almacena metadatos y vínculos de tarjetas; la transcripción de la conversación, la selección de modelo y el ciclo de vida de la ejecución siguen perteneciendo al sistema de sesiones normal.

Usa Stop en una tarjeta vinculada en vivo para abortar la ejecución de la sesión activa. Workboard marca esa tarjeta como blocked para que siga visible para el seguimiento.

Las tarjetas nuevas pueden comenzar desde plantillas de Workboard para correcciones de errores, documentación, releases, revisiones de PR o trabajo de plugin. Las plantillas prerrellenan título, notas, etiquetas y prioridad, y el id de la plantilla seleccionada se almacena como metadatos de la tarjeta.

Permisos

El plugin registra métodos RPC de Gateway bajo el namespace workboard.*:

• workboard.cards.list requiere operator.read
• workboard.cards.export requiere operator.read
• workboard.cards.diagnostics requiere operator.read
• workboard.cards.diagnostics.refresh requiere operator.write
• las lecturas de lista/obtención de adjuntos y de eventos de notificación requieren operator.read
• el avance del cursor de notificaciones requiere operator.write
• los métodos para crear, actualizar, mover, eliminar, comentar, vincular, enlace de dependencia, prueba, artefacto, añadir/eliminar adjunto, log de worker, infracción de protocolo, claim, heartbeat, release, completar, bloquear, desbloquear, dispatch, operaciones masivas y archivar requieren operator.write

Los navegadores conectados con acceso de operador de solo lectura pueden inspeccionar el tablero, pero no pueden mutar tarjetas.

Configuración

Workboard no tiene configuración específica de plugin actualmente. Actívalo o desactívalo con la entrada de plugin estándar:

{  plugins: {    entries: {      workboard: {        enabled: true,        config: {},      },    },  },}

Vuelve a desactivarlo con:

openclaw plugins disable workboardopenclaw gateway restart

Solución de problemas

La pestaña indica que Workboard no está disponible

Comprueba la política de plugins:

openclaw plugins inspect workboard --runtime --json

Si plugins.allow está configurado, añade workboard a esa lista de permitidos. Si plugins.deny contiene workboard, elimínalo antes de activar el plugin.

Las tarjetas no se guardan

Confirma que la conexión del navegador tenga acceso operator.write. Las sesiones de operador de solo lectura pueden listar tarjetas, pero no pueden crearlas, editarlas, moverlas ni eliminarlas.

Iniciar una tarjeta no abre la sesión esperada

Workboard crea enlaces a sesiones normales del panel. Comprueba el id de agente de la tarjeta y la sesión vinculada; luego abre la vista Sesiones o Chat para inspeccionar el estado real de la ejecución.

El despacho no inicia un trabajador

Confirma que haya al menos una tarjeta ready sin una reclamación activa:

openclaw workboard list --status ready

Si la CLI informa despacho solo de datos, inicia o reinicia el Gateway y vuelve a intentarlo. El despacho solo de datos actualiza el estado del tablero local, pero no puede iniciar ejecuciones de trabajadores subagentes.

Las tarjetas también pueden omitirse cuando otra tarjeta del mismo propietario o agente ya está en ejecución o esperando revisión. Completa, bloquea o libera ese trabajo activo antes de despachar más trabajo para el mismo propietario.

Relacionado

• Control UI
• CLI de Workboard
• Plugins
• Gestionar plugins
• Sesiones