`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, Dreaming, référence de configuration de la mémoire, wiki de la mémoire, wiki, plugins.

`memory status`

openclaw memory status [--agent <id>] [--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 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`

openclaw memory index [--agent <id>] [--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`

openclaw memory search [query] [--query <text>] [--agent <id>] [--max-results <n>] [--min-score <n>] [--json]

Requête : argument positionnel [query] ou --query <text>. Si les deux sont définis, --query prévaut. Si aucun n’est défini, la commande renvoie une erreur.
--agent <id> : utilise par défaut l’agent par défaut (et non la liste complète des agents).
--max-results <n> : limite le nombre de résultats (entier positif).
--min-score <n> : 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.

openclaw memory promote [--agent <id>] [--limit <n>] [--min-score <n>] \
  [--min-recall-count <n>] [--min-unique-queries <n>] [--apply] [--include-promoted] [--json]

Option	Valeur par défaut	Effet
`--limit <n>`		Nombre maximal de candidats à renvoyer/appliquer.
`--min-score <n>`	`0.75`	Score pondéré minimal de promotion.
`--min-recall-count <n>`	`3`	Nombre minimal de rappels requis.
`--min-unique-queries <n>`	`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 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.

openclaw memory promote-explain <selector> [--agent <id>] [--include-promoted] [--json]

<selector> 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.

openclaw memory rem-harness [--agent <id>] [--path <file-or-dir>] [--grounded] [--include-promoted] [--json]

--path <file-or-dir> : 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.

openclaw memory rem-backfill --path <file-or-dir> [--agent <id>] [--stage-short-term] [--json]
openclaw memory rem-backfill --rollback [--rollback-short-term] [--json]

--path <file-or-dir> : 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/<phase>/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`

{
  "plugins": {
    "entries": {
      "memory-core": {
        "config": {
          "dreaming": {
            "enabled": true
          }
        }
      }
    }
  }
}

Liste complète des clés et détails des phases : Dreaming, référence de configuration de la mémoire.

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.

CLI commands

RPC and API

Codex harness

Plugin reference

Plugin SDK reference

Plugin maintainer reference

Templates

Technical reference

Concept internals

Project

Contributing

Mémoire

`openclaw memory`

`memory status`

`memory index`

`memory search`

`memory promote`

`memory promote-explain`

`memory rem-harness`

`memory rem-backfill`

Dreaming

Dépendance au Gateway pour SecretRef

Voir aussi

​openclaw memory

​memory status

​memory index

​memory search

​memory promote

​memory promote-explain

​memory rem-harness

​memory rem-backfill

​Dreaming

​Dépendance au Gateway pour SecretRef

​Voir aussi

`openclaw memory`

`memory status`

`memory index`

`memory search`

`memory promote`

`memory promote-explain`

`memory rem-harness`

`memory rem-backfill`

Dreaming

Dépendance au Gateway pour SecretRef

Voir aussi