Visão geral da memória

OpenClaw lembra coisas escrevendo arquivos Markdown simples no espaço de trabalho do seu agente. O modelo só "lembra" o que é salvo em disco — não há estado oculto.

# Como funciona

Seu agente tem três arquivos relacionados à memória:

• MEMORY.md — memória de longo prazo. Fatos, preferências e decisões duráveis. Carregado no início de cada sessão de DM.
• memory/YYYY-MM-DD.md — notas diárias. Contexto contínuo e observações. As notas de hoje e de ontem são carregadas automaticamente.
• DREAMS.md (opcional) — Diário de Sonhos e resumos de varredura de dreaming para revisão humana, incluindo entradas fundamentadas de preenchimento histórico.

Esses arquivos ficam no espaço de trabalho do agente (padrão ~/.openclaw/workspace).

# Compromissos inferidos

Alguns acompanhamentos futuros não são fatos duráveis. Se você mencionar uma entrevista amanhã, a memória útil pode ser "verificar depois da entrevista", não "armazenar isso para sempre em MEMORY.md."

Compromissos são memórias de acompanhamento opcionais e de curta duração para esse caso. O OpenClaw as infere em uma passagem de fundo oculta, limita-as ao mesmo agente e canal, e entrega check-ins vencidos por meio de heartbeat. Lembretes explícitos ainda usam tarefas agendadas.

# Ferramentas de memória

O agente tem duas ferramentas para trabalhar com memória:

• memory_search — encontra notas relevantes usando busca semântica, mesmo quando a redação difere da original.
• memory_get — lê um arquivo de memória específico ou um intervalo de linhas.

As duas ferramentas são fornecidas pelo plugin de active memory (padrão: memory-core).

# Plugin complementar Memory Wiki

Se quiser que a memória durável se comporte mais como uma base de conhecimento mantida do que apenas notas brutas, use o plugin incluído memory-wiki.

memory-wiki compila conhecimento durável em um cofre wiki com:

• estrutura de página determinística
• alegações e evidências estruturadas
• rastreamento de contradição e atualidade
• painéis gerados
• resumos compilados para consumidores do agente/runtime
• ferramentas nativas de wiki como wiki_search, wiki_get, wiki_apply e wiki_lint

Ele não substitui o plugin de active memory. O plugin de active memory ainda é responsável por recuperação, promoção e dreaming. memory-wiki adiciona uma camada de conhecimento rica em proveniência ao lado dele.

Consulte Memory Wiki.

# Busca de memória

Quando um provedor de embeddings está configurado, memory_search usa busca híbrida — combinando similaridade vetorial (significado semântico) com correspondência por palavras-chave (termos exatos como IDs e símbolos de código). Isso funciona imediatamente assim que você tem uma chave de API para qualquer provedor compatível.

Para detalhes sobre como a busca funciona, opções de ajuste e configuração de provedores, consulte Busca de memória.

# Backends de memória

# Camada de wiki de conhecimento

# Descarga automática da memória

Antes que a compaction resuma sua conversa, o OpenClaw executa um turno silencioso que lembra o agente de salvar contexto importante em arquivos de memória. Isso vem ativado por padrão — você não precisa configurar nada.

Para manter esse turno de manutenção em um modelo local, defina uma substituição exata do modelo de descarga de memória:

{
  "agents": {
    "defaults": {
      "compaction": {
        "memoryFlush": {
          "model": "ollama/qwen3:8b"
        }
      }
    }
  }
}

A substituição se aplica apenas ao turno de descarga de memória e não herda a cadeia de fallback da sessão ativa.

# Dreaming

Dreaming é uma passagem opcional de consolidação em segundo plano para memória. Ele coleta sinais de curto prazo, pontua candidatos e promove apenas itens qualificados para a memória de longo prazo (MEMORY.md).

Ele foi projetado para manter a memória de longo prazo com alto sinal:

• Opcional: desativado por padrão.
• Agendado: quando ativado, memory-core gerencia automaticamente um job cron recorrente para uma varredura completa de dreaming.
• Com limiares: promoções devem passar por gates de pontuação, frequência de recuperação e diversidade de consulta.
• Revisável: resumos de fase e entradas de diário são gravados em DREAMS.md para revisão humana.

Para comportamento de fases, sinais de pontuação e detalhes do Diário de Sonhos, consulte Dreaming.

# Preenchimento fundamentado e promoção ao vivo

O sistema de dreaming agora tem duas trilhas de revisão intimamente relacionadas:

• Dreaming ao vivo trabalha a partir do armazenamento de dreaming de curto prazo em memory/.dreams/ e é o que a fase profunda normal usa ao decidir o que pode se graduar para MEMORY.md.
• Preenchimento fundamentado lê notas históricas memory/YYYY-MM-DD.md como arquivos de dia independentes e grava saída de revisão estruturada em DREAMS.md.

O preenchimento fundamentado é útil quando você quer reproduzir notas antigas e inspecionar o que o sistema considera durável sem editar manualmente MEMORY.md.

Quando você usa:

openclaw memory rem-backfill --path ./memory --stage-short-term

os candidatos duráveis fundamentados não são promovidos diretamente. Eles são preparados no mesmo armazenamento de dreaming de curto prazo que a fase profunda normal já usa. Isso significa:

• DREAMS.md continua sendo a superfície de revisão humana.
• o armazenamento de curto prazo continua sendo a superfície de ranqueamento voltada à máquina.
• MEMORY.md ainda é gravado apenas pela promoção profunda.

Se você decidir que a reprodução não foi útil, pode remover os artefatos preparados sem tocar em entradas comuns de diário ou no estado normal de recuperação:

openclaw memory rem-backfill --rollback
openclaw memory rem-backfill --rollback-short-term

# CLI

openclaw memory status          # Check index status and provider
openclaw memory search "query"  # Search from the command line
openclaw memory index --force   # Rebuild the index

# Leitura adicional

• Mecanismo de memória integrado: backend SQLite padrão.
• Mecanismo de memória QMD: sidecar local-first avançado.
• Memória Honcho: memória entre sessões nativa de IA.
• Memory LanceDB: plugin baseado em LanceDB com embeddings compatíveis com OpenAI.
• Memory Wiki: cofre de conhecimento compilado e ferramentas nativas de wiki.
• Busca de memória: pipeline de busca, provedores e ajustes.
• Dreaming: promoção em segundo plano da recuperação de curto prazo para memória de longo prazo.
• Referência de configuração de memória: todos os controles de configuração.
• Compaction: como a compaction interage com a memória.

# Relacionado

• Active memory
• Busca de memória
• Mecanismo de memória integrado
• Memória Honcho
• Memory LanceDB
• Compromissos