Aller au contenu
Guides

La mémoire d’OpenClaw

Les quatre fichiers d’espace de travail qui contiennent tout ce dont un agent se souvient, ce qui va dans chacun, les trois outils de mémoire, la purge automatique avant compaction, et les importateurs qui récupèrent les notes d’autres assistants

7 min de lecture

Un agent qui oublie tout entre deux sessions est une démonstration. La réponse d’OpenClaw est volontairement sans éclat : des fichiers markdown ordinaires dans l’espace de travail, chargés au début d’une session ou cherchés à la demande. Ce choix rend la mémoire inspectable, modifiable et portable, et il fonde toutes les autres règles de cette page.

Quatre fichiers

  • Un fichier utilisateur est la couche compacte du modèle d’utilisateur : préférences stables, style de communication, relations et contexte de projets actifs, écrits comme des directives ; il se charge au début de la session avec son propre petit budget.
  • Le fichier de mémoire à long terme est la couche organisée des faits durables hors profil, des décisions permanentes et des courts résumés qui doivent être présents au début d’une session ; ce n’est ni une transcription, ni un journal quotidien, ni une archive exhaustive.
  • Les notes quotidiennes datées sont la couche de travail : observations détaillées, résumés de session et contexte brut potentiellement utile plus tard ; les notes d’aujourd’hui et d’hier se chargent automatiquement lors d’une remise à zéro simple, et les variantes nommées écrites par le crochet de mémoire de session sont prises avec le fichier daté.
  • Un journal de rêves optionnel contient les résumés de passes et les entrées de reprise historique pour lecture humaine ; si le fichier à long terme dépasse le budget d’amorçage, le fichier sur disque reste intact tandis que la copie injectée est tronquée, signal qu’il faut déplacer le détail vers les notes quotidiennes.
Le modèle ne se souvient que de ce qui est enregistré sur disque ; il n’y a aucun état caché.

Outils, recherche et moteurs

L’agent dispose de trois outils de mémoire. La recherche trouve les notes pertinentes sémantiquement même quand la formulation diffère, la lecture ouvre un fichier précis ou une plage de lignes, et un outil d’intention crée, liste et annule explicitement des intentions permanentes conditionnées par un événement, les rappels horaires restant au planificateur. Les trois viennent du plugin de mémoire actif, et quand l’indexation des sessions est activée la recherche peut aussi renvoyer des extraits de transcription dont les chemins sont des références et non des fichiers lisibles, la route documentée étant une recherche de session suivie d’un extrait d’historique borné. Avec un fournisseur d’embeddings configuré, la recherche est hybride : similarité vectorielle pour le sens et correspondance de mots-clés pour les termes exacts comme les identifiants et les symboles de code, avec un fournisseur par défaut et plusieurs autres sélectionnables. Le moteur de stockage lui-même est remplaçable, avec une base intégrée par défaut et des alternatives qui ajoutent un modèle d’utilisateur inter-sessions ou un autre magasin vectoriel.

Purge, rêve et imports

  • Avant que la compaction résume une conversation, un tour silencieux rappelle à l’agent d’enregistrer le contexte important dans les fichiers de mémoire ; il utilise une copie privée de la conversation pour que son ménage n’apparaisse jamais dans les tours suivants, ses écritures sont sauvegardées normalement, et il est sauté quand un bac à sable laisse l’espace de travail en lecture seule.
  • Le rêve est le chemin de consolidation en arrière-plan par défaut : il collecte les signaux de rappel, note les candidats et ne promeut que les éléments qualifiés issus du propriétaire ou dérivés par l’agent, gère sa propre tâche récurrente, filtre les promotions sur le score, la fréquence de rappel et la diversité des requêtes, exclut les candidats non fiables ou issus du système, et écrit des résumés de phases dans le journal pour relecture.
  • L’interface de contrôle peut importer la mémoire markdown existante d’autres assistants de code, en ne copiant que du markdown dans un dossier d’imports séparé, indexé et cherchable mais jamais fusionné dans le fichier d’amorçage, en signalant les conflits dans l’aperçu et en prenant une sauvegarde vérifiée avant tout remplacement.

L’architecture mémoire d’OpenClaw est le tableau complet derrière ces fichiers et La recherche mémoire d’OpenClaw explique la chaîne de récupération qu’ils alimentent.

Écrire des mémoires sûres à appliquer

La plupart des notes sont des faits ordinaires, mais certaines changent ce que l’agent doit faire plus tard, et celles-là demandent qu’on capture leur frontière et pas seulement leur contenu. La documentation liste les cas : exigences d’approbation ou de permission, contraintes temporaires, passages de relais vers une autre session ou personne, conditions d’expiration, moment où il est sûr d’agir, autorité de la source, et instructions d’éviter une action tentante. Une bonne note de ce type dit ce qui change le comportement futur, dans quelle condition elle s’applique, quand elle expire ou ce qui la déverrouille, ce qu’il faut éviter, et qui en est la source. La réserve est dite clairement : la mémoire peut préserver un contexte d’approbation, mais elle n’applique aucune politique, les vrais contrôles restant les approbations, le bac à sable et le travail planifié. Le rêve d’OpenClaw est la passe qui décide ce qui est promu et La compaction OpenClaw le moment que la purge protège.

Sur Diali

Sur Diali l’espace de travail qui contient ces fichiers se trouve sur un volume persistant, la mémoire survit donc aux redémarrages et aux versions au lieu de vivre dans un conteneur qui disparaît ; des instantanés quotidiens et une restauration en un clic sont disponibles grâce à l’option Sauvegardes (incluse avec Max). OpenClaw hébergé sur Diali décrit l’assistant hébergé et Les tarifs Diali les offres dans lesquelles il est livré.

  • Quatre fichiers : préférences, mémoire durable, notes du jour, journal.
  • La purge sauve le contexte avant que la compaction le résume.
  • Tout est du markdown que vous pouvez ouvrir, lire et modifier.
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.