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.

Cinco Razões pelas Quais Seu Agente Esquece Coisas

Razão 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 (fazendo com que conversas iniciais sejam 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 importante. Isso limpa o buffer da conversa mantendo todos os arquivos intactos.

Razão 2: Informações importantes estão no histórico de chat, não em 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 em 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 enfeites
Rotina matinal: briefing às 8h
Nunca agende reuniões antes das 10h
Pedido de café: [qualquer que seja, sério]

Razão 3: MEMORY.md é uma bagunça inchada

A maioria das pessoas nunca estrutura o MEMORY.md. 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: contratante é 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 (razões de custo)
Usando API do brave search em vez do google (nível gratuito suficiente)

Tarefas Recorrentes

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

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

Arquivos de memória crescem para sempre. Após 2 meses, seu MEMORY.md tem 300 linhas e metade está desatualizada ou irrelevante. O modelo desperdiça tokens lendo sobre projetos concluídos.

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

todas as noites às 23h:
1. revise as conversas de hoje
2. extraia quaisquer novos fatos, decisões ou compromissos
3. adicione-os à seção correta em MEMORY.md
4. remova qualquer coisa que não seja mais relevante
5. inicie uma nova sessão

Razão 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ê o 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.