## El sostre de la memòria

Si executeu OpenClaw avui, el vostre agent emmagatzema memòria a `MEMORY.md` i fitxers datats en un directori `memory/`. Això funciona per a ús d'un agent únic i d'una sola sessió. En el moment que confieu en aquest record per a qualsevol cosa en curs, toqueu un sostre. Els modes de fallada són específics i previsibles.

**La compactació de la memòria deixa caure fets.** OpenClaw activa un gir d'agent silenciós que escriu "memòries duradores" abans de truncar el context. Es desconeix què hi havia al fitxer abans de la compactació. Si la versió compactada va deixar caure un fet, desapareixerà. No hi ha registre d'observació. Cap retrocés.

**No hi ha identitat d'entitat entre les sessions.** "Acme Corp" en una sessió i "ACME CORP" a la següent es poden resoldre o no amb la mateixa entitat. L'agent torna a inferir cada cop des de la finestra de context. No hi ha identificacions estables. No hi ha regles de fusió.

**Estat corrupte d'escriptures concurrents.** Si executeu diversos agents o connectors que toquen els mateixos fitxers de memòria, les dades es corrompeixen. La pròpia documentació d'OpenClaw ho reconeix. El sostre d'agent únic és real i la majoria dels fluxos de treball d'agent no es mantindran per sempre com a agent únic.

**No hi ha cap pista d'auditoria.** Quan l'agent dóna una resposta incorrecta, no podeu remuntar-la a una observació específica. No podeu veure què ha canviat entre dimarts i dijous. No podeu respondre "què sabia el meu agent quan va prendre aquesta decisió?"

Aquests no són casos extrems. Apareixen tan bon punt l'agent gestiona contactes, tasques, transaccions o qualsevol estat important en les sessions.

## Què afegeix el connector

