---
read_when:
    - Vous voulez indexer ou rechercher la mémoire sémantique
    - Vous déboguez la disponibilité de la mémoire ou l’indexation
    - Vous voulez promouvoir la mémoire à court terme rappelée en `MEMORY.md`
summary: Référence CLI pour `openclaw memory` (status/index/search/promote/promote-explain/rem-harness)
title: Mémoire
x-i18n:
    generated_at: "2026-06-30T13:57:58Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 74b85d7299cc12e6133a10678f7c8fe17ee704e029993aebea417727ba94e629
    source_path: cli/memory.md
    workflow: 16
---

# `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
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
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
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
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
{
  "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)