English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

CLI commands

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é :

Exemples

bash
openclaw memory statusopenclaw memory status --deepopenclaw memory status --fixopenclaw memory index --forceopenclaw memory search "meeting notes"openclaw memory search --query "deployment" --max-results 20openclaw memory promote --limit 10 --min-score 0.75openclaw memory promote --applyopenclaw memory promote --json --min-recall-count 0 --min-unique-queries 0openclaw memory promote-explain "router vlan"openclaw memory promote-explain "router vlan" --jsonopenclaw memory rem-harnessopenclaw memory rem-harness --jsonopenclaw memory status --jsonopenclaw memory status --deep --indexopenclaw memory status --deep --index --verboseopenclaw memory status --agent mainopenclaw 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 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 pour les descriptions complètes des phases et la référence de configuration.

Associé

Was this useful?
On this page

On this page