​

Активна пам’ять

​

Вставте це у свого агента

{
  plugins: {
    entries: {
      "active-memory": {
        enabled: true,
        config: {
          enabled: true,
          agents: ["main"],
          allowedChatTypes: ["direct"],
          modelFallbackPolicy: "default-remote",
          queryMode: "recent",
          promptStyle: "balanced",
          timeoutMs: 15000,
          maxSummaryChars: 220,
          persistTranscripts: false,
          logging: true,
        },
      },
    },
  },
}

node scripts/run-node.mjs gateway --profile dev

/verbose on

​

Увімкнення активної пам’яті

1. увімкнути плагін
2. націлити його на одного розмовного агента
3. залишити журналювання ввімкненим лише на час налаштування

{
  plugins: {
    entries: {
      "active-memory": {
        enabled: true,
        config: {
          agents: ["main"],
          allowedChatTypes: ["direct"],
          modelFallbackPolicy: "default-remote",
          queryMode: "recent",
          promptStyle: "balanced",
          timeoutMs: 15000,
          maxSummaryChars: 220,
          persistTranscripts: false,
          logging: true,
        },
      },
    },
  },
}

node scripts/run-node.mjs gateway --profile dev

• plugins.entries.active-memory.enabled: true вмикає плагін
• config.agents: ["main"] підключає до активної пам’яті лише агента main
• config.allowedChatTypes: ["direct"] за замовчуванням залишає активну пам’ять увімкненою лише для сеансів у стилі прямих повідомлень
• якщо config.model не задано, активна пам’ять спочатку успадковує поточну модель сеансу
• config.modelFallbackPolicy: "default-remote" зберігає вбудований віддалений резервний варіант за замовчуванням, якщо явна або успадкована модель недоступна
• config.promptStyle: "balanced" використовує типовий універсальний стиль запиту для режиму recent
• активна пам’ять однаково запускається лише в придатних інтерактивних постійних чат-сеансах

​

Як це побачити

​

Перемикач сеансу

/active-memory status
/active-memory off
/active-memory on

/active-memory status --global
/active-memory off --global
/active-memory on --global

/verbose on

• рядок стану активної пам’яті, наприклад Active Memory: ok 842ms recent 34 chars
• зрозумілий налагоджувальний підсумок, наприклад Active Memory Debug: Lemon pepper wings with blue cheese.

/verbose on
які крильця мені замовити?

...звичайна відповідь помічника...

🧩 Active Memory: ok 842ms recent 34 chars
🔎 Active Memory Debug: Lemon pepper wings with blue cheese.

​

Коли вона запускається

1. Явне ввімкнення в конфігурації Плагін має бути ввімкнений, а поточний ідентифікатор агента має бути присутній у plugins.entries.active-memory.config.agents.
2. Сувора придатність під час виконання Навіть коли активна пам’ять увімкнена й націлена, вона запускається лише для придатних інтерактивних постійних чат-сеансів.

плагін увімкнено
+
ідентифікатор агента націлено
+
дозволений тип чату
+
придатний інтерактивний постійний чат-сеанс
=
активна пам’ять запускається

​

Типи сеансів

allowedChatTypes: ["direct"]

allowedChatTypes: ["direct"]

allowedChatTypes: ["direct", "group"]

allowedChatTypes: ["direct", "group", "channel"]

​

Де вона запускається

​

Навіщо її використовувати

• сеанс є постійним і орієнтованим на користувача
• агент має змістовну довгострокову пам’ять для пошуку
• безперервність і персоналізація важливіші за чистий детермінізм запиту

• стабільних уподобань
• повторюваних звичок
• довгострокового контексту користувача, який має природно з’являтися

• автоматизації
• внутрішніх робітників
• одноразових API-завдань
• місць, де прихована персоналізація була б неочікуваною

​

Як це працює

• memory_search
• memory_get

​

Режими запиту

​

Стилі запиту

