## Le plafond de la mémoire

Si vous exécutez OpenClaw aujourd'hui, votre agent stocke la mémoire dans `MEMORY.md` et les fichiers datés dans un répertoire `memory/`. Cela fonctionne pour une utilisation avec un seul agent et une seule session. Au moment où vous comptez sur cette mémoire pour quoi que ce soit en cours, vous atteignez un plafond. Les modes de défaillance sont spécifiques et prévisibles.

**Le compactage de la mémoire supprime les faits.** OpenClaw déclenche un tour d'agent silencieux qui écrit des « souvenirs durables » avant de tronquer le contexte. Ce qu'il y avait dans le fichier avant le compactage est inconnu. Si la version compactée a laissé tomber un fait, il a disparu. Il n'y a pas de journal d'observation. Pas de retour en arrière.

**Aucune identité d'entité entre les sessions.** « Acme Corp » dans une session et « ACME CORP » dans la suivante peuvent ou non être résolus en la même entité. L'agent réinfère à chaque fois depuis la fenêtre contextuelle. Il n'y a pas d'identifiant stable. Aucune règle de fusion.

**Écrit simultanément un état corrompu.** Si vous exécutez plusieurs agents ou plug-ins qui touchent les mêmes fichiers de mémoire, vous obtenez une corruption des données. La propre documentation d'OpenClaw le reconnaît. Le plafond du mono-agent est réel, et la plupart des flux de travail agentiques ne resteront pas éternellement mono-agent.

**Aucune piste d'audit.** Lorsque l'agent donne une mauvaise réponse, vous ne pouvez pas la remonter à une observation spécifique. On ne voit pas ce qui a changé entre mardi et jeudi. Vous ne pouvez pas répondre : « Que savait mon agent lorsqu’il a pris cette décision ? »

Ce ne sont pas des cas extrêmes. Ils apparaissent dès que l'agent gère des contacts, des tâches, des transactions ou tout autre état important au cours des sessions.

## Ce que le plugin ajoute

