Um sistema de memória de 4 arquivos para agentes OpenClaw sem plugins

O problema com arquivos de memória básicos

Correções básicas de memória, como estruturar arquivos e usar /new inicialmente, funcionam, mas após um mês de uso diário, o MEMORY.md pode crescer para 300 linhas, fazendo com que os agentes apenas passem os olhos em vez de ler. O problema central: seu agente não sabe o que sabe. Ele não tem um mapa das informações armazenadas, portanto não consegue localizar com eficiência o contexto relevante de conversas anteriores.

O sistema de 4 arquivos

Este sistema usa quatro arquivos markdown, cada um com um propósito específico, sem necessidade de plugins, ferramentas externas ou bancos de dados.

• USER.md: Contém fatos permanentes sobre você que nunca mudam, a menos que sua vida mude. Carregado a cada sessão. Inclui informações de identidade e regras rígidas. Exemplo de conteúdo: # Sobre mim - Nome: [nome] - Parceira: Sarah, aniversário 12 de junho - Localização: Jersey City, fuso horário ET - Trabalho: [cargo] na [empresa] - Estilo de comunicação: direto, sem enrolação, sem linguagem corporativa # Regras rígidas - Nunca agende reuniões antes das 10h - Nunca envie e-mails sem minha aprovação - Nunca poste automaticamente nas redes sociais
• CONTEXT.md: Uma lista curta (máximo de 20-30 linhas) do que você está trabalhando, pensando ou aguardando no momento. Atualizado semanalmente. Resolve o problema do "agente não saber o que sabe" fornecendo contexto imediato no início da sessão. Exemplo de conteúdo: # Ativo agora (atualizado em 22 de março) ## Esta semana - Apresentação do Q2 com entrega em 28 de março, precisa dos dados de vendas do Mike - Reforma da cozinha: o empreiteiro Dave começa na segunda-feira, orçamento de US$ 15 mil - Viagem para Tóquio de 1 a 5 de abril: voos reservados, hotel ainda não ## Aguardando - Documentos fiscais do contador (enviados em 5 de março, acompanhar se não houver resposta até 25 de março) - Dados de vendas do Mike para o deck do Q2 ## Padrões que você notou sobre mim - Eu verifico portfólio + notícias todas as manhãs, gero briefing antes das 8h - Eu esqueço de acompanhar pessoas que conheço em eventos, me lembre após 2 semanas - Fim de semana = tarefas pessoais. Dia útil = trabalho. Não os misture.
• MEMORY.md: Armazena contexto contínuo estruturado por tópico, não como uma parede de texto. Seções por tópico ajudam o agente a encontrar informações sem ler tudo. Deve ser podado mensalmente. Exemplo de estrutura: # Pessoas - Sarah (esposa): trabalha na [empresa], aniversário 12 de junho, prefere restaurantes italianos - Mike (colega de trabalho): cuida do frontend, prefere Slack a e-mail, me deve dados de vendas # Projetos - Reforma da cozinha: empreiteiro Dave, orçamento de US$ 15 mil, cronograma de 4 semanas a partir de 25 de março - Apresentação do Q2: entrega em 28 de março, formato igual ao do Q1, Sarah revisou a última # Decisões tomadas - Mudou de opus para sonnet em 5 de março (motivos de custo, sem diferença de qualidade para tarefas diárias) - Usando API do Brave Search em vez do Google (nível gratuito é suficiente) - Apartamento em Jersey City em vez de Brooklyn (acesso ao PATH + US$ 400/mês mais barato) # Tarefas recorrentes - Briefing diário às 8h (calendário + e-mail + clima + portfólio) - Lista de compras semanal domingo às 18h - Relatório de despesas gerado automaticamente no último dia do mês
• ARCHIVE.md: Armazena projetos concluídos ou decisões antigas que podem ser importantes depois. O agente não carrega isso automaticamente, mas pode consultá-lo quando o contexto histórico for necessário. Exemplo de conteúdo: # Projetos concluídos - Busca de apartamento (fev 2026): escolheu Jersey City, assinou contrato em 25 de fevereiro - Declaração de imposto (mar 2026): contador cuidou, perdas de capital compensaram ganhos em ~US$ 2 mil # Decisões antigas - Testou configuração multiagente em 10 de fevereiro, voltou para agente único em 15 de fevereiro (custo de tokens, problemas de roteamento)

Rotina de manutenção

Pode o MEMORY.md mensalmente movendo projetos concluídos para o ARCHIVE.md ou excluindo-os. Mantenha o CONTEXT.md atualizado semanalmente. Um MEMORY.md de 300 linhas com projetos concluídos há dois meses desperdiça tokens em cada mensagem.