English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

CLI commands

Mémoire

openclaw memory

Gérez l’indexation et la recherche sémantiques de la mémoire. Fourni par le Plugin active memory (par défaut : memory-core ; définissez plugins.slots.memory = "none" pour le désactiver).

Connexe :

Exemples

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 l’état de préparation du magasin vectoriel local, du fournisseur d’embeddings et de la recherche vectorielle sémantique. memory status simple reste rapide et n’exécute pas de travail d’embedding en direct ni de découverte de fournisseur ; un état inconnu du magasin vectoriel ou du vecteur sémantique signifie qu’il n’a pas été sondé dans cette commande. Le mode lexical QMD searchMode: "search" ignore les sondes vectorielles 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 : affiche une 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 retournés.
  • --min-score <n> : filtre les correspondances à faible score.
  • --json : affiche les résultats JSON.

memory promote :

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

openclaw memory promote [--apply] [--limit <n>] [--include-promoted]
  • --apply -- écrit les promotions dans MEMORY.md (par défaut : prévisualisation uniquement).
  • --limit <n> -- plafonne 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 depuis 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 issus à la fois des rappels de mémoire et des passes d’ingestion quotidiennes, 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 à retourner/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 les candidats déjà promus dans la sortie.
  • --json : affiche une sortie JSON.

memory promote-explain :

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

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 : affiche une sortie JSON.

memory rem-harness :

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

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 profonds déjà promus.
  • --json : affiche une sortie JSON.

Dreaming

Dreaming est le système de consolidation de 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 les 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).
  • 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.
  • La sortie de phase lisible par l’humain et les entrées de journal sont écrites dans DREAMS.md (ou dans le fichier existant dreams.md), 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-journées 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 seuil via la CLI.
  • Les exécutions automatiques se déploient sur l’ensemble des 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 :

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

Notes :

  • memory index --verbose affiche les détails par phase (fournisseur, modèle, sources, activité par lots).
  • memory status inclut tous les chemins supplémentaires configurés via memorySearch.extraPaths.
  • Si les champs de clés d’API distantes d’active memory effectivement actives sont configurés comme SecretRefs, la commande résout ces valeurs depuis l’instantané actif du Gateway. Si le Gateway n’est pas disponible, 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 retournent une erreur de méthode inconnue.
  • Ajustez la cadence de balayage planifiée avec dreaming.frequency. La politique de promotion deep est sinon interne ; utilisez les indicateurs CLI sur memory promote lorsque vous avez besoin de remplacements manuels ponctuels.
  • memory rem-harness --path <file-or-dir> --grounded prévisualise What Happened, Reflections et Possible Lasting Updates ancrés depuis des notes quotidiennes historiques sans rien écrire.
  • memory rem-backfill --path <file-or-dir> écrit des entrées de journal ancré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 ancrés dans le magasin actif de promotion à court terme afin que la phase deep normale puisse les classer.
  • memory rem-backfill --rollback supprime les entrées de journal ancrées précédemment écrites, et memory rem-backfill --rollback-short-term supprime les candidats à court terme ancrés précédemment préparés.
  • Consultez Dreaming pour les descriptions complètes des phases et la référence de configuration.

Connexe