Active Memory（主动记忆）

概述

Active Memory 是一个可选的插件拥有的阻塞式记忆子 Agent，在主回复生成前为符合条件的对话会话注入相关记忆。它解决了传统记忆系统”被动响应”的问题——在主 Agent 决定搜索记忆之前，相关上下文已经错过了最佳注入时机。

核心要点

• 阻塞式子 Agent：在主回复前运行，有时间预算限制（最大 120000ms）
• 两道门控：配置启用 + 严格运行时资格（交互式持久聊天会话）
• 隐藏注入：将记忆摘要作为不可信提示前缀注入，不暴露给用户
• 查询模式三档：message（仅最新消息，最快）、recent（最近几轮，推荐）、full（完整对话，最慢）
• 提示风格六种：balanced、strict、contextual、recall-heavy、precision-heavy、preference-only
• 断路器保护：连续超时达阈值后暂停召回，冷却后自动恢复
• 仅适用于对话场景：不在 headless 一次性运行、heartbeat、子 Agent 内部执行中运行

配置/使用

快速启动（推荐配置）：

{
  plugins: {
    entries: {
      "active-memory": {
        enabled: true,
        config: {
          enabled: true,
          agents: ["main"],
          allowedChatTypes: ["direct"],
          modelFallback: "google/gemini-3-flash",
          queryMode: "recent",
          promptStyle: "balanced",
          timeoutMs: 15000,
          maxSummaryChars: 220,
          persistTranscripts: false,
          logging: true
        }
      }
    }
  }
}

会话级开关（不修改全局配置）：

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

全局开关：

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

调试查看：

/verbose on   # 显示 Active Memory 状态行
/trace on     # 显示 Active Memory 调试摘要

关键配置项：

配置项	说明
config.agents	启用 Active Memory 的 Agent ID 列表
config.queryMode	message/recent/full
config.promptStyle	召回积极性控制
config.timeoutMs	阻塞超时（最大 120000ms）
config.toolsAllow	允许调用的记忆工具名列表
config.setupGraceTimeoutMs	冷启动额外预算（v2026.5.2+ 需显式配置）

相关页面

• memory — OpenClaw 记忆系统总览
• memory-search — 记忆检索机制
• dreaming — 后台记忆巩固系统
• context-engine — 可插拔上下文引擎