启用主动记忆

跨对话记忆¶

对于个人或完全可信的代理，通过一项按代理设置的配置，即可启用对其其他私有对话的有界回忆：

{
  agents: {
    entries: {
      personal: {
        memory: {
          search: {
            rememberAcrossConversations: true,
          },
        },
      },
    },
  },
}

该设置对个人安装默认开启：全局 session.dmScope 必须未设置或为 "main"，并且任何绑定都不能覆盖 session.dmScope。任何已配置的 DM 隔离都会将其默认设为关闭。显式的 true 或 false 始终优先。启用后，OpenClaw 会索引该代理的会话记录，并在符合条件的私有回复之前运行一次 Active Memory 检索流程。该流程可以读取来自同一代理其他私有对话的相关记录片段，但会排除当前正在回复的对话。

隐私边界是固定的：

• 私有直接对话和持久化的显式 UI 对话可以相互回忆
• 群组和频道既不是回忆来源，也不是回忆目标
• 其他代理的记录永远不符合条件
• 未知或已存档的对话记录若缺少足够的对话元数据，将被拒绝

这不会合并对话记录、更改会话密钥或投递路由、扩大 tools.sessions.visibility，也不会授予更广泛的 sessions_* 工具访问权限。共享工作区记忆（MEMORY.md 和 memory/*.md）保持其现有行为。

Active Memory 必须保持启用。检索会为符合条件的回复增加一个有限度的阻塞步骤。有意的无意图跳过或不可用的搜索，会添加一条简短的隐藏结果说明，而不是回忆出的对话记录上下文。这会告知主模型回忆未运行或无法完成，同时不会暴露提供商错误。超时和空结果保持其现有行为。OpenClaw 的内置记忆提供程序支持这种受保护的对话记录回忆路径。其他记忆提供程序保留自己的回忆行为，但不会自动获得私有对话记录授权。openclaw doctor 会报告不支持的提供程序或缺失的 memory_search 工具。

高级 Active Memory 快速入门¶

将以下内容粘贴到 openclaw.json 中，以获得高级安全默认配置：插件开启，限定于 main，仅限直接消息会话，模型从当前会话继承。

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

plugins.entries.*（包括 active-memory.config）属于免重启配置类别：Gateway 会自动重新加载插件运行时，无需手动重启。如果你仍然希望强制完整重启，请运行：

openclaw gateway restart

要在对话中实时检查它：

/verbose on
/trace on

关键字段的作用：

• plugins.entries.active-memory.enabled: true 开启插件
• config.mode: "escalate" 仅在明确存在回忆意图但没有强确定性命中时运行深度回忆
• config.agents: ["main"] 仅让 main 代理参与
• config.allowedChatTypes: ["direct"] 将其限定为直接消息会话（群组/频道需显式选择参与）
• config.model（可选）固定专用的回忆模型；未设置时继承当前会话模型
• config.modelFallback 仅在无法解析显式模型或继承模型时使用
• config.fastMode 可选地覆盖回忆时的快速模式，而不改变主代理
• config.promptStyle: "balanced" 是 recent 模式下的默认值
• Active Memory 仍仅对符合条件的交互式持久聊天会话运行（参见何时运行）