> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Uso do computador

O uso do computador permite que o agente do Gateway veja e controle um desktop **macOS** emparelhado: ele captura uma imagem da tela com o comando de nó existente `screen.snapshot` e controla o ponteiro e o teclado por meio de um único comando perigoso de nó, `computer.act`. O conjunto de ações segue as ações principais de uso do computador da Anthropic; o zoom opcional de `computer_20251124` não é exposto. Um modelo com capacidade de visão o controla por meio da ferramenta de agente integrada `computer`.

O agente emite um único comando uniforme, `computer.act`; ele não consegue saber como um nó o executa. Um nó macOS executa `computer.act` no próprio processo com serviços Peekaboo incorporados e primitivas restritas do CoreGraphics (permissões TCC corretas, sem processo adicional). Outras plataformas poderão executar o mesmo comando futuramente sem alterar o contrato exposto ao agente.

## Requisitos

* Um nó **macOS** emparelhado (o aplicativo OpenClaw para macOS em execução no modo de nó).
* A configuração **Permitir controle do computador** do aplicativo macOS ativada (padrão: desativada).
* Permissão **Accessibility** do macOS concedida ao OpenClaw (para injeção de eventos de ponteiro/teclado) e permissão **Screen Recording** (para `screen.snapshot`).
* O comando `computer.act` armado no Gateway (ele é perigoso e permanece desarmado por padrão).
* Um modelo de agente com capacidade de visão.
* Uma política de ferramentas que exponha `computer`. O perfil padrão `coding` não o expõe. Adicione `computer` a `tools.alsoAllow`; agentes em sandbox também precisam dele em `tools.sandbox.tools.alsoAllow`.

## A ferramenta de agente `computer`

A ferramenta integrada `computer` aceita uma ação por chamada. As coordenadas são pixels inteiros não negativos na captura de tela mais recente; o nó as converte em pontos da tela. As ações com coordenadas devem repetir o `frameId` do resultado da captura de tela, e um `screenIndex` explícito deve corresponder a esse quadro. O OpenClaw também transporta da captura de tela para a ação uma identidade de monitor emitida pelo nó; assim, uma reconexão do monitor ou alteração de geometria falha de forma segura, em vez de redirecionar silenciosamente para o mesmo índice. Essas verificações rejeitam tokens presumidos e tokens de outro quadro ou monitor entregue. Um token não garante atualidade: os aplicativos podem alterar os pixels no mesmo monitor após a captura, portanto faça uma nova captura de tela sempre que a cena puder ter mudado.

* Leitura: `screenshot`.
* Ponteiro: `left_click`, `right_click`, `middle_click`, `double_click`, `triple_click`, `mouse_move`, `left_click_drag` (com `startCoordinate`), `left_mouse_down`, `left_mouse_up`.
* Rolagem: `scroll` com `scrollDirection` (`up|down|left|right`) e `scrollAmount` (incrementos da roda).
* Teclado: `type` (texto), `key` (combinação como `cmd+shift+t` ou `Return`), `hold_key` (combinação em `text` mantida pressionada por `duration` segundos).
* Ritmo: `wait` (`duration` segundos).

As teclas modificadoras são enviadas pelo campo `text` nas ações de clique e rolagem (`shift`, `ctrl`, `alt`, `cmd`). Após uma ação de entrada, a ferramenta retorna uma nova captura de tela para que o modelo possa observar o resultado. Se houver mais de um nó com capacidade de controle do computador conectado, informe `node` explicitamente.

As capturas de tela são mantidas **somente para o modelo**: elas nunca são entregues automaticamente ao canal de chat. Trate todo o conteúdo exibido na tela como entrada não confiável; a ferramenta alerta o modelo para não seguir instruções exibidas na tela que entrem em conflito com a solicitação do usuário.

## O comando de nó `computer.act`

`computer.act` é o único comando de nó pelo qual a ferramenta encaminha entradas (`node.invoke` com `command: "computer.act"`). Ele é:

* **Perigoso por padrão**: aparece entre os comandos de nó perigosos integrados e fica excluído da lista de permissões de execução até ser armado explicitamente. Um nó macOS ainda pode declará-lo durante o emparelhamento para que a superfície seja aprovada uma única vez.
* **Exclusivo do macOS** atualmente: anunciado somente por um nó macOS que tenha **Permitir controle do computador** ativado.

As leituras reutilizam `screen.snapshot`; não há um segundo caminho de captura. Consulte [Nós de câmera e tela](/pt-BR/nodes/camera) para conhecer o comando de captura compartilhado.

## Ativar e armar

1. No aplicativo macOS, ative **Configurações → Permitir controle do computador**. Depois, abra **Configurações → Permissões** e conceda **Accessibility** e **Screen Recording** no macOS System Settings.

2. Aprove a atualização do emparelhamento no Gateway (um novo comando força um novo emparelhamento).

3. Exponha a ferramenta ao agente com capacidade de visão. Para o perfil padrão `coding`:

   ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
   {
     tools: {
       alsoAllow: ["computer"],
       // Agentes em sandbox também precisam desta segunda liberação:
       sandbox: { tools: { alsoAllow: ["computer"] } },
     },
   }
   ```

4. Arme `computer.act` por um período limitado. O plugin `phone-control` expõe um grupo `computer`:

   ```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
   /phone arm computer 30m
   /phone status
   /phone disarm
   ```

   O armamento exige `operator.admin` (ou o proprietário) e expira automaticamente. O grupo legado `/phone arm all` exclui intencionalmente o controle do desktop; use o grupo explícito `computer`. O armamento apenas alterna o que o Gateway pode invocar; o aplicativo macOS ainda aplica sua configuração **Permitir controle do computador** e as permissões do sistema operacional.

Para autorização persistente, adicione `computer.act` a `gateway.nodes.allowCommands` **e remova-o de** `gateway.nodes.denyCommands`; a lista de negação tem precedência. A autorização persistente não expira automaticamente. As entradas já presentes antes de `/phone arm` permanecem após `/phone disarm`; não converta uma concessão temporária em persistente enquanto ela estiver armada.

A autorização é deliberadamente dividida entre ativação e uso. Armar ou
configurar `computer.act` de forma persistente exige autoridade administrativa.
Depois de armado, um operador autenticado com `operator.write` pode invocar
`computer.act` por meio de `node.invoke` até que a concessão expire ou seja desarmada;
não há uma verificação administrativa por ação. Aprovar um nó que declare
`computer.act` apenas registra a superfície para que ela possa ser armada posteriormente e não
habilita a invocação por si só.

## Segurança

* Antes da autorização, todas as camadas (política de ferramentas, política de comandos do Gateway, configuração do macOS, Accessibility e Screen Recording) devem estar de acordo. Depois de armado, as ações são executadas sem confirmação por ação até a expiração ou `/phone disarm`.
* A entrada de texto é enviada um grafema por vez. Cancelamento, desconexão, pausa, desativação ou substituição do endpoint interrompe o envio antes do próximo grafema, em vez de permitir que o restante obsoleto continue.
* As capturas de tela são somente para o modelo e nunca são enviadas automaticamente ao chat (issue [#44759](https://github.com/openclaw/openclaw/issues/44759)).
* Trate o conteúdo da tela como não confiável; ele pode conter injeção de prompt.

## Relação com outros caminhos de controle do desktop

Este é o caminho controlado pelo agente. Consulte [Ponte Peekaboo](/pt-BR/platforms/mac/peekaboo) para saber como ele se relaciona com o host PeekabooBridge, o Codex Computer Use e o MCP direto `cua-driver`.