Automatizando Atualizações do OpenClaw com um Agente de IA: Um Manual Testado em Campo

Atualizações do OpenClaw são notórias por quebrar coisas — migrações de configuração legadas, mudanças silenciosas de capacidades e casos extremos de gerenciamento de processos. Um desenvolvedor ficou farto de redescobrir os mesmos problemas e ensinou seu agente Hermes a lidar com todo o processo de atualização. O resultado: a recente atualização 2026.7.1 → 2026.8.1 ('OpenClaw 2.0') passou de 'várias horas de solução de problemas tensa' para 'rode o playbook, encontre dois problemas conhecidos, ambos autodiagnosticados em menos de um minuto cada'.

A Configuração

O autor opera uma pequena frota: um servidor gateway EC2 e dois Macs (um MacBook Pro e um Mac mini), cada um rodando tanto o CLI do OpenClaw quanto o aplicativo nativo. Todos apontam para o mesmo backend. Essa configuração multi-host torna 'apenas reinicie e veja' impraticável.

A Ideia Central: A Memória do Seu Agente é o Produto

Qualquer agente pode rodar doctor --fix e ler a saída. O valor real vem quando ele:

• Escreve o que encontrou em um formato pesquisável.
• Atualiza seu conhecimento procedural (uma habilidade/runbook) para que a próxima atualização comece a partir de 'aqui está o que sabemos'.
• Cruza referências com um armazenamento de memória pesquisável para incidentes passados.

O autor usa três componentes:

• Arquivo de habilidade: Um procedimento estruturado com pegadinhas, construído ao longo de ~9 meses de atualizações.
• Armazenamento de memória semântica: MemPalace (github.com/mempalace/mempalace) indexa relatos de incidentes passados para busca difusa como 'conflito de identidade de dispositivo app'.
• Arquivo de contexto compartilhado: Também lido pelo agente do lado do OpenClaw, para que as lições aprendidas pelo Hermes não fiquem isoladas.

O Que Realmente Deu Errado na Versão 2026.8.1

Três problemas específicos, e por que eles não deveriam surpreender você duas vezes:

1. doctor --repair não é uma operação de uma única vez. Em uma instalação madura e multi-agente, espere rodá-lo repetidamente — cada passagem limpa uma camada de configuração/estado legado e revela a próxima. O autor precisou de 11 passagens apenas no gateway antes de uma saída limpa. Desistir após a passagem 2 leva a um diagnóstico errado.
2. Gateways multi-agente precisam de propriedade explícita. Se você roda mais de uma persona de agente por gateway, a nova versão exige declarar qual delas 'possui' operações ambientais/nível de sistema. Existem dois modos de declaração — estrito e simples. O estrito causou um loop de travamento críptico; o simples é mais seguro, a menos que você tenha mapeado todos os casos extremos.
3. Um arquivo de configuração legado pode bloquear todo o pipeline de reparo. Um arquivo JSON desatualizado (exec-approvals) impediu silenciosamente que todos os outros reparos fossem aplicados até ser especificamente resolvido.

Nada disso é ferramenta específica do OpenClaw — é apenas 'dar ao agente um lugar para anotar coisas e um hábito de fazê-lo'. A mesma abordagem funciona com Claude Code, Codex ou qualquer agente com ferramentas.