Passer au contenu principal

​
Vue d’ensemble de la mémoire

OpenClaw se souvient des choses en écrivant des fichiers Markdown simples dans l’espace de travail de votre agent. Le modèle ne « se souvient » que de ce qui est enregistré sur le disque — il n’y a pas d’état caché.

​
Fonctionnement

Votre agent dispose de trois fichiers liés à la mémoire :
  • MEMORY.md — mémoire à long terme. Faits durables, préférences et décisions. Chargé au début de chaque session de message direct.
  • memory/YYYY-MM-DD.md — notes quotidiennes. Contexte courant et observations. Les notes d’aujourd’hui et d’hier sont chargées automatiquement.
  • DREAMS.md (expérimental, facultatif) — journal des rêves et résumés des passes de rêverie pour relecture humaine, y compris des entrées de rétrospective historique fondée.
Ces fichiers se trouvent dans l’espace de travail de l’agent (par défaut ~/.openclaw/workspace).
Si vous voulez que votre agent se souvienne de quelque chose, demandez-le-lui simplement : « Souviens-toi que je préfère TypeScript. » Il l’écrira dans le fichier approprié.

​
Outils de mémoire

L’agent dispose de deux outils pour travailler avec la mémoire :
  • memory_search — trouve les notes pertinentes à l’aide de la recherche sémantique, même lorsque la formulation diffère de l’original.
  • memory_get — lit un fichier de mémoire spécifique ou une plage de lignes.
Les deux outils sont fournis par le plugin de mémoire actif (par défaut : memory-core).

​
Plugin compagnon Memory Wiki

Si vous voulez que la mémoire durable se comporte davantage comme une base de connaissances entretenue que comme de simples notes brutes, utilisez le plugin intégré memory-wiki. memory-wiki compile les connaissances durables dans un coffre wiki avec :
  • une structure de page déterministe
  • des affirmations et preuves structurées
  • le suivi des contradictions et de la fraîcheur
  • des tableaux de bord générés
  • des synthèses compilées pour les consommateurs agent/runtime
  • des outils natifs du wiki comme wiki_search, wiki_get, wiki_apply et wiki_lint
Il ne remplace pas le plugin de mémoire actif. Le plugin de mémoire actif reste responsable du rappel, de la promotion et de la rêverie. memory-wiki ajoute à côté une couche de connaissances riche en provenance. Voir Memory Wiki.

​
Recherche dans la mémoire

Lorsqu’un fournisseur d’embeddings est configuré, memory_search utilise une recherche hybride — combinant la similarité vectorielle (sens sémantique) avec la correspondance par mots-clés (termes exacts comme les identifiants et les symboles de code). Cela fonctionne immédiatement dès que vous avez une clé API pour n’importe quel fournisseur pris en charge.
OpenClaw détecte automatiquement votre fournisseur d’embeddings à partir des clés API disponibles. Si vous avez configuré une clé OpenAI, Gemini, Voyage ou Mistral, la recherche dans la mémoire est activée automatiquement.
Pour plus de détails sur le fonctionnement de la recherche, les options de réglage et la configuration du fournisseur, voir Memory Search.

​
Backends de mémoire

Intégré (par défaut)

Basé sur SQLite. Fonctionne immédiatement avec la recherche par mots-clés, la similarité vectorielle et la recherche hybride. Aucune dépendance supplémentaire.

QMD

Sidecar local-first avec reranking, expansion de requête et capacité d’indexer des répertoires en dehors de l’espace de travail.

Honcho

Mémoire intersession native IA avec modélisation utilisateur, recherche sémantique et prise en compte de plusieurs agents. Installation par plugin.

​
Couche wiki de connaissances

Memory Wiki

Compile la mémoire durable dans un coffre wiki riche en provenance avec affirmations, tableaux de bord, mode pont et workflows compatibles avec Obsidian.

​
Flush automatique de la mémoire

Avant que la compaction résume votre conversation, OpenClaw exécute un tour silencieux qui rappelle à l’agent d’enregistrer le contexte important dans les fichiers de mémoire. Cette option est activée par défaut — vous n’avez rien à configurer.
Le flush de la mémoire évite la perte de contexte pendant la compaction. Si votre agent a dans la conversation des faits importants qui ne sont pas encore écrits dans un fichier, ils seront enregistrés automatiquement avant que le résumé n’ait lieu.

​
Rêverie (expérimental)

La rêverie est une passe de consolidation en arrière-plan facultative pour la mémoire. Elle collecte des signaux à court terme, évalue les candidats et ne promeut que les éléments qualifiés dans la mémoire à long terme (MEMORY.md). Elle est conçue pour maintenir un signal élevé dans la mémoire à long terme :
  • Option d’activation : désactivée par défaut.
  • Planifiée : lorsqu’elle est activée, memory-core gère automatiquement une tâche cron récurrente pour une passe complète de rêverie.
  • Avec seuils : les promotions doivent franchir des seuils de score, de fréquence de rappel et de diversité des requêtes.
  • Révisable : les résumés de phase et les entrées du journal sont écrits dans DREAMS.md pour relecture humaine.
Pour le comportement des phases, les signaux de score et les détails du journal des rêves, voir Dreaming (experimental).

​
Rétrospective fondée et promotion en direct

Le système de rêverie possède désormais deux voies de relecture étroitement liées :
  • La rêverie en direct fonctionne à partir du stockage de rêverie à court terme sous memory/.dreams/ et c’est ce que la phase profonde normale utilise pour décider ce qui peut être promu dans MEMORY.md.
  • La rétrospective fondée lit les notes historiques memory/YYYY-MM-DD.md comme des fichiers de jour autonomes et écrit une sortie de relecture structurée dans DREAMS.md.
La rétrospective fondée est utile lorsque vous voulez rejouer d’anciennes notes et examiner ce que le système considère comme durable sans modifier manuellement MEMORY.md. Lorsque vous utilisez : 
openclaw memory rem-backfill --path ./memory --stage-short-term
les candidats durables fondés ne sont pas promus directement. Ils sont préparés dans le même stockage de rêverie à court terme que la phase profonde normale utilise déjà. Cela signifie :
  • DREAMS.md reste la surface de relecture humaine.
  • le stockage à court terme reste la surface de classement orientée machine.
  • MEMORY.md n’est toujours écrit que par la promotion profonde.
Si vous décidez que la relecture n’était pas utile, vous pouvez supprimer les artefacts préparés sans toucher aux entrées de journal ordinaires ni à l’état normal de rappel : 
openclaw memory rem-backfill --rollback
openclaw memory rem-backfill --rollback-short-term

​
CLI

openclaw memory status          # Vérifier l'état de l'index et le fournisseur
openclaw memory search "query"  # Rechercher depuis la ligne de commande
openclaw memory index --force   # Reconstruire l'index

​
Pour aller plus loin