OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

CLI commands

Пам’ять

openclaw memory

Керуйте індексацією та пошуком семантичної пам’яті. Надається вбудованим Plugin memory-core. Команда доступна, коли plugins.slots.memory вибирає memory-core (типово); інші плагіни пам’яті надають власні простори імен CLI.

Пов’язане:

Приклади

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

Параметри

memory status і memory index:

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

memory status:

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

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

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).
  • Використовує короткострокові сигнали як із пригадувань пам’яті, так і з проходів щоденного приймання, плюс сигнали підсилення фаз light/REM.
  • Коли Dreaming увімкнено, memory-core автоматично керує одним cron-завданням, яке виконує повний прохід (light -> REM -> deep) у фоновому режимі (ручний openclaw cron add не потрібен).
  • --agent <id>: обмежити одним агентом (типово: типовий агент).
  • --limit <n>: максимальна кількість кандидатів для повернення/застосування.
  • --min-score <n>: мінімальний зважений бал просування.
  • --min-recall-count <n>: мінімальна кількість пригадувань, потрібна для кандидата.
  • --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). Викликачі з каналів мають бути власниками, щоб змінювати налаштування; клієнтам Gateway потрібен operator.admin. Стан лише для читання й довідка лишаються доступними авторизованим відправникам команд.
  • Dreaming працює за одним керованим розкладом проходу (dreaming.frequency) і виконує фази по черзі: light, REM, deep.
  • Лише фаза deep записує тривку пам’ять до MEMORY.md.
  • Зручний для читання людиною вихід фаз і записи щоденника записуються до DREAMS.md (або наявного dreams.md), з необов’язковими звітами для кожної фази в memory/dreaming/<phase>/YYYY-MM-DD.md.
  • Ранжування використовує зважені сигнали: частоту пригадування, релевантність отримання, різноманітність запитів, часову недавність, консолідацію між днями та похідне концептуальне багатство.
  • Просування повторно читає живу щоденну нотатку перед записом до MEMORY.md, тому відредаговані або видалені короткострокові уривки не просуваються із застарілих знімків сховища пригадувань.
  • Заплановані й ручні запуски 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 Active Memory налаштовані як SecretRefs, команда розв’язує ці значення з активного знімка Gateway. Якщо Gateway недоступний, команда швидко завершується з помилкою.
  • Примітка про розбіжність версій Gateway: цей шлях команди потребує Gateway, який підтримує secrets.resolve; старіші Gateway повертають помилку невідомого методу.
  • Налаштовуйте каденцію запланованого проходу через dreaming.frequency. Політика глибокого просування в іншому є внутрішньою, окрім dreaming.phases.deep.maxPromotedSnippetTokens, що обмежує довжину просунутого уривка, зберігаючи видимість походження. Використовуйте прапорці CLI в memory promote, коли потрібні разові ручні перевизначення порогів.
  • memory rem-harness --path <file-or-dir> --grounded попередньо переглядає обґрунтовані What Happened, Reflections і Possible Lasting Updates з історичних щоденних нотаток, нічого не записуючи.
  • memory rem-backfill --path <file-or-dir> записує оборотні обґрунтовані щоденникові записи до DREAMS.md для перегляду в UI.
  • memory rem-backfill --path <file-or-dir> --stage-short-term також засіває обґрунтованих тривких кандидатів у живе сховище короткострокового просування, щоб звичайна фаза deep могла їх ранжувати.
  • memory rem-backfill --rollback видаляє раніше записані обґрунтовані щоденникові записи, а memory rem-backfill --rollback-short-term видаляє раніше підготовлених обґрунтованих короткострокових кандидатів.
  • Див. Dreaming для повних описів фаз і довідника конфігурації.

Пов’язане

Was this useful?
On this page

On this page