Memória Multi-Agente: Sistema de Memória Compartilhada de Código Aberto para Agentes de IA

Multi-Agent Memory é um projeto de código aberto que fornece aos agentes de IA um sistema de memória compartilhada que funciona entre máquinas, ferramentas e frameworks. Ele nasceu de uma configuração de produção onde agentes OpenClaw, Claude Code e fluxos de trabalho n8n precisavam compartilhar memória entre máquinas separadas.

O Problema que Ele Resolve

Ao executar múltiplos agentes de IA como Claude Code para desenvolvimento, OpenClaw para tarefas autônomas e n8n para automação, cada um mantém seu próprio contexto e esquece tudo entre sessões. As soluções existentes são apenas para máquina única, exigem serviços em nuvem pagos ou tratam a memória como um armazenamento chave-valor plano sem entender que fatos e eventos são fundamentalmente diferentes.

Memória Tipada com Semântica de Mutação

O sistema compreende quatro tipos distintos de memória, cada um com seu próprio ciclo de vida:

• evento: Somente acréscimo, registro histórico imutável. Caso de uso: "Implantação concluída", "Fluxo de trabalho falhou"
• fato: Upsert por chave, novos fatos substituem os antigos. Caso de uso: "Status da API: saudável", "Cliente prefere modo escuro"
• status: Atualização no local por assunto, o mais recente vence. Caso de uso: "pipeline-de-build: passando", "migração: em-andamento"
• decisão: Somente acréscimo, registra escolhas e raciocínio. Caso de uso: "Escolheu Postgres em vez de MySQL porque..."

Ciclo de Vida da Memória

O sistema segue este processo: Armazenar → Verificação de Dedup → Cadeia de Substituição → Decaimento de Confiança → Consolidação de LLM

• Deduplicação: O conteúdo é hash no armazenamento, duplicatas exatas retornam a memória existente
• Substituição: Ao armazenar um fato com a mesma chave de um fato existente, o antigo é marcado como inativo e o novo se vincula a ele
• Decaimento de Confiança: Fatos e status perdem confiança ao longo do tempo se não acessados (configurável, padrão 2%/dia). Eventos e decisões não decaem
• Consolidação de LLM: Processo periódico em segundo plano (configurável, padrão a cada 6 horas) envia memórias não consolidadas para um LLM que encontra duplicatas para mesclar, contradições para sinalizar, conexões entre memórias e insights entre memórias

Recursos de Segurança

• Limpeza de Credenciais: Todo o conteúdo é limpo antes do armazenamento. Chaves de API, JWTs, chaves privadas SSH, senhas e segredos codificados em base64 são automaticamente redigidos
• Isolamento de Agentes: A API atua como um guardião entre agentes e dados. Os agentes podem apenas armazenar e pesquisar memórias, ler briefings e estatísticas. Eles não podem excluir memórias, descartar tabelas, contornar a limpeza de credenciais, acessar sistema de arquivos/banco de dados diretamente ou modificar memórias de outros agentes retroativamente
• Implementação de Segurança: Autenticação segura contra timing usando cr****.timingSafeEqual(), validação de inicialização exigindo variáveis de ambiente e limpeza de credenciais antes do armazenamento

Briefings de Sessão

O sistema suporta briefings de sessão que resumem o que aconteceu desde a última sessão, permitindo que os agentes comecem com contexto relevante.