---
read_when:
    - Вы хотите индексировать семантическую память или выполнять поиск по ней
    - Вы отлаживаете доступность памяти или индексацию
    - Вы хотите продвинуть вызванную из памяти краткосрочную память в `MEMORY.md`
summary: Справочник CLI для `openclaw memory` (status/index/search/promote/promote-explain/rem-harness)
title: Память
x-i18n:
    generated_at: "2026-06-28T22:44:08Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 553c69ccc92d398e765a33bfadb8cc9a0bf9e0f86b319fb4fcff05464ebebe7c
    source_path: cli/memory.md
    workflow: 16
---

# `openclaw memory`

Управляйте индексацией и поиском семантической памяти.
Предоставляется встроенным Plugin `memory-core`. Команда доступна, когда
`plugins.slots.memory` выбирает `memory-core` (по умолчанию); другие плагины памяти
предоставляют собственные пространства имен CLI.

Связано:

- Концепция памяти: [Память](/ru/concepts/memory)
- Вики памяти: [Вики памяти](/ru/plugins/memory-wiki)
- CLI вики: [wiki](/ru/cli/wiki)
- Plugins: [Plugins](/ru/tools/plugin)

## Примеры

```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
```

## Параметры

`memory status` и `memory index`:

- `--agent <id>`: ограничить область одним агентом. Без этого параметра эти команды выполняются для каждого настроенного агента; если список агентов не настроен, они используют агента по умолчанию.
- `--verbose`: выводить подробные журналы во время проверок и индексации.

`memory status`:

- `--deep`: проверить готовность локального векторного хранилища, готовность поставщика эмбеддингов и готовность семантического векторного поиска. Обычный `memory status` остается быстрым и не запускает живую генерацию эмбеддингов или обнаружение поставщика; неизвестное состояние векторного хранилища или семантического вектора означает, что оно не проверялось в этой команде. Лексический режим QMD `searchMode: "search"` пропускает семантические векторные проверки и обслуживание эмбеддингов даже с `--deep`.
- `--index`: запустить переиндексацию, если хранилище изменено (подразумевает `--deep`).
- `--fix`: исправить устаревшие блокировки recall и нормализовать метаданные продвижения.
- `--json`: вывести результат в JSON.

