… …
Módulo 3 · Parte B de 3

O agente OpenClaw

O Módulo 3a conectou o navegador a um runtime persistente. O OpenClaw é o harness do agente dentro dessa stack do NemoClaw: combina um modelo e ferramentas com uma sessão mantida no servidor e um workspace em arquivos.

O NemoClaw fornece o blueprint que integra esse harness de execução ao OpenShell e à política de implantação. O OpenClaw conduz cada turno e carrega os arquivos do espaço de trabalho no contexto ativo, sem um orquestrador Python separado. Você examinará esses arquivos, comparará duas instruções de mensagem e verificará a memória armazenada em arquivos a partir de uma nova conversa.

Os arquivos do espaço de trabalho fornecem contexto. Após uma edição, compare a próxima resposta com o arquivo salvo.

O workspace, do ponto de vista do agente

Cada arquivo da pasta fornece uma parte diferente do prompt. Como esse mapeamento é estável, você pode prever qual comportamento uma edição afetará.

.openclaw/workspace/ SOUL.md persona, limites, tom, valores AGENTS.md instruções e regras de funcionamento IDENTITY.md nome, criatura, vibe, emoji USER.md quem é o humano, preferências TOOLS.md notas de utilização por ferramenta HEARTBEAT.md lista periódica de tarefas autônomas memory/ registros diários, um arquivo por dia 2026-06-11.md notas brutas adicionadas durante o trabalho MEMORY.md memória de longo prazo selecionada (somente sessão principal) skills/ pacotes Markdown por skill (próxima página)

A memória tem dois níveis. Enquanto trabalha, o agente acrescenta notas brutas a um arquivo datado em memory/ e resume o que deve persistir no armazenamento de longo prazo, MEMORY.md. Por padrão, MEMORY.md é incluído no contexto da sessão principal e omitido dos prompts compartilhados ou de grupo. Essa escolha de contexto não restringe o acesso ao arquivo. Alguns passos adiante, você lerá ambos diretamente do sandbox em execução.

Compare o relato do agente com os arquivos. Pergunte ao agente o que seu prompt contém e compare a resposta com o workspace ativo no passo 1b:

Passo 1 · Peça ao agente para se descrever

Em um turno, a célula abaixo pede ao OpenClaw que liste os arquivos do próprio espaço de trabalho e explique a função de cada um. A resposta reflete o que o ambiente inclui no prompt e o que suas ferramentas leem. Após editar um arquivo, compare o novo relatório com uma leitura feita como operador.

Compare o que o agente relata sobre seu contexto com a leitura do espaço de trabalho. Um arquivo alterado, por si só, não demonstra qual conteúdo foi usado em uma resposta.

O mesmo runtime do Kickstart. Estas células reutilizam o launchable conectado em 3a. O curso expõe seu gateway em vez da rota interna /v1/chat/completions. Se uma célula falhar ou parar de responder, execute Verificação de integridade e examine as evidências antes de escolher uma ação de recuperação. Uma implantação local pode usar o playbook de configuração do NemoClaw e o mesmo contrato do gateway.

Verificar o workspace a partir do plano do operador?

Passo 1b · Leia o workspace você mesmo

O Passo 1 pediu ao agente que descrevesse os arquivos; você não precisa aceitar apenas o relato. Até aqui, seu único canal foi o gateway que leva mensagens ao agente.

O launchable também expõe um terminal do operador, um shell no host fora do sandbox do agente. O helper helpers.terminal() abre esse shell diretamente nesta página por dois pontos de entrada:

  • helpers.terminal("bash") abre o shell da VM do host, onde você pode executar openshell sandbox list.
  • helpers.terminal("openshell sandbox connect <agent>") entra dentro do sandbox em que o agente é executado e onde fica o workspace.

O OpenShell fornece o sandbox no nível do kernel que contém o agente. Por enquanto, trate-o como o limite entre operador e agente; o Módulo 4 define e testa esse limite. O nome usado no comando de conexão vem de GET /api/agent, a mesma chamada usada pelo Kickstart para descobrir o launchable.

A célula abaixo entra no sandbox e lê três arquivos da instância ativa: SOUL.md, a memória diária e o MEMORY.md selecionado. Edite a lista de comandos e execute novamente para explorar outros arquivos.

O launchable tem dois planos de autoridade. O primeiro é o terminal, que atua como operador acima do limite do sandbox e pode inspecionar os arquivos permitidos àquela conta de operador e listar seus sandboxes. O agente ocupa o segundo plano. Ele compartilha a máquina com o terminal, mas é executado sob a política mais restrita do OpenShell testada no Módulo 4.

Etapa 2 · Compare as instruções das mensagens

Faça a mesma pergunta de revisão em duas sessões novas. A segunda solicitação pede explicitamente as verificações de evidências de um auditor. Examine os dois prompts e compare as respostas. As instruções da mensagem mudam; SOUL.md não é editado e nenhum outro arquivo de personalidade é selecionado.

Passo 3 · O agente edita o próprio contexto

Peça ao agente que acrescente uma preferência com um rótulo único a MEMORY.md. Uma leitura pela interface de operador verifica a referência salva antes de pedir ao agente que a leia em uma nova conversa. Afirmar que salvou não é evidência suficiente. A nota acrescentada permanece disponível para inspeção.

Essa separação afeta diretamente a segurança. Um agente capaz de reescrever o contexto do workspace pode influenciar execuções posteriores. As regras configuradas do sistema de arquivos e da rede determinam quais outros recursos ele pode alcançar. Examine a política ativa para verificar o acesso a:

No próximo módulo, você verá esse limite ser testado diretamente, quando um agente com privilégios excessivos concedidos de propósito tentar ultrapassá-lo.

Referências

Lista completa em Próximos passos · Referências.

Experimente · chat com o seu agente ao vivo

Use o chat para examinar um arquivo do espaço de trabalho. Compare a resposta com a leitura pela interface de operador e examine as chamadas de ferramentas. Você pode pedir ao agente para:

Depois de editar um arquivo, inicie uma sessão nova e verifique qual conteúdo o agente usa.

← Módulo 3a: Ligar NemoClaw