## O teto da memória

Se você executar o OpenClaw hoje, seu agente armazenará memória em `MEMORY.md` e arquivos datados em um diretório `memory/`. Isso funciona para uso de agente único e sessão única. No momento em que você confia nessa memória para qualquer coisa em andamento, você atinge o limite. Os modos de falha são específicos e previsíveis.

**A compactação da memória descarta fatos.** O OpenClaw aciona um agente silencioso que grava "memórias duráveis" antes de truncar o contexto. O que estava no arquivo antes da compactação é desconhecido. Se a versão compactada abandonou um fato, ele desapareceu. Não há registro de observação. Sem reversão.

**Nenhuma identidade de entidade entre sessões.** "Acme Corp" em uma sessão e "ACME CORP" na próxima pode ou não resolver para a mesma entidade. O agente infere novamente a cada vez a partir da janela de contexto. Não há IDs estáveis. Sem regras de mesclagem.

**Gravações simultâneas em estado corrompido.** Se você executar vários agentes ou plug-ins que tocam nos mesmos arquivos de memória, você obterá corrupção de dados. A própria documentação do OpenClaw reconhece isso. O teto de agente único é real, e a maioria dos fluxos de trabalho de agente não permanecerá com agente único para sempre.

**Sem trilha de auditoria.** Quando o agente dá uma resposta errada, você não pode rastreá-la até uma observação específica. Você não consegue ver o que mudou entre terça e quinta. Você não pode responder "o que meu agente sabia quando tomou essa decisão?"

Estes não são casos extremos. Eles aparecem assim que o agente lida com contatos, tarefas, transações ou qualquer estado importante nas sessões.

## O que o plugin adiciona

