Skip to main content

​
openclaw memory

Управление индексированием семантической памяти, поиском и переносом в MEMORY.md. Предоставляется встроенным плагином memory-core и доступно, когда plugins.slots.memory выбирает memory-core (по умолчанию). Другие плагины памяти предоставляют собственные пространства имён CLI. См. также: концепция памяти, Dreaming, справочник по конфигурации памяти, вики памяти, вики, плагины.

​
memory status

Без --agent выполняется для каждого агента в agents.list; если список агентов не настроен, используется агент по умолчанию. Если строка Dreaming остаётся off даже с dreaming.enabled: true или запланированные проходы, по-видимому, никогда не выполняются, управляемое задание Cron для Dreaming зависит от срабатывания Heartbeat агента по умолчанию, которое запускает согласование. Подробности планирования см. в разделе Dreaming. В статусе также перечисляются дополнительные пути поиска из agents.defaults.memorySearch.extraPaths.

​
memory index

Область действия по агентам совпадает с status. --force запускает полную повторную индексацию вместо инкрементальной. --verbose выводит сведения о поставщике, модели, источниках и дополнительных путях для каждого агента перед отображением хода индексации.
  • Запрос: позиционный [query] или --query <text>. Если заданы оба, приоритет имеет --query. Если не задан ни один, команда завершается с ошибкой.
  • --agent <id>: по умолчанию используется агент по умолчанию (а не полный список агентов).
  • --max-results <n>: ограничивает количество результатов (положительное целое число).
  • --min-score <n>: исключает совпадения с оценкой ниже указанной.

​
memory promote

Ранжирует краткосрочные кандидаты из memory/YYYY-MM-DD.md и при необходимости добавляет лучшие записи в MEMORY.md.
Эти значения CLI по умолчанию отличаются от порогов глубокой фазы запланированного прохода Dreaming (см. раздел Dreaming ниже); чтобы однократный ручной запуск соответствовал поведению прохода, передайте флаги явно. Сигналы ранжирования: частота воспоминаний, релевантность извлечения, разнообразие запросов, временная актуальность, консолидация между днями и насыщенность производными концепциями, полученные как из обращений к памяти, так и из ежедневных проходов загрузки, а также небольшое усиление в лёгкой/REM-фазе за повторные обращения Dreaming. Перед записью процесс переноса повторно читает актуальную ежедневную заметку, поэтому изменения или удаления краткосрочных фрагментов после ранжирования учитываются и перенос не выполняется из устаревшего снимка.

​
memory promote-explain

Объясняет составляющие оценки одного кандидата на перенос.
<selector> сопоставляется с ключом кандидата (точно или по подстроке), путём или текстом фрагмента.

​
memory rem-harness

Предварительно показывает размышления REM, возможные факты и результат переноса глубокой фазы, ничего не записывая.
  • --path <file-or-dir>: заполняет стенд из исторических ежедневных файлов YYYY-MM-DD.md вместо текущей рабочей области.
  • --grounded: также формирует на основе исторических заметок предварительный результат What Happened / Reflections / Possible Lasting Updates.

​
memory rem-backfill

Записывает основанные на исторических данных сводки REM в DREAMS.md для проверки в пользовательском интерфейсе. Обратимо.
  • --path <file-or-dir>: обязателен, если не задан --rollback/--rollback-short-term. Исторические файлы ежедневной памяти или каталог, из которых выполняется обратное заполнение.
  • --stage-short-term: также добавляет обоснованных устойчивых кандидатов в текущее краткосрочное хранилище переноса, чтобы обычная глубокая фаза могла их ранжировать.
  • --rollback: удаляет ранее записанные обоснованные дневниковые записи из DREAMS.md.
  • --rollback-short-term: удаляет ранее подготовленных обоснованных краткосрочных кандидатов.

​
Dreaming

Dreaming — фоновая система консолидации памяти с тремя совместно работающими фазами, которые выполняются по порядку в рамках одного расписания: лёгкая (сортировка/подготовка краткосрочного материала), REM (анализ и выявление тем), глубокая (перенос устойчивых фактов в MEMORY.md). Только глубокая фаза выполняет запись в MEMORY.md.
  • Включите с помощью plugins.entries.memory-core.config.dreaming.enabled: true (по умолчанию false); memory-core автоматически управляет заданием Cron для прохода, ручная настройка openclaw cron add не требуется.
  • Переключайте из чата с помощью /dreaming on|off; проверяйте с помощью /dreaming status (или /dreaming//dreaming help). Для on/off требуется статус владельца канала или operator.admin Gateway; status и справка доступны всем, кто может вызвать команду.
  • Понятный человеку результат фаз записывается в DREAMS.md (или существующий dreams.md). По умолчанию (dreaming.storage.mode: "separate") каждая фаза также записывает отдельный отчёт в memory/dreaming/<phase>/YYYY-MM-DD.md; задайте mode: "inline", чтобы включать отчёты в файл ежедневной памяти, или "both" для обоих вариантов.
  • Запланированные и ручные запуски memory promote используют одинаковые сигналы ранжирования глубокой фазы; различаются только пороговые значения по умолчанию (см. таблицу выше и запланированные значения по умолчанию ниже).
  • Запланированные запуски распределяются по рабочим областям памяти всех настроенных агентов.
Запланированные значения по умолчанию (plugins.entries.memory-core.config.dreaming):
Полный список ключей и подробности фаз: Dreaming, справочник по конфигурации памяти.

​
Зависимость SecretRef от Gateway

Если поля ключей удалённого API Active Memory настроены как SecretRef, команды memory разрешают их из активного снимка Gateway; если Gateway недоступен, команда немедленно завершается с ошибкой. Для этого требуется Gateway, поддерживающий метод secrets.resolve; более старые версии Gateway возвращают ошибку неизвестного метода.

​
См. также