OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

CLI commands

Mémoire

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

bash
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

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

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

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

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

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

bash
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
json
{  "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.

Voir aussi

Was this useful?
On this page

On this page