---
read_when:
    - Creación o reorganización de pestañas y widgets del espacio de trabajo
    - Permitir que un agente componga un espacio de trabajo
    - Revisión del modelo de aprobación y aislamiento de widgets personalizados
summary: Espacios de trabajo componibles por agentes en la interfaz de control
title: Espacios de trabajo
x-i18n:
    generated_at: "2026-07-11T23:38:43Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 234baefc18be736599addeeb35f8404b617c1d8f07f058c4a02ec2615ca21aa0
    source_path: web/workspaces.md
    workflow: 16
---

La pestaña **Espacios de trabajo** de la [interfaz de control](/es/web/control-ui) 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:

```sh
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:

| Enlace   | Se resuelve como                                                                                          |
| -------- | --------------------------------------------------------------------------------------------------------- |
| `static` | Un valor literal almacenado en el documento (máximo de 8 KB).                                             |
| `file`   | Un archivo JSON, Markdown o CSV en `<stateDir>/workspaces/data/`, opcionalmente acotado mediante un puntero JSON. |
| `rpc`    | Uno de los métodos de solo lectura del Gateway incluidos en una lista fija de permitidos, resuelto por la interfaz de control de confianza. |

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 `