Comment fonctionne réellement la mémoire d'OpenCLAW

Les agents OpenCLAW n'ont pas de mémoire persistante entre les conversations. Chaque fois que vous envoyez un message, l'agent lit plusieurs fichiers (SOUL.md, USER.md, MEMORY.md et l'historique récent de la session) et construit sa «mémoire» à partir de zéro. Il ne se souvient pas - il lit ses notes.

Pourquoi votre agent oublie des choses

Raison 1 : Votre session est trop ancienne

Chaque message de votre session actuelle est inclus dans chaque nouvel appel API. Après 2-3 semaines, cela représente des milliers de tokens. Le modèle atteint soit sa limite de contexte (les anciennes conversations sont silencieusement tronquées), soit OpenCLAW exécute une compression qui résume tout mais perd les détails.

Solution : Utilisez /new régulièrement - au minimum quotidiennement, et avant toute tâche importante. Cela efface le tampon de conversation tout en conservant tous les fichiers intacts.

Raison 2 : Les informations importantes sont dans l'historique des discussions, pas dans les fichiers

Si vous avez dit quelque chose à votre agent dans une conversation il y a 3 semaines, cette information se trouve dans l'historique de session qui est tronqué. Tout ce que votre agent devrait TOUJOURS savoir doit être dans un fichier, pas dans le chat.

Solution : Placez les informations permanentes dans USER.md :

# À propos de moi
- Nom : [votre nom]
- Partenaire : [nom]
- Localisation : [ville]
- Emploi : [rôle]
- Fuseau horaire : [fuseau horaire]

Préférences

Communication : directe, sans fioritures
Routine matinale : briefing à 8h
Ne jamais planifier de réunions avant 10h
Commande de café : [quoi que ce soit, sérieusement]

Ce fichier est chargé à chaque session et n'est jamais tronqué ni compressé.

Raison 3 : MEMORY.md est un désordre encombré

La plupart des gens ne structurent jamais MEMORY.md, donc après un mois, il devient un énorme mur de texte que le modèle survole au lieu de lire. Les faits importants sont enfouis sous des détails non pertinents.

Solution : Structurez votre MEMORY.md en sections claires :

# Personnes
Sarah (épouse) : travaille chez [entreprise], anniversaire le 12 juin
Mike (collègue) : s'occupe du frontend, préfère Slack aux e-mails

Projets actifs

Rénovation de la cuisine : l'entrepreneur est Dave, budget 15K, commence en avril
Présentation du T2 : à rendre le 28 mars, nécessite les données de vente de Mike

Décisions prises

Changé d'opus à sonnet le 5 mars (raisons de coût)
Utilisation de l'API Brave Search au lieu de Google (niveau gratuit suffisant)

Tâches récurrentes

Briefing quotidien à 8h (calendrier + e-mail + météo)
Liste de courses hebdomadaire chaque dimanche à 18h

Une mémoire organisée est récupérée avec précision. L'agent lit mieux le texte structuré qu'un mur de paragraphes.

Raison 4 : Vous n'avez pas de routine de maintenance de la mémoire

Les fichiers mémoire grossissent indéfiniment sans nettoyage. Après 2 mois, MEMORY.md contient 300 lignes dont la moitié sont obsolètes ou non pertinentes, gaspillant des tokens sur des projets terminés.

Solution : Configurez un cron de mémoire nocturne. Ajoutez ceci aux instructions de votre agent :

chaque nuit à 23h :


revoir les conversations de la journée
extraire tout nouveau fait, décision ou engagement
les ajouter à la section appropriée dans MEMORY.md
supprimer tout ce qui n'est plus pertinent
démarrer une nouvelle session

Raison 5 : Vous confondez la mémoire de session avec la mémoire à long terme

Comprenez la hiérarchie :

• SOUL.md : Identité et personnalité. Chargé à chaque fois. Ne change jamais sauf si vous le modifiez.
• USER.md : Faits vous concernant. Chargé à chaque fois. Mettez à jour lorsque votre vie change.
• MEMORY.md : Contexte en cours. Chargé à chaque fois. Grandit et est élagué.