OpenClaw como agente de IA

O OpenClaw é chamado de agente de IA por causa do que acontece entre uma mensagem e uma resposta. A documentação descreve isso como uma execução serializada por sessão: recepção, montagem do contexto, inferência do modelo, execução de ferramentas, streaming e persistência, sendo a etapa das ferramentas a parte que um chatbot não tem. Ao redor do loop ficam um Gateway que é dono de todas as superfícies de mensagens, nós que emprestam dispositivos, subagentes que rodam em segundo plano e agendamentos que iniciam execuções sozinhos. Aqui está o loop como as páginas de arquitetura o descrevem, o que é montado antes de o modelo falar, as peças ao redor dele e os hooks que permitem mudar o comportamento dele.

O loop do agente é a execução serializada, por sessão, que transforma uma mensagem em ações e em uma resposta: recepção, montagem do contexto, inferência do modelo, execução de ferramentas, streaming, persistência.

O loop

• Uma requisição de agente valida seus parâmetros, resolve a sessão, persiste os metadados da sessão e retorna imediatamente um id de execução; uma chamada de espera separada fica bloqueada até o fim do ciclo de vida da execução.
• A execução resolve o modelo e os padrões de raciocínio dele, carrega o snapshot das skills, monta a sessão, assina os eventos do motor, transmite em streaming os deltas do assistente e das ferramentas e aplica o tempo limite da execução.
• As execuções são serializadas por chave de sessão, e opcionalmente por uma faixa global, para que não possam ocorrer condições de corrida entre ferramentas e sessões; uma reserva durável de escrita cerca cada gravação da transcrição, e uma execução substituída não consegue gravar dados obsoletos.

O que é montado antes de o modelo falar

O espaço de trabalho é resolvido e criado, e uma execução em sandbox pode ser redirecionada para uma raiz de sandbox. As skills são carregadas, ou reaproveitadas de um snapshot, e injetadas no ambiente e no prompt. Os arquivos de contexto de bootstrap vão para o prompt do sistema, que é montado a partir do prompt base do OpenClaw, do prompt das skills, do contexto de bootstrap e das substituições por execução, com os limites do modelo e a reserva de compactação aplicados. Os canais de mensagens escolhem um modo de fila que alimenta a faixa da sessão, e é por isso que uma segunda mensagem durante uma execução orienta a execução ou vem em seguida, em vez de colidir.

Ao redor do loop

• O Gateway: um único processo de longa duração que é dono de todas as superfícies de mensagens e expõe uma API WebSocket tipada, com o app para macOS, a CLI, a interface web e as automações se conectando como clientes.
• Os nós: hosts macOS, iOS, Android e headless se conectam pelo mesmo WebSocket com o papel de nó e expõem comandos como câmera, tela e localização; o pareamento é baseado em dispositivo.
• Subagentes e agendamentos: execuções em segundo plano disparadas a partir de uma execução, e execuções de cron ou de heartbeat, passam todas pelo mesmo loop e pela mesma política.

O Gateway do OpenClaw explicado explica o processo que é dono dos canais; nós do OpenClaw e mãos remotas, o que um dispositivo pareado empresta; e subagentes do OpenClaw, as execuções em segundo plano.

Hooks, e a fronteira

Dois sistemas de hooks vivem no processo: scripts internos em eventos de comando e de ciclo de vida, e hooks de plugin tipados dentro do loop, antes de o modelo ser resolvido, antes de o prompt ser montado, antes da resposta, depois da execução, em torno das chamadas de ferramentas e em torno da compactação, como observadores. Os webhooks são separados: eles aceitam requisições externas que disparam trabalho, em vez de assinar eventos do loop. A fronteira é a mesma que as páginas de segurança traçam: a etapa das ferramentas é o que faz disso um agente, e a política de ferramentas, as skills do OpenClaw que descrevem em vez de executar e as orientações sobre injeção de prompt no OpenClaw são o que impede que um agente que lê a web aberta seja conduzido por ela.

Na Diali

Na Diali, o loop é o mesmo código que a documentação descreve; o que muda é quem roda o Gateway ao redor dele e quem está acordado quando uma execução agendada falha. O que é o OpenClaw é a introdução em linguagem simples, e OpenClaw hospedado na Diali é o assistente.

• Recepção, contexto, inferência, ferramentas, streaming, persistência, uma sessão de cada vez.
• Gateway, nós, subagentes e agendamentos alimentam o mesmo loop.
• Os hooks mudam o loop; a política e o sandbox o delimitam.