MEMORY.md
MEMORY.md
O Que É MEMORY.md
MEMORY.md é o arquivo de memória de longo prazo do OpenClaw — um documento em formato Markdown onde o agente armazena informações que devem persistir entre sessões e conversas. É o mecanismo pelo qual o OpenClaw lembra quem você é, o que você prefere, em que projetos está trabalhando e quais decisões já foram tomadas, mesmo depois de dias ou semanas sem interação.
O problema que o MEMORY.md resolve é fundamental em sistemas de IA: por padrão, modelos de linguagem não têm memória entre sessões. Cada conversa começa do zero — o modelo não sabe que você se chama João, que prefere respostas diretas sem enrolação, que está trabalhando em um projeto de e-commerce ou que decidiu usar PostgreSQL como banco de dados. Repetir esse contexto a cada sessão é improdutivo e frustrante.
O MEMORY.md funciona como um caderno de anotações inteligente que o agente consulta no início de cada sessão principal. Ao contrário de soluções de memória baseadas apenas em embeddings e busca vetorial — que são poderosas mas opacas — o MEMORY.md é completamente legível e editável por humanos. Você sabe exatamente o que o agente sabe sobre você, pode corrigir informações incorretas e pode controlar o que deve ou não ser lembrado.
Como Funciona
O fluxo de funcionamento do MEMORY.md envolve três momentos. No início da sessão, o OpenClaw lê o arquivo MEMORY.md e incorpora seu conteúdo ao contexto da conversa — o agente já começa a sessão com todas as informações relevantes sem você precisar repetir nada. Durante a conversa, quando algo novo e importante é aprendido (uma preferência, uma decisão, uma informação de projeto), o agente pode propor adicionar ao MEMORY.md ou fazê-lo automaticamente conforme configurado. No encerramento, o arquivo é atualizado com os novos aprendizados para que estejam disponíveis na próxima sessão.
A busca semântica via memory_search complementa o MEMORY.md para bases de conhecimento maiores: enquanto o arquivo principal contém resumos curados das informações mais importantes, a busca semântica permite recuperar detalhes específicos de arquivos de memória adicionais sem precisar carregar tudo no contexto de uma só vez.
O arquivo usa Markdown padrão, o que significa que pode ser editado em qualquer editor de texto, versionado com Git e mantido junto ao restante dos arquivos do projeto. Essa simplicidade é intencional — a transparência e o controle do usuário sobre sua própria memória são princípios centrais do design do OpenClaw.
Exemplo Prático
Uma consultora de marketing digital em São Paulo usa o OpenClaw para automatizar tarefas do dia a dia. Seu MEMORY.md reflete meses de interação acumulada:
# MEMORY.md — Ana Ribeiro
## Perfil Profissional
- Consultora de marketing digital independente
- Clientes principais: 3 e-commerces de moda, 2 SaaS B2B
- Prefere respostas diretas e estruturadas (sem enrolação)
- Domina: Google Ads, Meta Ads, SEO, e-mail marketing
## Clientes Ativos (2026)
### Loja Bella (moda feminina)
- Foco atual: aumentar ROAS no Meta Ads (meta: 4x)
- Budget mensal: R$ 15k
- Reunião semanal: terças às 15h
- Contato: Paula Mendes (paula@lojabella.com.br)
### TechFlow (SaaS B2B)
- Objetivo: geração de leads qualificados para vendas
- Canais: LinkedIn Ads + SEO + e-mail
- Próximo milestone: 200 leads/mês até junho
## Preferências de Trabalho
- Relatórios: sempre em PDF com resumo executivo na primeira página
- E-mails para clientes: sempre revisar antes de enviar
- Reuniões: nunca antes das 9h, almoço livre
## Decisões Importantes
- 2026-01-15: Migrou todos os clientes para GA4
- 2026-02-03: Começou a usar Claude para criar copy de anúncios
- 2026-02-20: Definiu template padrão para relatórios mensais
Com esse arquivo, o OpenClaw sabe o contexto completo de cada cliente quando Ana pede ajuda. “Crie um relatório mensal para a Bella” já vem com o formato correto, os dados relevantes e o tom adequado para a Paula — sem precisar explicar nada do zero.
Importância para Empresas
Para uso profissional e empresarial, o MEMORY.md é o que transforma um assistente de IA genérico em um assistente verdadeiramente personalizado ao contexto de uma empresa ou profissional. Sem memória, cada interação começa do zero e o valor se acumula lentamente. Com MEMORY.md bem estruturado, o agente fica mais útil a cada sessão — aprendendo preferências, contexto de negócio e padrões de trabalho.
Para equipes, o MEMORY.md pode ser compartilhado e versionado no repositório do projeto, garantindo que todos os membros que usam o OpenClaw para aquele projeto tenham acesso ao mesmo contexto. Isso é especialmente valioso em projetos de longa duração onde o histórico de decisões e o contexto acumulado têm alto valor.
MEMORY.md no OpenClaw
O MEMORY.md é um componente nativo do OpenClaw, com suporte integrado para leitura automática no início de sessões, atualização durante conversas e busca semântica em arquivos de memória estendidos. A organização recomendada inclui o MEMORY.md como resumo curado, arquivos diários em memory/YYYY-MM-DD.md para logs brutos das sessões, e arquivos por projeto em memory/projeto-x.md para contextos específicos.
Termos Relacionados
Perguntas Frequentes
O MEMORY.md tem limite de tamanho? Tecnicamente não, mas arquivos muito grandes aumentam o uso de contexto a cada sessão. A recomendação é manter o MEMORY.md principal conciso e usar arquivos de memória adicionais com busca semântica para informações detalhadas.
O agente pode escrever no MEMORY.md sem minha permissão? Isso depende da configuração. Por padrão, o OpenClaw propõe atualizações e aguarda confirmação. Em configurações mais autônomas, pode atualizar automaticamente ao final de sessões. O comportamento é configurável.
O MEMORY.md é seguro? Meus dados ficam onde? O MEMORY.md é um arquivo local no seu sistema de arquivos, exatamente onde você configurar. Não é enviado a nenhum servidor externo além do conteúdo que entra no prompt enviado ao LLM. Se usar um modelo local via Ollama, nada sai do seu computador.
Posso ter MEMORY.md diferentes para contextos diferentes? Sim. O OpenClaw suporta múltiplos arquivos de memória organizados por projeto ou contexto. Você pode configurar qual arquivo de memória é carregado dependendo do projeto ou tarefa em andamento.
E se o agente gravar uma informação errada no MEMORY.md? Como é um arquivo de texto simples, você pode editar diretamente em qualquer editor. É uma das vantagens do formato transparente — você tem controle total sobre o que o agente sabe sobre você.