--- title: "MEMORY.md" url: "https://openclaw.ia.br/glossario/memory-md/" markdown_url: "https://openclaw.ia.br/glossario/memory-md.MD" description: "Arquivo de memória de longo prazo do OpenClaw para persistir informações entre sessões" date: "2026-02-02" author: "" --- # MEMORY.md Arquivo de memória de longo prazo do OpenClaw para persistir informações entre sessões # 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](/glossario/llm/): 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: ```markdown # 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 - [Contexto](/glossario/contexto/) - [LLM](/glossario/llm/) - [Embedding](/glossario/embedding/) - [RAG](/glossario/rag/) - [Agentes de IA](/glossario/agentes-de-ia/) ## 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ê.