Espacios de trabajo

La pestaña Espacios de trabajo de la interfaz de control es una superficie que tú y tus agentes organizan conjuntamente. Las pestañas, los widgets, sus posiciones en una cuadrícula de 12 columnas y sus enlaces de datos se almacenan en un único documento. Cualquier elemento que pueda editar ese documento puede componer el espacio de trabajo: tú, la CLI openclaw workspaces o un agente que invoque las herramientas workspace_*.

Cada escritura pasa por la misma ruta validada, por lo que el diseño de una persona y el de un agente no pueden divergir. Cada escritura aceptada incrementa una versión y difunde plugin.workspaces.changed, por lo que la edición de un agente aparece en un navegador ya abierto sin necesidad de recargar.

Habilitar los espacios de trabajo

El Plugin de espacios de trabajo incluido está deshabilitado de forma predeterminada. En la interfaz de control, abre Plugins, busca Workspaces y selecciona Enable. También puedes habilitarlo desde la CLI:

openclaw plugins enable workspaces

Al habilitar el Plugin, se añade la pestaña Espacios de trabajo y quedan disponibles la CLI openclaw workspaces y las herramientas de agente workspace_*. Al deshabilitarlo, se eliminan esas superficies sin borrar la base de datos de espacios de trabajo ni los recursos de los widgets.

El espacio de trabajo predeterminado

En la primera carga, obtienes un espacio de trabajo Resumen: tarjetas de costes y tokens, estado de la instancia, sesiones, estado de Cron y un canal de actividad. Es contenido normal del espacio de trabajo: arrástralo, contráelo, ocúltalo o elimínalo.

Widgets integrados

El Plugin incluye nueve widgets de confianza que se representan como interfaz propia:

stat-card, markdown, table, iframe-embed, sessions, usage, cron, instances, activity.

Los widgets declaran los datos mediante enlaces; nunca los obtienen por su cuenta:

El enlace file es la forma más sencilla de incluir tus propios números en un espacio de trabajo: escribe un archivo JSON en el directorio de datos y haz que un stat-card apunte a él.

Procedencia

Las pestañas y los widgets incluyen una marca createdBy —user, system o agent:<id>— determinada por quien haya realizado la escritura. El autor de la llamada no puede proporcionarla, por lo que un agente no puede etiquetar su trabajo como si fuera tuyo, y el distintivo «IA» de un widget creado por un agente siempre significa exactamente eso.

Widgets personalizados

Un agente puede crear un widget HTML real con workspace_widget_scaffold (o puedes hacerlo tú con openclaw workspaces widget-scaffold <name>). El código creado por agentes se considera hostil:

• Un widget generado se incorpora al registro como pendiente. No se crea ningún iframe y la ruta de recursos devuelve 404 para sus archivos hasta que un operador lo aprueba.
• La aprobación es una decisión independiente de la edición de un diseño: workspaces.widget.approve requiere el ámbito operator.approvals, el mismo que protege las aprobaciones de ejecución.
• Un widget aprobado se representa en un <iframe sandbox="allow-scripts">, nunca con allow-same-origin, por lo que su origen es opaco y no puede acceder al DOM, almacenamiento ni cookies del elemento principal.
• Sus recursos se sirven con connect-src 'none', lo que bloquea las conexiones de red de los scripts, como fetch, XHR y WebSockets. No contiene credenciales ni se comunica nunca con el Gateway.
• Los datos solo le llegan mediante un puente postMessage con control de versiones. El código personalizado puede recibir los enlaces static declarados, cuyos valores del espacio de trabajo ya han sido creados por un agente o un operador. Los enlaces RPC y de archivo permanecen en widgets integrados de confianza: los navegadores permiten que un elemento secundario aislado navegue por su propio marco, por lo que nunca se publican datos privilegiados en HTML creado por agentes.

Enviar una instrucción al chat desde un widget requiere además una capacidad en el manifiesto, una confirmación por invocación que cite el texto exacto y está sujeto a un límite de frecuencia.

CLI

openclaw workspaces tabs listopenclaw workspaces tabs create --title Financialsopenclaw workspaces widget-scaffold revenue-chart --title "Revenue Chart"openclaw workspaces widget-approve revenue-chart

widget-approve necesita un dispositivo emparejado con el ámbito operator.approvals; la aprobación desde la interfaz de control no lo necesita, porque el navegador ya dispone de él.

Almacenamiento

El documento del espacio de trabajo, el registro de widgets personalizados y un historial de deshacer de 20 entradas se almacenan en <stateDir>/workspaces/workspaces.sqlite. Los recursos de widgets creados por agentes permanecen en el disco en <stateDir>/workspaces/widgets/<name>/, y los datos de enlaces de archivo en <stateDir>/workspaces/data/, porque un agente los crea con herramientas de archivos convencionales y la ruta del widget sirve sus bytes.