--- read_when: - Criar ou reorganizar abas e widgets do espaço de trabalho - Permitindo que um agente componha um espaço de trabalho - Revisando o modelo de aprovação e sandbox de widgets personalizados summary: Espaços de trabalho componíveis por agentes na interface de controle title: Espaços de trabalho x-i18n: generated_at: "2026-07-12T00:29:37Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: 234baefc18be736599addeeb35f8404b617c1d8f07f058c4a02ec2615ca21aa0 source_path: web/workspaces.md workflow: 16 --- A aba **Espaços de trabalho** na [interface de controle](/pt-BR/web/control-ui) é uma área que você e seus agentes organizam em conjunto. Abas, widgets, suas posições em uma grade de 12 colunas e suas vinculações de dados ficam todos em um único documento. Qualquer recurso capaz de editar esse documento pode compor o espaço de trabalho: você, a CLI `openclaw workspaces` ou um agente que chame as ferramentas `workspace_*`. Toda gravação passa pelo mesmo caminho validado, portanto o layout de uma pessoa e o layout de um agente não podem divergir. Cada gravação aceita incrementa uma versão e transmite `plugin.workspaces.changed`, fazendo com que a edição de um agente apareça em um navegador já aberto sem recarregar a página. ## Ativar os espaços de trabalho O Plugin Espaços de trabalho incluído vem desativado por padrão. Na interface de controle, abra **Plugins**, localize **Workspaces** e selecione **Enable**. Você também pode ativá-lo pela CLI: ```sh openclaw plugins enable workspaces ``` Ativar o Plugin adiciona a aba **Espaços de trabalho** e disponibiliza a CLI `openclaw workspaces` e as ferramentas de agente `workspace_*`. Desativá-lo remove essas interfaces sem excluir o banco de dados dos espaços de trabalho nem os recursos dos widgets. ## O espaço de trabalho padrão No primeiro carregamento, você recebe um espaço de trabalho **Visão geral**: cartões de custo e tokens, integridade das instâncias, sessões, status do cron e um feed de atividades. Trata-se de conteúdo comum do espaço de trabalho — arraste-o, recolha-o, oculte-o ou exclua-o. ## Widgets integrados Nove widgets confiáveis são fornecidos com o Plugin e renderizados como interface própria do produto: `stat-card`, `markdown`, `table`, `iframe-embed`, `sessions`, `usage`, `cron`, `instances`, `activity`. Os widgets declaram dados por meio de **vinculações**; eles nunca os buscam por conta própria: | Vinculação | Resolve para | | ---------- | ---------------------------------------------------------------------------------------------------------------------- | | `static` | Um valor literal armazenado no documento (máximo de 8 KB). | | `file` | Um arquivo JSON, Markdown ou CSV em `/workspaces/data/`, opcionalmente delimitado por um ponteiro JSON. | | `rpc` | Um dos métodos somente leitura do Gateway em uma lista fixa de permissões, resolvido pela interface de controle confiável. | A vinculação `file` é a forma mais simples de inserir seus próprios números em um espaço de trabalho: grave um arquivo JSON no diretório de dados e aponte um `stat-card` para ele. ## Proveniência Abas e widgets carregam uma marca `createdBy` — `user`, `system` ou `agent:` — definida com base em quem realizou a gravação. Ela não pode ser fornecida pelo chamador, portanto um agente não pode atribuir a você o próprio trabalho, e o indicador "IA" em um widget criado por um agente sempre significa exatamente isso. ## Widgets personalizados Um agente pode criar um widget HTML real com `workspace_widget_scaffold` (ou você pode fazer isso com `openclaw workspaces widget-scaffold `). O código criado por agentes é tratado como hostil: - Um widget recém-criado entra no registro como **pendente**. Nenhum iframe é criado, e a rota de recursos retorna 404 para seus arquivos até que um operador o aprove. - A aprovação é uma decisão separada da edição de um layout: `workspaces.widget.approve` exige o escopo `operator.approvals`, o mesmo escopo que protege as aprovações de execução. - Um widget aprovado é renderizado em um `