O Plugin OpenClaw-Mem0 Adiciona Memória Persistente Fora da Janela de Contexto

O plugin openclaw-mem0 aborda as limitações de memória padrão do OpenClaw armazenando memórias fora da janela de contexto, tornando-as imunes à compactação de contexto, limites de tokens e reinicializações de sessão.

O Problema de Memória no OpenClaw

Os agentes do OpenClaw são sem estado entre sessões, com a memória padrão armazenada em arquivos que devem ser carregados explicitamente. A compactação de contexto resume o contexto mais antigo para economizar tokens, fazendo com que a memória injetada se torne lossy - arquivos de memória grandes e fatos aprendidos são comprimidos, reescritos ou descartados sem aviso.

Soluções alternativas da comunidade como arquivos MEMORY.md abrangentes, mecanismos de busca local BM25 + vetorial e logs de sessão com suporte a SQLite compartilham a mesma limitação: armazenam memória dentro da janela de contexto, tornando-as vulneráveis à compactação ou reinicializações de sessão.

Como o Plugin Funciona

O plugin executa dois processos a cada turno de conversa:

• Recall Automático: Busca no Mem0 por memórias relevantes antes do agente responder, injetando contexto correspondente (preferências, decisões passadas, detalhes do projeto) no contexto de trabalho a cada turno
• Captura Automática: Envia cada troca para o Mem0 após o agente responder, com a camada de extração do Mem0 determinando o que vale a pena persistir - novos fatos são armazenados, os desatualizados são atualizados e duplicatas são mescladas

Ambos os processos são habilitados por padrão na instalação.

Estrutura da Memória

O plugin separa a memória em dois escopos:

• Memórias de longo prazo: Escopo do usuário, persistem em todas as sessões (nome, stack tecnológico, estrutura do projeto, decisões)
• Memórias de curto prazo: Escopo da sessão, acompanham o trabalho ativo sem poluir o armazenamento de longo prazo

Ambos os escopos são pesquisados durante cada recall, com as memórias de longo prazo sendo apresentadas primeiro.

O agente recebe cinco ferramentas para gerenciamento explícito de memória:

• memory_search - consultas semânticas em todas as memórias
• memory_store - salvar explicitamente um fato específico
• memory_list - visualizar todas as memórias armazenadas
• memory_get - recuperar uma memória específica por ID
• memory_forget - excluir memórias (em conformidade com o GDPR)

Opções de Configuração

Configuração na nuvem (mais fácil):

openclaw plugins install @mem0/openclaw-mem0

Obtenha uma chave de API em app.mem0.ai, depois adicione ao openclaw.json:

{
  "openclaw-mem0": {
    "enabled": true,
    "config": {
      "apiKey": "${MEM0_API_KEY}",
      "userId": "your-user-id"
    }
  }
}

Totalmente local, totalmente privado (auto-hospedado):

Defina "mode": "open-source" e traga sua própria stack:

{
  "openclaw-mem0": {
    "enabled": true,
    "config": {
      "mode": "open-source",
      "userId": "your-user-id",
      "oss": {
        "embedder": {
          "provider": "ollama",
          "config": {
            "model": "nomic-embed-text"
          }
        },
        "vectorStore": {
          "provider": "qdrant",
          "config": {
            "host": "localhost",
            "port": 6333
          }
        }
      }
    }
  }
}