[Neotoma v0.4.3](https://github.com/markmhendrickson/neotoma/releases/tag/v0.4.3) afegeix un manifest "openclaw.plugin.json", un punt d'entrada i definicions d'eines que es registren al sistema de connectors de quatre capes d'OpenClaw. La passarel·la descobreix el connector, valida el manifest, carrega el temps d'execució i exposa les eines de Neotoma a l'agent.

Cada mode de fallada anterior rep una solució estructural.

**La compactació ja no perd estat.** Les observacions només es poden afegir. El resum compactat encara pot servir per a la finestra de context, però les observacions font persisteixen a Neotoma amb tota la història. No es deixa caure res en silenci.

**La identitat de l'entitat és determinista.** Els identificadors canònics basats en hash resolen "Acme Corp" i "ACME CORP" a una entitat per regla, no per inferència per sessió. El mateix contacte, el mateix DNI, cada vegada.

**Les escriptures concurrents són segures.** Dos agents que escriuen sobre la mateixa entitat produeixen dues observacions en un magatzem només per adjuntar, no un conflicte de fitxers. Les restriccions d'esquema validen cada escriptura abans que entri a la botiga.

**La pista d'auditoria està integrada.** Cada observació recorre a la seva font. Les correccions creen noves observacions, no sobreescritures. Podeu reconstruir l'estat en qualsevol moment.

Més enllà d'arreglar el sostre, el connector exposa capacitats que `MEMORY.md` no pot suportar en absolut:

- **Recuperació estructurada.** "Totes les tasques vinculades a aquest contacte" o "cada transacció amb el proveïdor X" és una consulta, no un fitxer grep.
- **Consultes de cronologia.** Els camps de data de les entitats produeixen línies de temps. "El que va passar la setmana passada" arriba a un índex temporal, no a una cerca de finestra de context.
- **Validació d'esquema.** Els tipus d'entitats es comproven en escriptura. Les dades incorrectes es rebutgen abans d'entrar a la botiga.

El bucle d'agent no canvia. OpenClaw encara gestiona la interpretació d'intencions, la navegació, l'emplenament de formularis i l'execució d'habilitats. Neotoma maneja l'estat. El connector es troba entre les escriptures de l'agent i l'emmagatzematge persistent.

## La pregunta general

Els fitxers Markdown són gratuïts. No costen res de configurar, res de mantenir, i l'economia de la memòria cau de KV els recompensa activament.

Neotoma afegeix la sobrecàrrega. Validació d'esquemes en escriptures. Emmagatzematge d'observació. Resolució de l'entitat. Un procés de servidor local. Aquests no són gratuïts. Però la sobrecàrrega està dissenyada per mantenir-se invisible: l'agent instal·la Neotoma, el configura i hi escriu sense que calgui que aprenguis una eina nova o que canviïs la teva manera de treballar.

La pregunta és si val la pena pagar les despeses generals. Si el vostre agent no ha de respondre mai "què sabia dimarts passat" o "quina escriptura va corrompre aquest registre de contacte", no. `MEMORY.md` és l'arquitectura correcta.

Si el vostre agent gestiona l'estat, els contactes, les tasques, les transaccions i les relacions de proveïdors en curs, i necessiteu coherència entre les sessions, la sobrecàrrega del camí d'escriptura és la part més barata del problema. La part cara és depurar la corrupció de l'estat després del fet, quan la pista d'auditoria no existeix.

## Què no fa això

El connector no substitueix el bucle d'agent d'OpenClaw. No canvia com funcionen les habilitats. No requereix migrar el contingut `MEMORY.md` existent (tot i que s'admet la importació).

No resol tots els problemes de memòria de l'agent. La qualitat de la recuperació, l'enginyeria ràpida, el disseny d'habilitats i la selecció de models encara són importants. Neotoma gestiona la capa d'estat: quines entitats existeixen, com estan enllaçades, d'on provenen i com han canviat. Tot per sobre d'aquesta capa es manté igual.

Tampoc reclama l'estabilitat de la producció. Neotoma es troba a [version de desenvolupador](/posts/neotoma-developer-release). S'han d'esperar canvis de ruptura. El connector existeix per provar la pressió de si l'estat estructurat sota una plataforma d'agent real funciona a la pràctica, no per prometre fiabilitat avui.

## Prova-ho, trenca-ho

He estat executant Neotoma com a capa de memòria a [la meva pròpia pila agentic](/posts/what-my-agentic-stack-actually-does). Diversos agents escriuen a la mateixa botiga: triatge de correu electrònic, gestió de tasques, finances i contingut. Els problemes d'estat multiagent descrits anteriorment no són hipotètics per a mi. Són els que toc cada setmana.

El connector ho posa a disposició dels usuaris d'OpenClaw. Instal·leu-lo. Activa-ho. Executeu el vostre agent amb un estat estructurat a sota. Mira on ajuda. Mireu on no val la pena la sobrecàrrega. Veure on es trenca el disseny.

El bucle de retroalimentació importa més que l'arquitectura. Els agents reals que escriuen observacions reals a través d'una capa estructurada és on les afirmacions es mantenen o fracassen.

## Avaluar i instal·lar

La manera més ràpida d'esbrinar si Neotoma s'adapta al vostre flux de treball OpenClaw és deixar que el vostre agent l'avaluï per vosaltres. Enganxeu això a la vostra sessió d'OpenClaw:

```copiar
Llegiu https://neotoma.io/evaluate. Abans de respondre, inspeccioneu qualsevol eina, espai de treball i context de configuració més amplis als quals pugueu accedir per avaluar el meu flux de treball real en lloc d'aquest xat. Aleshores, digueu-me si Neotoma s'adapta realment al meu flux de treball, quines dades tindrien el valor més alt per persistir primer i què hauria de fer a continuació.
```

El vostre agent llegeix la pàgina, comprova el vostre context local (eines, configuracions, fitxers de memòria i espai de treball) i us indica si els problemes descrits en aquesta publicació s'apliquen a la vostra configuració. Si ho fan, us guiarà per la instal·lació, l'activació amb les vostres pròpies dades i la configuració del connector. Si no ho fan, també t'ho diu.

Si ja voleu Neotoma i preferiu ometre [el pas d'avaluació](https://neotoma.io/evaluate), utilitzeu la instal·lació assistida per l'agent des de [neotoma.io/install](https://neotoma.io/install). Enganxeu-ho a OpenClaw. El vostre agent llegeix la seqüència completa de la primera instal·lació d'aquesta pàgina, s'instal·la només si cal, executa l'activació amb les vostres dades i, a continuació, configura la vostra eina actual per a l'ús continu, inclosos els passos d'integració d'OpenClaw a la mateixa pàgina:

```copiar
Llegiu https://neotoma.io/install i feu-me arribar el flux d'instal·lació primer Neotoma. Instal·leu-lo, activeu-lo amb les meves dades i configureu la meva eina actual per a un ús constant i sòlid.
```

Si preferiu les ordres manuals: `openclaw plugins install clawhub:neotoma` afegeix el connector directament des de ClawHub. O instal·leu el paquet npm globalment amb `npm install -g neotoma` i després `neotoma init`, amb un pin opcional a aquesta versió (`npm install -g neotoma@0.4.3`). Les opcions completes, la configuració MCP, Docker i el comportament de restabliment es mantenen a [neotoma.io/install](https://neotoma.io/install).

Repositori: [github.com/markmhendrickson/neotoma](https://github.com/markmhendrickson/neotoma). Notes de la versió: [v0.4.3](https://github.com/markmhendrickson/neotoma/releases/tag/v0.4.3).

Per obtenir un raonament arquitectònic més profund darrere de la memòria d'agent estructurat, vegeu [OpenClaw i la capa de veritat](/posts/openclaw-and-the-truth-layer) i [The markdown memory ceiling](/posts/the-markdown-memory-ceiling).