• balanced: універсальне значення за замовчуванням для режиму recent
• strict: найменш охочий; найкраще, коли ви хочете мінімального проникнення з навколишнього контексту
• contextual: найсприятливіший для безперервності; найкраще, коли історія розмови має більше значення
• recall-heavy: охочіше показує пам’ять за слабших, але все ще правдоподібних збігів
• precision-heavy: агресивно віддає перевагу NONE, якщо збіг не є очевидним
• preference-only: оптимізований для обраного, звичок, рутин, смаків і повторюваних особистих фактів

message -> strict
recent -> balanced
full -> contextual

promptStyle: "preference-only"

​

Політика резервного вибору моделі

явна модель плагіна
-> поточна модель сеансу
-> основна модель агента
-> необов’язковий вбудований віддалений резервний варіант

modelFallbackPolicy: "default-remote"

modelFallbackPolicy: "resolved-only"

​

Розширені варіанти обходу

thinking: "medium"

thinking: "off"

promptAppend: "Надавайте перевагу стабільним довгостроковим уподобанням над одноразовими подіями."

promptOverride: "Ви агент пошуку в пам’яті. Поверніть NONE або один компактний факт про користувача."

​

message

Лише останнє повідомлення користувача

• вам потрібна найвища швидкість роботи
• вам потрібен найсильніший ухил у бік пригадування стабільних уподобань
• наступні ходи не потребують розмовного контексту

• починайте приблизно з 3000 до 5000 мс

​

recent

Хвіст нещодавньої розмови:
user: ...
assistant: ...
user: ...

Останнє повідомлення користувача:
...

• вам потрібен кращий баланс між швидкістю та прив’язкою до розмови
• подальші запитання часто залежать від кількох останніх ходів

• починайте приблизно з 15000 мс

​

full

Повний контекст розмови:
user: ...
assistant: ...
user: ...
...

• найвища якість пригадування важливіша за затримку
• розмова містить важливу підготовчу інформацію далеко вище по гілці

• суттєво збільшуйте його порівняно з message або recent
• починайте приблизно з 15000 мс або вище залежно від розміру гілки

message < recent < full

​

Збереження стенограм

• вона записується до тимчасового каталогу
• вона використовується лише для запуску підлеглого агента блокувальної пам’яті
• вона видаляється одразу після завершення запуску

{
  plugins: {
    entries: {
      "active-memory": {
        enabled: true,
        config: {
          agents: ["main"],
          persistTranscripts: true,
          transcriptDir: "active-memory",
        },
      },
    },
  },
}

agents/<agent>/sessions/active-memory/<blocking-memory-sub-agent-session-id>.jsonl

• стенограми підлеглого агента блокувальної пам’яті можуть швидко накопичуватися в активних сеансах
• режим запиту full може дублювати велику частину контексту розмови
• ці стенограми містять прихований контекст запиту та пригадані спогади

​

Конфігурація

plugins.entries.active-memory

​

Рекомендоване налаштування

{
  plugins: {
    entries: {
      "active-memory": {
        enabled: true,
        config: {
          agents: ["main"],
          queryMode: "recent",
          promptStyle: "balanced",
          timeoutMs: 15000,
          maxSummaryChars: 220,
          logging: true,
        },
      },
    },
  },
}

• message, якщо вам потрібна менша затримка
• full, якщо ви вирішите, що додатковий контекст вартий повільнішого підлеглого агента блокувальної пам’яті

​

Налагодження

1. Переконайтеся, що плагін увімкнено в plugins.entries.active-memory.enabled.
2. Переконайтеся, що поточний ідентифікатор агента вказано в config.agents.
3. Переконайтеся, що ви тестуєте через інтерактивний постійний чат-сеанс.
4. Увімкніть config.logging: true і перегляньте журнали gateway.
5. Перевірте, що сам пошук у пам’яті працює, за допомогою openclaw memory status --deep.

• maxSummaryChars

• зменште queryMode
• зменште timeoutMs
• зменште кількість недавніх ходів
• зменште ліміти символів на хід

​

Пов’язані сторінки

• Пошук у пам’яті
• Довідник із конфігурації пам’яті
• Налаштування Plugin SDK