Como a Memória do OpenCLAW Realmente Funciona

Os agentes OpenCLAW não possuem memória persistente entre conversas. Cada vez que você envia uma mensagem, o agente lê vários arquivos (SOUL.md, USER.md, MEMORY.md e o histórico recente da sessão) e constrói sua "memória" do zero. Não é lembrar - é ler suas anotações.

Por Que Seu Agente Esquece as Coisas

Motivo 1: Sua sessão está muito antiga

Cada mensagem em sua sessão atual é incluída em cada nova chamada de API. Após 2-3 semanas, isso se torna milhares de tokens. O modelo atinge seu limite de contexto (conversas antigas são silenciosamente truncadas) ou o OpenCLAW executa compactação que resume tudo, mas perde detalhes.

Solução: Use /new regularmente - diariamente no mínimo, e antes de qualquer tarefa grande. Isso limpa o buffer da conversa mantendo todos os arquivos intactos.

Motivo 2: Informações importantes estão no histórico do chat, não nos arquivos

Se você contou algo ao seu agente em uma conversa há 3 semanas, essa informação está no histórico da sessão que será truncado. Qualquer coisa que seu agente deve SEMPRE saber precisa estar em um arquivo, não no chat.

Solução: Coloque informações permanentes no USER.md:

# Sobre mim
- Nome: [seu nome]
- Parceiro(a): [nome]
- Localização: [cidade]
- Trabalho: [cargo]
- Fuso horário: [fuso horário]

Preferências

Comunicação: direta, sem enrolação
Rotina matinal: briefing às 8h
Nunca agende reuniões antes das 10h
Pedido de café: [qualquer que seja, sério]

Este arquivo é carregado a cada sessão e nunca é truncado ou compactado.

Motivo 3: MEMORY.md é uma bagunça inchada

A maioria das pessoas nunca estrutura o MEMORY.md, então após um mês ele se torna uma enorme parede de texto que o modelo apenas passa os olhos em vez de ler. Fatos importantes ficam enterrados sob detalhes irrelevantes.

Solução: Estruture seu MEMORY.md em seções claras:

# Pessoas
Sarah (esposa): trabalha na [empresa], aniversário 12 de junho
Mike (colega de trabalho): cuida do frontend, prefere slack ao email

Projetos Ativos

Reforma da cozinha: empreiteiro é Dave, orçamento $15K, começa em abril
Apresentação do Q2: entrega 28 de março, precisa de dados de vendas do Mike

Decisões Tomadas

Mudou de opus para sonnet em 5 de março (motivos de custo)
Usando API do brave search em vez do google (camada gratuita suficiente)

Tarefas Recorrentes

Briefing diário às 8h (calendário + email + clima)
Lista de compras semanal todo domingo às 18h

Memória organizada é recuperada com precisão. O agente lê texto estruturado melhor do que uma parede de parágrafos.

Motivo 4: Você não tem uma rotina de manutenção da memória

Arquivos de memória crescem para sempre sem limpeza. Após 2 meses, MEMORY.md tem 300 linhas com metade desatualizada ou irrelevante, desperdiçando tokens em projetos concluídos.

Solução: Configure um cron de memória noturno. Adicione isso às instruções do seu agente:

toda noite às 23h:


revise as conversas de hoje
extraia quaisquer novos fatos, decisões ou compromissos
adicione-os à seção correta no MEMORY.md
remova qualquer coisa que não seja mais relevante
inicie uma nova sessão

Motivo 5: Você está confundindo memória de sessão com memória de longo prazo

Entenda a hierarquia:

• SOUL.md: Identidade e personalidade. Carregado toda vez. Nunca muda a menos que você mude.
• USER.md: Fatos sobre você. Carregado toda vez. Atualize quando sua vida mudar.
• MEMORY.md: Contexto em andamento. Carregado toda vez. Cresce e é podado.