Correções práticas para problemas de confiabilidade do OpenClaw

Um desenvolvedor no r/openclaw detalhou sua abordagem para superar problemas comuns de confiabilidade do OpenClaw, passando de uma experiência inicial frustrante para uma configuração estável. Sua solução se concentra em tratar o agente como se não tivesse memória persistente entre sessões e impor tudo por meio de arquivos e scripts estruturados.

Técnicas-chave que funcionaram

• Usar múltiplas instalações para redundância: Eles mantêm duas instalações do OpenClaw que podem se conectar via SSH uma à outra para corrigir configurações quebradas quando surgem problemas.
• Tratar arquivos integrados como documentos vivos: O desenvolvedor enfatiza atualizar ativamente SOUL.md, AGENTS.md, USER.md e MEMORY.md em vez de configurá-los uma vez. Regras importantes vão em AGENTS.md, correções vão em MEMORY.md, e qualquer coisa apenas no chat é perdida entre sessões.
• Criar um sistema de memória de 3 camadas: Eles adicionaram:
  • Camada 1 (quente): Logs diários (memory/AAAA-MM-DD.md) mais MEMORY.md para contexto recente e fatos curados lidos a cada sessão.
  • Camada 2 (morno): Busca de memória vetorial do OpenClaw para recuperação semântica em transcrições de sessões e arquivos de memória.
  • Camada 3 (profundo): Um grafo de conhecimento A-Mem com 668 fatos em 41 entidades, pontuações de ativação, decaimento temporal e links entre entidades. Tarefas cron rodam todas as noites para extrair novos fatos das conversas e atualizar o grafo, e semanalmente para decair fatos desatualizados e reconstruir links.
  Isso permite a recuperação de informações mencionadas até seis semanas antes.
• Corrigir a qualidade da recuperação com pontuações de ativação: Eles descobriram que todos os 691 fatos em seu grafo de conhecimento tinham a mesma pontuação de ativação (0,5), tornando os resultados da busca aleatórios. Eles construíram um script de aumento de ativação que aumenta a pontuação de um fato em +0,1 cada vez que ele é acessado e aplica decaimento temporal a fatos não tocados, melhorando a priorização da recuperação.
• Forçar uma limpeza pré-compactação: Para evitar perda de contexto quando o OpenClaw compacta a memória, eles usam o evento de pré-compactação para escrever WORKING.md com o estado completo da conversa antes da limpeza, evitando a perda de mais de 12 horas de contexto que experimentaram anteriormente.
• Escrever correções imediatamente: Eles mantêm um arquivo .learnings/LEARNINGS.md que registra cada correção significativa com data, erro, correção e importância, garantindo que sessões futuras herdem esses aprendizados.
• Tornar instruções não negociáveis em arquivos: Eles reescreveram as regras do AGENTS.md com linguagem explícita como "NÃO NEGOCIÁVEL" e "SEM EXCEÇÕES", incluindo exemplos de falha, descobrindo que linguagem direta é seguida de forma mais consistente do que sugestões educadas.
• Scripts de verificação de segurança: Em vez de confiar no julgamento do agente para verificações de saúde do cron, eles substituíram por um script shell que lida com a lógica de comparação. O agente simplesmente executa o script e relata a saída, removendo o julgamento do ciclo.
• Impor verificar-antes-de-afirmar como regra escrita: Depois que o agente manteve uma suposição errada entre sessões, eles adicionaram uma regra no topo de cada AGENTS.md: nunca afirmar algo como fato sem verificar, pesquisar primeiro e dizer "Não sei" se não tiver certeza.

O modelo mental central é tratar o agente como alguém que perde todas as memórias todas as noites, com os arquivos servindo como memória institucional.