[Neotoma v0.4.3](https://github.com/markmhendrickson/neotoma/releases/tag/v0.4.3) ajoute un manifeste « openclaw.plugin.json », un point d'entrée et des définitions d'outils qui s'enregistrent dans le système de plugins à quatre couches d'OpenClaw. La passerelle découvre le plugin, valide le manifeste, charge le runtime et expose les outils de Neotoma à l'agent.

Chaque mode de défaillance ci-dessus reçoit un correctif structurel.

**Le compactage ne perd plus son état.** Les observations sont uniquement en annexe. Le résumé compacté peut toujours servir la fenêtre contextuelle, mais les observations sources persistent dans Neotoma avec un historique complet. Rien n’est laissé tomber en silence.

**L'identité de l'entité est déterministe.** Les identifiants canoniques basés sur le hachage résolvent « Acme Corp » et « ACME CORP » en une seule entité par règle, et non par inférence par session. Même contact, même identifiant, à chaque fois.

**Les écritures simultanées sont sûres.** Deux agents écrivant sur la même entité produisent deux observations dans un magasin en ajout uniquement, pas un conflit de fichiers. Les contraintes de schéma valident chaque écriture avant qu'elle n'entre dans le magasin.

**La piste d'audit est intégrée.** Chaque observation remonte à sa source. Les corrections créent de nouvelles observations, pas des écrasements. Vous pouvez reconstruire l'état à tout moment.

Au-delà de la réparation du plafond, le plugin expose des fonctionnalités que `MEMORY.md` ne peut pas du tout prendre en charge :

- **Récupération structurée.** "Toutes les tâches liées à ce contact" ou "chaque transaction avec le fournisseur X" est une requête, pas un fichier grep.
- **Requêtes chronologiques.** Les champs de date dans les entités produisent des chronologies. « Ce qui s'est passé la semaine dernière » atteint un index temporel, pas une recherche contextuelle.
- **Validation du schéma.** Les types d'entités sont vérifiés lors de l'écriture. Les mauvaises données sont rejetées avant d’entrer dans le magasin.

La boucle d'agent ne change pas. OpenClaw gère toujours l'interprétation des intentions, la navigation, le remplissage des formulaires et l'exécution des compétences. Neotoma gère l'état. Le plugin se situe entre les écritures de l'agent et le stockage persistant.

## La question générale

Les fichiers Markdown sont gratuits. Leur mise en place et leur maintenance ne coûtent rien, et les aspects économiques du cache KV les récompensent activement.

Neotoma ajoute des frais généraux. Validation du schéma lors des écritures. Stockage des observations. Résolution d'entité. Un processus de serveur local. Ce ne sont pas gratuits. Mais la surcharge est conçue pour rester invisible : l'agent installe Neotoma, le configure et y écrit sans que vous ayez besoin d'apprendre un nouvel outil ou de modifier votre façon de travailler.

La question est de savoir si les frais généraux valent la peine d’être payés. Si votre agent n’a jamais besoin de répondre « que savais-je mardi dernier » ou « quelle écriture a corrompu cet enregistrement de contact », alors non. `MEMORY.md` est l'architecture correcte.

Si votre agent gère l'état en cours, les contacts, les tâches, les transactions et les relations avec les fournisseurs, et que vous avez besoin de cohérence entre les sessions, la surcharge liée au chemin d'écriture constitue la partie la moins coûteuse du problème. La partie la plus coûteuse consiste à déboguer la corruption de l’État après coup, lorsque la piste d’audit n’existe pas.

## Ce que cela ne fait pas

Le plugin ne remplace pas la boucle d'agent d'OpenClaw. Cela ne change pas le fonctionnement des compétences. Il ne nécessite pas de migrer le contenu `MEMORY.md` existant (bien que l'importation soit prise en charge).

Cela ne résout pas tous les problèmes de mémoire des agents. La qualité de la récupération, l'ingénierie rapide, la conception des compétences et la sélection du modèle comptent toujours. Neotoma gère la couche d'état : quelles entités existent, comment elles sont liées, d'où elles viennent et comment elles ont changé. Tout ce qui se trouve au-dessus de cette couche reste le même.

Il ne revendique pas non plus la stabilité de la production. Neotoma est en [version développeur](/posts/neotoma-developer-release). Il faut s’attendre à des changements radicaux. Le plugin existe pour tester sous pression si l'état structuré sous une véritable plate-forme d'agent fonctionne dans la pratique, et non pour promettre la fiabilité aujourd'hui.

## Essayez-le, cassez-le

J'utilise Neotoma comme couche de mémoire dans [ma propre pile agent](/posts/what-my-agentic-stack-actually-does). Plusieurs agents écrivant dans le même magasin : tri des e-mails, gestion des tâches, finances et contenu. Les problèmes d’état multi-agents décrits ci-dessus ne sont pas hypothétiques pour moi. C’est ce que je frappe chaque semaine.

Le plugin le met à la disposition des utilisateurs d'OpenClaw. Installez-le. Activez-le. Exécutez votre agent avec un état structuré en dessous. Voyez où cela aide. Voyez où les frais généraux n’en valent pas la peine. Voyez où le design se brise.

La boucle de rétroaction compte plus que l’architecture. De vrais agents écrivant de vraies observations à travers une couche structurée sont là où les affirmations tiennent ou échouent.

## Évaluer et installer

Le moyen le plus rapide de savoir si Neotoma correspond à votre flux de travail OpenClaw est de laisser votre agent l'évaluer pour vous. Collez ceci dans votre session OpenClaw :

```copier
Lire https://neotoma.io/evaluate. Avant de répondre, inspectez tout outil, espace de travail et contexte de configuration plus large auquel vous pouvez accéder afin d'évaluer mon flux de travail réel plutôt que simplement cette discussion. Ensuite, dites-moi si Neotoma convient réellement à mon flux de travail, quelles données auraient la plus grande valeur à conserver en premier et ce que je devrais faire ensuite.
```

Votre agent lit la page, vérifie votre contexte local (outils, configurations, fichiers mémoire et espace de travail) et vous indique si les problèmes décrits dans cet article s'appliquent à votre configuration. Si tel est le cas, il vous guide tout au long de l'installation, de l'activation avec vos propres données et de la configuration du plugin. Si ce n’est pas le cas, cela vous le dit également.

Si vous voulez déjà Neotoma et préférez ignorer [l'étape d'évaluation](https://neotoma.io/evaluate), utilisez l'installation assistée par agent à partir de [neotoma.io/install](https://neotoma.io/install). Collez ceci dans OpenClaw. Votre agent lit la séquence complète d'installation en premier sur cette page, installe uniquement si nécessaire, exécute l'activation avec vos données, puis configure votre outil actuel pour une utilisation continue, y compris les étapes d'intégration d'OpenClaw sur cette même page :

```copier
Lisez https://neotoma.io/install et guidez-moi tout au long du flux d'installation de Neotoma. Installez-le, activez-le avec mes données et configurez mon outil actuel pour une utilisation continue et robuste.
```

Si vous préférez les commandes manuelles : `openclaw plugins install clawhub:neotoma` ajoute le plugin directement depuis ClawHub. Ou installez le package npm globalement avec `npm install -g neotoma` puis `neotoma init`, avec une broche facultative pour cette version (`npm install -g neotoma@0.4.3`). Les options complètes, la configuration MCP, Docker et le comportement de réinitialisation restent sur [neotoma.io/install](https://neotoma.io/install).

Dépôt : [github.com/markmhendrickson/neotoma](https://github.com/markmhendrickson/neotoma). Notes de version : [v0.4.3](https://github.com/markmhendrickson/neotoma/releases/tag/v0.4.3).

Pour le raisonnement architectural plus approfondi derrière la mémoire structurée des agents, voir [OpenClaw et la couche de vérité](/posts/openclaw-and-the-truth-layer) et [Le plafond de mémoire markdown](/posts/the-markdown-memory-ceiling).