> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Mémoire

# `openclaw memory`

Gérez l’indexation et la recherche sémantiques de la mémoire.
Fourni par le plugin groupé `memory-core`. La commande est disponible lorsque
`plugins.slots.memory` sélectionne `memory-core` (par défaut) ; les autres plugins de mémoire
exposent leurs propres espaces de noms CLI.

Associé :

* Concept de mémoire : [Mémoire](/fr/concepts/memory)
* Wiki de mémoire : [Wiki de mémoire](/fr/plugins/memory-wiki)
* CLI du wiki : [wiki](/fr/cli/wiki)
* Plugins : [Plugins](/fr/tools/plugin)

## Exemples

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw memory status
openclaw memory status --deep
openclaw memory status --fix
openclaw memory index --force
openclaw memory search "meeting notes"
openclaw memory search --query "deployment" --max-results 20
openclaw memory promote --limit 10 --min-score 0.75
openclaw memory promote --apply
openclaw memory promote --json --min-recall-count 0 --min-unique-queries 0
openclaw memory promote-explain "router vlan"
openclaw memory promote-explain "router vlan" --json
openclaw memory rem-harness
openclaw memory rem-harness --json
openclaw memory status --json
openclaw memory status --deep --index
openclaw memory status --deep --index --verbose
openclaw memory status --agent main
openclaw memory index --agent main --verbose
```

## Options

`memory status` et `memory index` :

* `--agent <id>` : limite la portée à un seul agent. Sans cette option, ces commandes s’exécutent pour chaque agent configuré ; si aucune liste d’agents n’est configurée, elles se rabattent sur l’agent par défaut.
* `--verbose` : émet des journaux détaillés pendant les sondes et l’indexation.

`memory status` :

* `--deep` : sonde la disponibilité du magasin de vecteurs local, la disponibilité du fournisseur d’embeddings et la disponibilité de la recherche vectorielle sémantique. Un simple `memory status` reste rapide et n’exécute pas d’embedding en direct ni de découverte de fournisseurs ; un état inconnu du magasin de vecteurs ou des vecteurs sémantiques signifie qu’il n’a pas été sondé dans cette commande. Le mode lexical QMD `searchMode: "search"` ignore les sondes de vecteurs sémantiques et la maintenance des embeddings, même avec `--deep`.
* `--index` : exécute une réindexation si le magasin est sale (implique `--deep`).
* `--fix` : répare les verrous de rappel obsolètes et normalise les métadonnées de promotion.
* `--json` : imprime la sortie JSON.

Si `memory status` affiche `Dreaming status: blocked`, le cron Dreaming géré est activé, mais le heartbeat qui le pilote ne se déclenche pas pour l’agent par défaut. Consultez [Dreaming ne s’exécute jamais](/fr/concepts/dreaming#dreaming-never-runs-status-shows-blocked) pour les deux causes courantes.

`memory index` :

* `--force` : force une réindexation complète.

`memory search` :

* Entrée de requête : passez soit `[query]` en positionnel, soit `--query <text>`.
* Si les deux sont fournis, `--query` l’emporte.
* Si aucun n’est fourni, la commande se termine avec une erreur.
* `--agent <id>` : limite la portée à un seul agent (par défaut : l’agent par défaut).
* `--max-results <n>` : limite le nombre de résultats renvoyés.
* `--min-score <n>` : filtre les correspondances à score faible.
* `--json` : imprime les résultats JSON.

`memory promote` :

Prévisualisez et appliquez les promotions de mémoire à court terme.

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw memory promote [--apply] [--limit <n>] [--include-promoted]
```

* `--apply` -- écrit les promotions dans `MEMORY.md` (par défaut : prévisualisation uniquement).
* `--limit <n>` -- limite le nombre de candidats affichés.
* `--include-promoted` -- inclut les entrées déjà promues lors des cycles précédents.

Options complètes :

* Classe les candidats à court terme issus de `memory/YYYY-MM-DD.md` à l’aide de signaux de promotion pondérés (`frequency`, `relevance`, `query diversity`, `recency`, `consolidation`, `conceptual richness`).
* Utilise les signaux à court terme provenant à la fois des rappels de mémoire et des passes d’ingestion quotidienne, ainsi que les signaux de renforcement des phases light/REM.
* Lorsque Dreaming est activé, `memory-core` gère automatiquement une tâche cron qui exécute un balayage complet (`light -> REM -> deep`) en arrière-plan (aucun `openclaw cron add` manuel requis).
* `--agent <id>` : limite la portée à un seul agent (par défaut : l’agent par défaut).
* `--limit <n>` : nombre maximal de candidats à renvoyer/appliquer.
* `--min-score <n>` : score de promotion pondéré minimal.
* `--min-recall-count <n>` : nombre minimal de rappels requis pour un candidat.
* `--min-unique-queries <n>` : nombre minimal de requêtes distinctes requis pour un candidat.
* `--apply` : ajoute les candidats sélectionnés à `MEMORY.md` et les marque comme promus.
* `--include-promoted` : inclut dans la sortie les candidats déjà promus.
* `--json` : imprime la sortie JSON.

`memory promote-explain` :