Если `memory status` показывает `Dreaming status: blocked`, управляемый cron Dreaming включен, но heartbeat, который его запускает, не срабатывает для агента по умолчанию. См. [Dreaming никогда не запускается](/ru/concepts/dreaming#dreaming-never-runs-status-shows-blocked) для двух распространенных причин.

`memory index`:

- `--force`: принудительно выполнить полную переиндексацию.

`memory search`:

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

`memory promote`:

Предварительно просматривайте и применяйте продвижения краткосрочной памяти.

```bash
openclaw memory promote [--apply] [--limit <n>] [--include-promoted]
```

- `--apply` -- записать продвижения в `MEMORY.md` (по умолчанию: только предварительный просмотр).
- `--limit <n>` -- ограничить количество показываемых кандидатов.
- `--include-promoted` -- включить записи, уже продвинутые в предыдущих циклах.

Полный список параметров:

- Ранжирует краткосрочных кандидатов из `memory/YYYY-MM-DD.md` с использованием взвешенных сигналов продвижения (`frequency`, `relevance`, `query diversity`, `recency`, `consolidation`, `conceptual richness`).
- Использует краткосрочные сигналы как из recall памяти, так и из проходов ежедневного приема данных, а также сигналы усиления фаз light/REM.
- Когда Dreaming включен, `memory-core` автоматически управляет одним заданием cron, которое выполняет полный проход (`light -> REM -> deep`) в фоне (ручной `openclaw cron add` не требуется).
- `--agent <id>`: ограничить область одним агентом (по умолчанию: агент по умолчанию).
- `--limit <n>`: максимальное количество кандидатов для возврата/применения.
- `--min-score <n>`: минимальная взвешенная оценка продвижения.
- `--min-recall-count <n>`: минимальное количество recall, требуемое для кандидата.
- `--min-unique-queries <n>`: минимальное количество различных запросов, требуемое для кандидата.
- `--apply`: добавить выбранных кандидатов в `MEMORY.md` и пометить их как продвинутые.
- `--include-promoted`: включить в вывод уже продвинутых кандидатов.
- `--json`: вывести результат в JSON.

`memory promote-explain`:

Объяснить конкретного кандидата на продвижение и разбивку его оценки.

```bash
openclaw memory promote-explain <selector> [--agent <id>] [--include-promoted] [--json]
```

- `<selector>`: ключ кандидата, фрагмент пути или фрагмент сниппета для поиска.
- `--agent <id>`: ограничить область одним агентом (по умолчанию: агент по умолчанию).
- `--include-promoted`: включить уже продвинутых кандидатов.
- `--json`: вывести результат в JSON.

`memory rem-harness`:

Предварительно просмотреть REM-рефлексии, кандидатные истины и результат глубокого продвижения без записи чего-либо.

```bash
openclaw memory rem-harness [--agent <id>] [--include-promoted] [--json]
```

- `--agent <id>`: ограничить область одним агентом (по умолчанию: агент по умолчанию).
- `--include-promoted`: включить уже продвинутых глубоких кандидатов.
- `--json`: вывести результат в JSON.

## Dreaming

Dreaming — это фоновая система консолидации памяти с тремя совместными
фазами: **light** (сортировка/подготовка краткосрочного материала), **deep** (продвижение устойчивых
фактов в `MEMORY.md`) и **REM** (рефлексия и выявление тем).

- Включите с помощью `plugins.entries.memory-core.config.dreaming.enabled: true`.
- Переключайте из чата с помощью `/dreaming on|off` (или проверяйте с помощью `/dreaming status`).
- Dreaming выполняется по одному управляемому расписанию прохода (`dreaming.frequency`) и запускает фазы по порядку: light, REM, deep.
- Только фаза deep записывает устойчивую память в `MEMORY.md`.
- Читаемый человеком вывод фаз и записи дневника записываются в `DREAMS.md` (или существующий `dreams.md`), с необязательными отчетами по фазам в `memory/dreaming/<phase>/YYYY-MM-DD.md`.
- Ранжирование использует взвешенные сигналы: частоту recall, релевантность извлечения, разнообразие запросов, временную недавность, междневную консолидацию и производное концептуальное богатство.
- Продвижение заново читает живую ежедневную заметку перед записью в `MEMORY.md`, поэтому отредактированные или удаленные краткосрочные сниппеты не продвигаются из устаревших снимков recall-хранилища.
- Запланированные и ручные запуски `memory promote` используют одни и те же значения фазы deep по умолчанию, если вы не передаете переопределения порогов CLI.
- Автоматические запуски распределяются по настроенным рабочим пространствам памяти.

Расписание по умолчанию:

- **Частота прохода**: `dreaming.frequency = 0 3 * * *`
- **Пороги deep**: `minScore=0.8`, `minRecallCount=3`, `minUniqueQueries=3`, `recencyHalfLifeDays=14`, `maxAgeDays=30`

Пример:

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

Примечания:

- `memory index --verbose` выводит сведения по фазам (поставщик, модель, источники, активность пакетов).
- `memory status` включает любые дополнительные пути, настроенные через `memorySearch.extraPaths`.
- Если фактически активные поля ключей удаленного API памяти настроены как SecretRefs, команда разрешает эти значения из активного снимка Gateway. Если Gateway недоступен, команда быстро завершается с ошибкой.
- Примечание о несовпадении версий Gateway: этот путь команды требует Gateway с поддержкой `secrets.resolve`; более старые Gateway возвращают ошибку неизвестного метода.
- Настраивайте частоту запланированного прохода с помощью `dreaming.frequency`. Политика продвижения deep в остальном является внутренней, кроме `dreaming.phases.deep.maxPromotedSnippetTokens`, который ограничивает длину продвигаемого сниппета, сохраняя видимой его provenance. Используйте флаги CLI в `memory promote`, когда нужны разовые ручные переопределения порогов.
- `memory rem-harness --path <file-or-dir> --grounded` предварительно показывает grounded `What Happened`, `Reflections` и `Possible Lasting Updates` из исторических ежедневных заметок без записи чего-либо.
- `memory rem-backfill --path <file-or-dir>` записывает обратимые grounded-записи дневника в `DREAMS.md` для просмотра в UI.
- `memory rem-backfill --path <file-or-dir> --stage-short-term` также помещает grounded устойчивых кандидатов в живое краткосрочное хранилище продвижения, чтобы обычная фаза deep могла их ранжировать.
- `memory rem-backfill --rollback` удаляет ранее записанные grounded-записи дневника, а `memory rem-backfill --rollback-short-term` удаляет ранее подготовленных grounded краткосрочных кандидатов.
- См. [Dreaming](/ru/concepts/dreaming) для полных описаний фаз и справочника по конфигурации.

## Связано

- [Справочник CLI](/ru/cli)
- [Обзор памяти](/ru/concepts/memory)