--- read_when: - Vous souhaitez indexer ou rechercher la mémoire sémantique - Vous diagnostiquez la disponibilité ou l’indexation de la mémoire - Vous souhaitez promouvoir la mémoire à court terme rappelée vers `MEMORY.md` summary: Référence de la CLI pour `openclaw memory` (statut/indexation/recherche/promotion/explication de la promotion/harnais rem/remplissage rétroactif rem) title: Mémoire x-i18n: generated_at: "2026-07-12T02:43:14Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: f0002c48044455520f32a5a3e111415a746fbafba2a27a655ded90abdc94623b source_path: cli/memory.md workflow: 16 --- # `openclaw memory` Gérez l’indexation et la recherche de la mémoire sémantique, ainsi que sa promotion vers `MEMORY.md`. Cette commande est fournie par le plugin intégré `memory-core` et disponible lorsque `plugins.slots.memory` sélectionne `memory-core` (valeur par défaut). Les autres plugins de mémoire exposent leurs propres espaces de noms CLI. Voir aussi : concept de [mémoire](/fr/concepts/memory), [Dreaming](/fr/concepts/dreaming), [référence de configuration de la mémoire](/fr/reference/memory-config), [wiki de la mémoire](/fr/plugins/memory-wiki), [wiki](/fr/cli/wiki), [plugins](/fr/tools/plugin). ## `memory status` ```bash openclaw memory status [--agent ] [--deep] [--index] [--fix] [--json] [--verbose] ``` Sans `--agent`, la commande s’exécute pour chaque agent de `agents.list` ; si aucune liste d’agents n’est configurée, elle utilise l’agent par défaut. | Option | Effet | | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--deep` | Vérifie l’état de préparation du magasin vectoriel, du fournisseur d’embeddings et de la recherche sémantique (ce qui implique des appels supplémentaires au fournisseur). La commande simple `memory status` reste rapide et ignore cette vérification ; un état vectoriel ou sémantique inconnu signifie qu’il n’a pas été vérifié. Le mode de recherche lexicale QMD `searchMode: "search"` ignore toujours les vérifications vectorielles sémantiques, même avec `--deep`. | | `--index` | Réindexe si le magasin contient des modifications non indexées. Implique `--deep`. | | `--fix` | Répare les verrous de rappel obsolètes et normalise les métadonnées de promotion. | | `--json` | Affiche du JSON. | | `--verbose` | Émet des journaux détaillés pour chaque phase. | Si la ligne `Dreaming` reste sur `off` même avec `dreaming.enabled: true`, ou si les balayages planifiés ne semblent jamais s’exécuter, le Cron de Dreaming géré dépend du déclenchement du Heartbeat de l’agent par défaut pour lancer la réconciliation. Consultez [Dreaming](/fr/concepts/dreaming) pour plus de détails sur la planification. L’état répertorie également tous les chemins de recherche supplémentaires provenant de `agents.defaults.memorySearch.extraPaths`. ## `memory index` ```bash openclaw memory index [--agent ] [--force] [--verbose] ``` Même portée par agent que `status`. `--force` exécute une réindexation complète au lieu d’une réindexation incrémentielle. `--verbose` affiche le fournisseur, le modèle, les sources et les détails des chemins supplémentaires de chaque agent avant d’afficher la progression de l’indexation. ## `memory search` ```bash openclaw memory search [query] [--query ] [--agent ] [--max-results ] [--min-score ] [--json] ``` - Requête : argument positionnel `[query]` ou `--query `. Si les deux sont définis, `--query` prévaut. Si aucun n’est défini, la commande renvoie une erreur. - `--agent ` : utilise par défaut l’agent par défaut (et non la liste complète des agents). - `--max-results ` : limite le nombre de résultats (entier positif). - `--min-score ` : exclut les correspondances dont le score est inférieur à cette valeur. ## `memory promote` Classe les candidats à court terme provenant de `memory/YYYY-MM-DD.md` et ajoute éventuellement les meilleures entrées à `MEMORY.md`. ```bash openclaw memory promote [--agent ] [--limit ] [--min-score ] \ [--min-recall-count ] [--min-unique-queries ] [--apply] [--include-promoted] [--json] ``` | Option | Valeur par défaut | Effet | | -------------------------- | ------------------------- | -------------------------------------------------------------------------------- | | `--limit ` | | Nombre maximal de candidats à renvoyer/appliquer. | | `--min-score ` | `0.75` | Score pondéré minimal de promotion. | | `--min-recall-count ` | `3` | Nombre minimal de rappels requis. | | `--min-unique-queries ` | `2` | Nombre minimal de requêtes distinctes requis. | | `--apply` | aperçu uniquement | Ajoute les candidats sélectionnés à `MEMORY.md` et les marque comme promus. | | `--include-promoted` | | Inclut les candidats déjà promus lors de cycles précédents. | | `--json` | | Affiche du JSON. | Ces valeurs par défaut de la CLI diffèrent des seuils de la phase profonde du balayage Dreaming planifié (voir [Dreaming](#dreaming) ci-dessous) ; transmettez explicitement les options pour reproduire le comportement du balayage lors d’une exécution manuelle ponctuelle. Signaux de classement : fréquence de rappel, pertinence de la récupération, diversité des requêtes, récence temporelle, consolidation entre plusieurs jours et richesse conceptuelle dérivée, issus à la fois des rappels de mémoire et des passes d’ingestion quotidiennes, auxquels s’ajoute un léger renforcement des phases légère/REM lors de revisites répétées par Dreaming. Avant l’écriture, la promotion relit la note quotidienne active ; les modifications ou suppressions d’extraits à court terme effectuées depuis le classement sont donc respectées au lieu d’effectuer la promotion à partir d’un instantané obsolète. ## `memory promote-explain` Explique la décomposition du score d’un candidat à la promotion. ```bash openclaw memory promote-explain [--agent ] [--include-promoted] [--json] ``` `` correspond à la clé d’un candidat (exactement ou en tant que sous-chaîne), à son chemin ou au texte de son extrait. ## `memory rem-harness` Prévisualise les réflexions REM, les vérités candidates et la sortie de promotion de la phase profonde sans rien écrire. ```bash openclaw memory rem-harness [--agent ] [--path ] [--grounded] [--include-promoted] [--json] ``` - `--path ` : initialise le banc d’essai à partir de fichiers quotidiens historiques `YYYY-MM-DD.md` au lieu de l’espace de travail actif. - `--grounded` : affiche également un aperçu ancré `What Happened` / `Reflections` / `Possible Lasting Updates` à partir des notes historiques. ## `memory rem-backfill` Écrit des résumés REM historiques ancrés dans `DREAMS.md` pour examen dans l’interface utilisateur. Opération réversible. ```bash openclaw memory rem-backfill --path [--agent ] [--stage-short-term] [--json] openclaw memory rem-backfill --rollback [--rollback-short-term] [--json] ``` - `--path ` : requis sauf si `--rollback`/`--rollback-short-term` est défini. Fichier(s) de mémoire quotidienne historique ou répertoire à partir duquel effectuer le remplissage rétroactif. - `--stage-short-term` : injecte également des candidats durables ancrés dans le magasin de promotion à court terme actif afin que la phase profonde normale puisse les classer. - `--rollback` : supprime de `DREAMS.md` les entrées de journal ancrées précédemment écrites. - `--rollback-short-term` : supprime les candidats ancrés à court terme précédemment préparés. ## Dreaming Dreaming est le système de consolidation de la mémoire en arrière-plan, composé de trois phases coopératives exécutées dans l’ordre selon une même planification : **légère** (trier/préparer les éléments à court terme), **REM** (réfléchir et faire ressortir les thèmes), **profonde** (promouvoir les faits durables dans `MEMORY.md`). Seule la phase profonde écrit dans `MEMORY.md`. - Activez-le avec `plugins.entries.memory-core.config.dreaming.enabled: true` (valeur par défaut : `false`) ; `memory-core` gère automatiquement la tâche Cron de balayage, sans nécessiter de commande manuelle `openclaw cron add`. - Activez ou désactivez la fonctionnalité depuis la conversation avec `/dreaming on|off` ; consultez son état avec `/dreaming status` (ou `/dreaming`/`/dreaming help`). `on`/`off` nécessite le statut de propriétaire du canal ou le rôle `operator.admin` du Gateway ; l’état et l’aide restent accessibles à toute personne pouvant invoquer la commande. - La sortie lisible par l’utilisateur de chaque phase est écrite dans `DREAMS.md` (ou dans un fichier `dreams.md` existant). Par défaut (`dreaming.storage.mode: "separate"`), chaque phase écrit également un rapport autonome dans `memory/dreaming//YYYY-MM-DD.md` ; définissez `mode: "inline"` pour intégrer les rapports au fichier de mémoire quotidien, ou `"both"` pour utiliser les deux modes. - Les exécutions planifiées et manuelles de `memory promote` partagent les mêmes signaux de classement de la phase profonde ; seuls les seuils par défaut diffèrent (voir le tableau ci-dessus et les valeurs planifiées par défaut ci-dessous). - Les exécutions planifiées sont distribuées sur l’espace de travail mémoire de chaque agent configuré. Valeurs planifiées par défaut (`plugins.entries.memory-core.config.dreaming`) : | Clé | Valeur par défaut | | -------------------------------------- | ----------------- | | `frequency` | `0 3 * * *` | | `phases.deep.minScore` | `0.8` | | `phases.deep.minRecallCount` | `3` | | `phases.deep.minUniqueQueries` | `3` | | `phases.deep.recencyHalfLifeDays` | `14` | | `phases.deep.maxAgeDays` | `30` | | `phases.deep.maxPromotedSnippetTokens` | `160` | ```json { "plugins": { "entries": { "memory-core": { "config": { "dreaming": { "enabled": true } } } } } } ``` Liste complète des clés et détails des phases : [Dreaming](/fr/concepts/dreaming), [référence de configuration de la mémoire](/fr/reference/memory-config#dreaming). ## Dépendance au Gateway pour SecretRef Si les champs de clé d’API distante de la mémoire active sont configurés en tant que SecretRefs, les commandes `memory` les résolvent depuis l’instantané actif du Gateway ; si le Gateway est indisponible, la commande échoue immédiatement. Cela nécessite un Gateway prenant en charge la méthode `secrets.resolve` ; les anciens Gateways renvoient une erreur de méthode inconnue. ## Voir aussi - [Référence de la CLI](/fr/cli) - [Présentation de la mémoire](/fr/concepts/memory)