Aller au contenu
Guides

Comment fonctionne la mémoire d’OpenClaw

Quatre fichiers, un index de recherche et le rêve

5 min de lecture

OpenClaw se souvient en écrivant des fichiers Markdown dans l’espace de travail de l’agent, et rien d’autre : le modèle ne connaît que ce qui a été enregistré sur le disque, et il n’existe aucun état caché. Cette seule décision de conception explique l’essentiel de ce que les gens trouvent surprenant dans sa mémoire, en bien comme en mal, et c’est le point de départ si la vôtre oublie des choses ou se répète.

Les quatre fichiers

  • USER.md, facultatif : préférences stables, style de communication et contexte des projets en cours, écrits sous forme de consignes et chargés au début d’une session avec leur propre petit budget.
  • MEMORY.md : la mémoire à long terme. Des faits et des décisions durables, sélectionnés plutôt que transcrits, chargés au début de chaque session.
  • memory/AAAA-MM-JJ.md : les notes du jour et le contexte courant. Celles d’aujourd’hui et d’hier se chargent automatiquement dans une session neuve ; les plus anciennes sont indexées pour la recherche plutôt qu’injectées.
  • DREAMS.md, facultatif : le journal des passes de consolidation en arrière-plan, conservé pour qu’un humain le relise.

Si vous voulez qu’il se souvienne de quelque chose, vous le lui demandez : dites que vous préférez TypeScript, et il écrit la note dans le bon fichier. Avec le temps, la matière utile des notes quotidiennes est distillée dans MEMORY.md par un processus d’arrière-plan que la documentation appelle le rêve, qui note les candidats et ne promeut que ceux qui passent des seuils de fréquence de rappel et de diversité. Une entrée non fiable n’entre jamais dans ce circuit de promotion.

Pourquoi il oublie, et pourquoi il se répète

MEMORY.md a un budget. Quand il dépasse la limite d’amorçage, le fichier sur le disque reste intact mais la copie injectée dans le contexte est tronquée, en silence du point de vue du modèle. La documentation y voit le signal de déplacer le détail vers les notes quotidiennes et de ne garder qu’un résumé durable en tête, ou de relever les limites et d’en payer le coût en contexte. Avant que la compaction ne résume une longue conversation, un tour silencieux rappelle à l’agent d’enregistrer ce qui compte, pour que les faits qui ne vivaient que dans la discussion survivent au résumé.

Le modèle ne se souvient que de ce qui est enregistré sur le disque ; il n’y a aucun état caché.

La recherche, et les moteurs derrière elle

Trois outils travaillent ces fichiers : l’un retrouve des notes par le sens même quand la formulation diffère, l’un lit un fichier ou une plage de lignes, et l’un enregistre des intentions durables déclenchées par des événements. La recherche est hybride quand un fournisseur d’embeddings est configuré, similarité vectorielle plus correspondance de mots-clés, avec les embeddings d’OpenAI par défaut et une longue liste d’alternatives, modèles locaux compris. Le moteur par défaut est un index SQLite intégré ; Honcho, LanceDB et une couche de connaissances façon wiki sont des extensions.

Mémoire OpenClaw et mémoire Hermes

Hermes est construit autour de la mémoire d’une façon qu’OpenClaw n’a pas : il entretient lui-même ses notes, se pousse à conserver ce qu’il apprend et cherche dans les sessions passées comme fonction de premier plan. La mémoire d’OpenClaw est honnête et inspectable, et elle repose sur des fichiers que vous pouvez lire, modifier et sauvegarder. Hermes vs OpenClaw pèse les deux.

Sur un hébergement géré

Les fichiers vivent dans le bac à sable de l’assistant, et c’est pour cela que les sauvegardes comptent : sur Diali, l’option Sauvegardes prend un instantané quotidien de l’espace de travail avec restauration en un clic, et elle est incluse dans l’offre Max. Tout ce qui précède est le même OpenClaw ; la différence, c’est que la machine qui détient les fichiers n’est pas la vôtre à perdre. OpenClaw hébergé sur Diali explique le reste.

  • La mémoire, c’est du Markdown dans l’espace de travail : lisez-le, modifiez-le, sauvegardez-le.
  • MEMORY.md est sélectionné et budgété ; les notes quotidiennes sont l’archive.
  • Le rêve consolide en arrière-plan, et la compaction écrit d’abord sur le disque.

Si le processus qui possède ces fichiers est la partie que vous n’avez jamais comprise, La passerelle OpenClaw, expliquée est l’explication.

Commencer

Arrêtez de lire, construisez le vôtre

Configurez un agent, choisissez un canal, et faites-le travailler dans l’application que vous gardez déjà ouverte.