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

CLI commands

Пам’ять

openclaw memory

Керуйте індексацією та пошуком семантичної памʼяті. Надається активним Plugin памʼяті (типово: memory-core; задайте plugins.slots.memory = "none", щоб вимкнути).

Повʼязане:

Приклади

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: перевірити готовність локального векторного сховища, готовність провайдера embeddings і готовність семантичного векторного пошуку. Звичайний memory status залишається швидким і не виконує live embedding або виявлення провайдера; невідомий стан векторного сховища чи семантичного вектора означає, що його не перевіряли в цій команді. Лексичний QMD searchMode: "search" пропускає семантичні векторні перевірки та обслуговування embeddings навіть із --deep.
  • --index: запустити переіндексацію, якщо сховище має незбережені зміни (передбачає --deep).
  • --fix: відновити застарілі блокування recall і нормалізувати метадані просування.
  • --json: надрукувати JSON-вивід.

Якщо memory status показує Dreaming status: blocked, керований Dreaming cron увімкнено, але Heartbeat, що його запускає, не спрацьовує для типового агента. Див. Dreaming ніколи не запускається щодо двох поширених причин.

memory index:

  • --force: примусово виконати повну переіндексацію.

memory search:

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

memory promote:

Переглядайте й застосовуйте просування короткострокової памʼяті.

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 памʼяті, так і зі щоденних проходів ingestion, а також сигнали підсилення фаз light/REM.
  • Коли Dreaming увімкнено, memory-core автоматично керує одним завданням cron, яке запускає повний sweep (light -> REM -> deep) у фоновому режимі (ручний openclaw cron add не потрібен).
  • --agent <id>: обмежити одним агентом (типово: типовий агент).
  • --limit <n>: максимальна кількість кандидатів для повернення/застосування.
  • --min-score <n>: мінімальний зважений score просування.
  • --min-recall-count <n>: мінімальна кількість recall, потрібна для кандидата.
  • --min-unique-queries <n>: мінімальна кількість різних запитів, потрібна для кандидата.
  • --apply: додати вибраних кандидатів до MEMORY.md і позначити їх як просунуті.
  • --include-promoted: включити вже просунутих кандидатів у вивід.
  • --json: надрукувати JSON-вивід.

memory promote-explain:

Пояснює конкретного кандидата на просування та розподіл його score.

openclaw memory promote-explain <selector> [--agent <id>] [--include-promoted] [--json]
  • <selector>: ключ кандидата, фрагмент шляху або фрагмент snippet для пошуку.
  • --agent <id>: обмежити одним агентом (типово: типовий агент).
  • --include-promoted: включити вже просунутих кандидатів.
  • --json: надрукувати JSON-вивід.

memory rem-harness:

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

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 працює за одним керованим розкладом sweep (dreaming.frequency) і виконує фази по порядку: light, REM, deep.
  • Лише фаза deep записує стійку памʼять до MEMORY.md.
  • Людиночитний вивід фаз і записи щоденника записуються до DREAMS.md (або наявного dreams.md), з необовʼязковими звітами для кожної фази в memory/dreaming/<phase>/YYYY-MM-DD.md.
  • Ранжування використовує зважені сигнали: частоту recall, релевантність retrieval, різноманітність запитів, часову новизну, консолідацію між днями та похідне багатство концептів.
  • Перед записом до MEMORY.md просування повторно читає live щоденну нотатку, тому відредаговані або видалені короткострокові snippets не просуваються із застарілих snapshots сховища recall.
  • Заплановані й ручні запуски memory promote мають однакові типові значення фази deep, якщо ви не передаєте перевизначення порогів CLI.
  • Автоматичні запуски розгортаються на всі налаштовані робочі області памʼяті.

Типове планування:

  • Каденція sweep: dreaming.frequency = 0 3 * * *
  • Пороги deep: minScore=0.8, minRecallCount=3, minUniqueQueries=3, recencyHalfLifeDays=14, maxAgeDays=30

Приклад:

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

Примітки:

  • memory index --verbose друкує деталі для кожної фази (провайдер, модель, джерела, batch-активність).
  • memory status включає всі додаткові шляхи, налаштовані через memorySearch.extraPaths.
  • Якщо фактично активні поля remote API key памʼяті налаштовано як SecretRefs, команда розвʼязує ці значення з активного snapshot Gateway. Якщо Gateway недоступний, команда швидко завершується з помилкою.
  • Примітка щодо розбіжності версій Gateway: цей шлях команди потребує Gateway, що підтримує secrets.resolve; старіші gateways повертають помилку невідомого методу.
  • Налаштовуйте каденцію запланованого sweep через dreaming.frequency. Політика просування deep в іншому внутрішня; використовуйте прапорці 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 стійких кандидатів у live сховище короткострокового просування, щоб звичайна фаза deep могла їх ранжувати.
  • memory rem-backfill --rollback видаляє раніше записані grounded записи щоденника, а memory rem-backfill --rollback-short-term видаляє раніше підготовлених grounded короткострокових кандидатів.
  • Див. Dreaming для повних описів фаз і довідника з конфігурації.

Повʼязане