[Neotoma v0.4.3](https://github.com/markmhendrickson/neotoma/releases/tag/v0.4.3) adds an `openclaw.plugin.json` manifest, an entry point, and tool definitions that register into OpenClaw's four-layer plugin system. O Gateway descobre o plugin, valida o manifesto, carrega o tempo de execução e expõe as ferramentas do Neotoma ao agente.

Cada modo de falha acima recebe uma correção estrutural.

**A compactação não perde mais o estado.** As observações são apenas anexadas. O resumo compactado ainda pode servir a janela de contexto, mas as observações da fonte persistem em Neotoma com histórico completo. Nada é descartado silenciosamente.

**Entity identity is deterministic.** Hash-based canonical IDs resolve "Acme Corp" and "ACME CORP" to one entity by rule, not by per-session inference. O mesmo contato, a mesma ID, sempre.

**As gravações simultâneas são seguras.** Dois agentes que escrevem sobre a mesma entidade produzem duas observações em um armazenamento somente de acréscimos, e não um conflito de arquivo. As restrições de esquema validam cada gravação antes de entrar no armazenamento.

**A trilha de auditoria está integrada.** Cada observação rastreia sua origem. As correções criam novas observações, não sobrescrevem. Você pode reconstruir o estado a qualquer momento.

Além de consertar o teto, o plugin expõe recursos que `MEMORY.md` não pode suportar:

- **Recuperação estruturada.** "Todas as tarefas vinculadas a este contato" ou "cada transação com o fornecedor X" é uma consulta, não um arquivo grep.
- **Consultas de cronograma.** Os campos de data entre entidades produzem cronogramas. "O que aconteceu na semana passada" atinge um índice temporal, não uma pesquisa na janela de contexto.
- **Validação de esquema.** Os tipos de entidade são verificados na gravação. Dados incorretos são rejeitados antes de entrarem no armazenamento.

O loop do agente não muda. OpenClaw ainda gerencia interpretação de intenções, navegação, preenchimento de formulários e execução de habilidades. Neotoma lida com o estado. O plugin fica entre as gravações do agente e o armazenamento persistente.

## A questão geral

Os arquivos Markdown são gratuitos. Eles não custam nada para configurar, nem para manter, e a economia do cache KV os recompensa ativamente.

Neotoma adiciona sobrecarga. Validação de esquema em gravações. Armazenamento de observação. Resolução da entidade. Um processo de servidor local. Estes não são gratuitos. But the overhead is designed to stay invisible: the agent installs Neotoma, configures it, and writes to it without requiring you to learn a new tool or change how you work.

A questão é se vale a pena pagar as despesas gerais. Se o seu agente nunca precisar responder “o que eu sabia na terça-feira passada” ou “qual escrita corrompeu este registro de contato”, então não. `MEMORY.md` é a arquitetura correta.

Se o seu agente gerencia o estado contínuo, os contatos, as tarefas, as transações e os relacionamentos com fornecedores, e você precisa de consistência entre as sessões, a sobrecarga do caminho de gravação é a parte mais barata do problema. A parte cara é depurar a corrupção estatal depois do fato, quando a trilha de auditoria não existe.

## O que isso não faz

O plugin não substitui o loop de agente do OpenClaw. Isso não muda a forma como as habilidades funcionam. Não requer a migração do conteúdo `MEMORY.md` existente (embora a importação seja suportada).

Isso não resolve todos os problemas de memória do agente. A qualidade da recuperação, a engenharia imediata, o design de habilidades e a seleção do modelo ainda são importantes. Neotoma cuida da camada de estado: quais entidades existem, como estão vinculadas, de onde vieram e como mudaram. Tudo acima dessa camada permanece o mesmo.

Também não reivindica estabilidade de produção. Neotoma está em [versão do desenvolvedor](/posts/neotoma-developer-release). Mudanças significativas devem ser esperadas. O plugin existe para testar se o estado estruturado sob uma plataforma de agente real funciona na prática, e não para prometer confiabilidade hoje.

## Experimente, quebre

Tenho executado o Neotoma como camada de memória em [minha própria pilha de agente](/posts/what-my-agentic-stack-actually-does). Vários agentes escrevendo para a mesma loja: triagem de e-mail, gerenciamento de tarefas, finanças e conteúdo. Os problemas de estado multiagente descritos acima não são hipotéticos para mim. Eles são o que eu acerto toda semana.

O plugin disponibiliza isso para usuários do OpenClaw. Instale-o. Habilite-o. Execute seu agente com estado estruturado por baixo. Veja onde isso ajuda. Veja onde a sobrecarga não vale a pena. Veja onde o design quebra.

O ciclo de feedback é mais importante do que a arquitetura. Agentes reais que escrevem observações reais por meio de uma camada estruturada são onde as afirmações são válidas ou falham.

## Avaliar e instalar

A maneira mais rápida de descobrir se o Neotoma se adapta ao seu fluxo de trabalho OpenClaw é deixar seu agente avaliá-lo para você. Cole isto em sua sessão do OpenClaw:

```copiar
Leia https://neotoma.io/evaluate. Antes de responder, inspecione qualquer ferramenta, espaço de trabalho e contexto de configuração mais amplo que você possa acessar para avaliar meu fluxo de trabalho real, em vez de apenas este bate-papo. Em seguida, diga-me se o Neotoma é realmente adequado para meu fluxo de trabalho, quais dados seriam de maior valor para persistir primeiro e o que devo fazer a seguir.
```

Seu agente lê a página, verifica seu contexto local (ferramentas, configurações, arquivos de memória e espaço de trabalho) e informa se os problemas descritos nesta postagem se aplicam à sua configuração. Se o fizerem, ele orientará você na instalação, ativação com seus próprios dados e configuração do plug-in. Se não o fizerem, isso também lhe diz.

Se você já deseja o Neotoma e prefere pular [a etapa de avaliação](https://neotoma.io/evaluate), use a instalação assistida por agente em [neotoma.io/install](https://neotoma.io/install). Cole isso no OpenClaw. Seu agente lê a sequência completa de instalação inicial nessa página, instala apenas se necessário, executa a ativação com seus dados e, em seguida, configura sua ferramenta atual para uso contínuo, incluindo as etapas de integração do OpenClaw na mesma página:

```copiar
Leia https://neotoma.io/install e acompanhe-me pelo fluxo de instalação inicial do Neotoma. Instale, ative-o com meus dados e configure minha ferramenta atual para uso contínuo e robusto.
```

Se você preferir comandos manuais: `openclaw plugins install grabhub:neotoma` adiciona o plugin diretamente do ClawHub. Ou instale o pacote npm globalmente com `npm install -g neotoma` e depois `neotoma init`, com pin opcional para esta versão (`npm install -g neotoma@0.4.3`). Opções completas, configuração do MCP, Docker e comportamento de redefinição permanecem em [neotoma.io/install](https://neotoma.io/install).

Repositório: [github.com/markmhendrickson/neotoma](https://github.com/markmhendrickson/neotoma). Notas de versão: [v0.4.3](https://github.com/markmhendrickson/neotoma/releases/tag/v0.4.3).

Para conhecer o raciocínio arquitetônico mais profundo por trás da memória estruturada do agente, consulte [OpenClaw e a camada de verdade](/posts/openclaw-and-the-truth-layer) e [O teto de memória de remarcação](/posts/the-markdown-memory-ceiling).