启用活动内存

跨会话记忆

对于个人或完全受信任的代理，请通过每个代理的设置启用其其他私有对话之间的有限回忆：

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

对于个人安装，此设置默认开启：全局 session.dmScope 必须未设置或为 "main"，且任何绑定都不得覆盖 session.dmScope。任何已配置的 DM 隔离都会将其默认关闭。显式的 true 或 false 始终优先生效。启用后，OpenClaw 会索引该代理的会话转录，并在适用的私有回复之前运行一次主动记忆检索步骤。该步骤可以从该代理的其他私有对话中读取相关的转录摘录。它不会包含当前正在回复的对话。

隐私边界是固定的：

• 私有直连和持久化的显式 UI 对话可以相互回忆
• 群组和频道既不是回忆来源，也不是回忆目的地
• 其他代理的转录内容永远不符合条件
• 元数据不足的未知或已归档转录会被拒绝

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

活动内存必须保持启用状态。检索为符合条件的回复添加了有界阻止步骤。有意无意的跳过或不可用的搜索会添加一个简短的隐藏结果注释，而不是回忆的转录上下文。这告诉主模型，在不暴露提供者错误的情况下，召回未运行或无法完成。超时和空结果保留其现有行为。 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 agent 纳入
• config.allowedChatTypes: ["direct"] 将其范围限定为直接消息会话（明确选择 groups/channels）
• config.model（可选）固定专用回忆模型；未设置时继承当前会话模型
• config.modelFallback 仅在没有显式或继承模型可用时使用
• config.fastMode 可选地为回忆覆盖快速模式，而不更改主 agent
• config.promptStyle: "balanced" 是 recent 模式的默认值
• 活动内存仍然仅针对符合条件的交互式持久聊天会话运行（请参阅 运行时 ）