Explique un candidat de promotion spécifique et la répartition de son score.

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw memory promote-explain <selector> [--agent <id>] [--include-promoted] [--json]
```

* `<selector>` : clé de candidat, fragment de chemin ou fragment d’extrait à rechercher.
* `--agent <id>` : limite la portée à un seul agent (par défaut : l’agent par défaut).
* `--include-promoted` : inclut les candidats déjà promus.
* `--json` : imprime la sortie JSON.

`memory rem-harness` :

Prévisualisez les réflexions REM, les vérités candidates et la sortie de promotion deep sans rien écrire.

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw memory rem-harness [--agent <id>] [--include-promoted] [--json]
```

* `--agent <id>` : limite la portée à un seul agent (par défaut : l’agent par défaut).
* `--include-promoted` : inclut les candidats deep déjà promus.
* `--json` : imprime la sortie JSON.

## Dreaming

Dreaming est le système de consolidation de la mémoire en arrière-plan avec trois
phases coopératives : **light** (trier/préparer le matériel à court terme), **deep** (promouvoir les
faits durables dans `MEMORY.md`) et **REM** (réfléchir et faire émerger des thèmes).

* Activez avec `plugins.entries.memory-core.config.dreaming.enabled: true`.
* Basculez depuis le chat avec `/dreaming on|off` (ou inspectez avec `/dreaming status`).
  Les appelants de canal doivent être propriétaires pour modifier le réglage ; les clients Gateway ont besoin de
  `operator.admin`. Le statut en lecture seule et l’aide restent disponibles pour les
  expéditeurs de commandes autorisés.
* Dreaming s’exécute selon un calendrier de balayage géré (`dreaming.frequency`) et exécute les phases dans l’ordre : light, REM, deep.
* Seule la phase deep écrit une mémoire durable dans `MEMORY.md`.
* Les sorties de phase lisibles par l’humain et les entrées de journal sont écrites dans `DREAMS.md` (ou dans le `dreams.md` existant), avec des rapports facultatifs par phase dans `memory/dreaming/<phase>/YYYY-MM-DD.md`.
* Le classement utilise des signaux pondérés : fréquence de rappel, pertinence de récupération, diversité des requêtes, récence temporelle, consolidation inter-jours et richesse conceptuelle dérivée.
* La promotion relit la note quotidienne active avant d’écrire dans `MEMORY.md`, afin que les extraits à court terme modifiés ou supprimés ne soient pas promus depuis des instantanés obsolètes du magasin de rappels.
* Les exécutions planifiées et manuelles de `memory promote` partagent les mêmes valeurs par défaut de phase deep, sauf si vous passez des remplacements de seuils CLI.
* Les exécutions automatiques se déploient sur les espaces de travail mémoire configurés.

Planification par défaut :

* **Cadence de balayage** : `dreaming.frequency = 0 3 * * *`
* **Seuils deep** : `minScore=0.8`, `minRecallCount=3`, `minUniqueQueries=3`, `recencyHalfLifeDays=14`, `maxAgeDays=30`

Exemple :

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "plugins": {
    "entries": {
      "memory-core": {
        "config": {
          "dreaming": {
            "enabled": true
          }
        }
      }
    }
  }
}
```

Notes :

* `memory index --verbose` imprime les détails par phase (fournisseur, modèle, sources, activité de lot).
* `memory status` inclut tous les chemins supplémentaires configurés via `memorySearch.extraPaths`.
* Si des champs de clé d’API distante Active Memory effectivement actifs sont configurés comme SecretRefs, la commande résout ces valeurs à partir de l’instantané Gateway actif. Si le Gateway est indisponible, la commande échoue rapidement.
* Note sur le décalage de version du Gateway : ce chemin de commande nécessite un Gateway qui prend en charge `secrets.resolve` ; les Gateway plus anciens renvoient une erreur de méthode inconnue.
* Ajustez la cadence de balayage planifié avec `dreaming.frequency`. La politique de promotion deep est autrement interne, sauf pour `dreaming.phases.deep.maxPromotedSnippetTokens`, qui borne la longueur des extraits promus tout en gardant la provenance visible. Utilisez les indicateurs CLI sur `memory promote` lorsque vous avez besoin de remplacements ponctuels manuels des seuils.
* `memory rem-harness --path <file-or-dir> --grounded` prévisualise `What Happened`, `Reflections` et `Possible Lasting Updates` fondés à partir de notes quotidiennes historiques sans rien écrire.
* `memory rem-backfill --path <file-or-dir>` écrit des entrées de journal fondées et réversibles dans `DREAMS.md` pour examen dans l’interface utilisateur.
* `memory rem-backfill --path <file-or-dir> --stage-short-term` amorce également des candidats durables fondés dans le magasin de promotion à court terme actif afin que la phase deep normale puisse les classer.
* `memory rem-backfill --rollback` supprime les entrées de journal fondées précédemment écrites, et `memory rem-backfill --rollback-short-term` supprime les candidats à court terme fondés précédemment préparés.
* Consultez [Dreaming](/fr/concepts/dreaming) pour les descriptions complètes des phases et la référence de configuration.

## Associé

* [Référence CLI](/fr/cli)
* [Vue d’ensemble de la mémoire](/fr/concepts/memory)