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 des sessions) et construit sa «mémoire» à partir de zéro. Ce n'est pas du souvenir - c'est la lecture de ses notes.

Cinq raisons pour lesquelles 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 (ce qui entraîne une troncature silencieuse des premières conversations), 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 : Des informations importantes se trouvent 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 des sessions 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é : [ce que c'est, sérieusement]

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

La plupart des gens ne structurent jamais MEMORY.md. Après un mois, cela devient un énorme mur de texte que le modèle survole au lieu de lire. Les faits importants sont enterrés 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 emails

Projets en cours

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

Décisions prises

Passé 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 + email + météo)
Liste de courses hebdomadaire tous les dimanches à 18h

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

Les fichiers de mémoire grandissent indéfiniment. Après 2 mois, votre MEMORY.md contient 300 lignes et la moitié sont obsolètes ou non pertinentes. Le modèle gaspille des tokens à lire des projets terminés.

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

tous les soirs à 23h :
1. revoir les conversations de la journée
2. extraire tout nouveau fait, décision ou engagement
3. les ajouter à la section correcte dans MEMORY.md
4. supprimer tout ce qui n'est plus pertinent
5. démarrer une nouvelle session

Raison 5 : Vous confondez mémoire de session et 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 sur vous. Chargé à chaque fois. Mettez à jour lorsque votre vie change.
• MEMORY.md : Contexte en cours. Chargé à chaque fois. Grandit et est élagué.