1 min read

LLM:OpenClaw 的Memory原生架构与Agent发展方向

LLM 系列导航

1 LLM:Function Call(1)从传统工具调用到函数驱动 2020-09-08
2 LLM:关注因果推断研究进展 2023-06-22
3 LLM:人机协作 2024-05-19
4 LLM:分层管理风险定性 2024-08-08
5 LLM:FN分层分析与提升空间测算(1) 2024-09-12
6 LLM:FN分层分析与提升空间测算(2) 2024-09-12
7 LLM:FN分层分析与提升空间测算(3) 2024-09-12
8 LLM:FN分层分析与提升空间测算(4) 2024-09-12
9 LLM:FN分层分析与提升空间测算(5) 2024-09-12
10 LLM:推理不可复现的探索 2025-06-11
11 LLM:SFT 与 RL 的关系 2025-07-29
12 LLM:SFT 与 RL 的关系(理论修正与实践补充) 2025-07-30
13 LLM:SFT 与 RL 的关系(理论修正与实践补充II) 2025-07-31
14 LLM:表格数据特征工程(1)核心方法与框架 2025-08-03
15 LLM:表格数据特征工程(2)低数据场景的决策树生成 2025-08-03
16 LLM:表格数据特征工程(3)落地冷启动 2025-08-03
17 LLM:表格数据特征工程(4)线性可分性与模型选型 2025-08-03
18 LLM:撰写大模型落地提示词的关键 2025-08-27
19 LLM:从 Prompt 设计到工作流落地 2025-08-28
20 LLM:RL's Razor 抗遗忘 2025-09-04
21 LLM:RL's Razor 抗遗忘(2) 2025-09-04
22 LLM:RL's Razor 抗遗忘(3)SFT 与 RL 的认知偏差及应用 2025-09-04
23 LLM:RL's Razor 抗遗忘(4)on-policy认知误区 2025-09-04
24 LLM:RL's Razor 抗遗忘(5)RL在线生成样本 2025-09-04
25 LLM:MuseGraph融合GNN与LLM的通用图挖掘新框架 2025-09-05
26 LLM:幻觉成因与解决 2025-09-08
27 LLM:Agent 逻辑与应用场景 2025-09-23
28 LLM:拆解大模型缩放定律失效的三重分解 2025-10-05
29 LLM:近似on-policy数据抗遗忘 2025-10-21
30 LLM:近似on-policy数据抗遗忘(2)Iterative-SFT 2025-10-21
31 LLM:幻觉治理 2025-10-28
32 LLM:先验偏见(1)变量名带偏判断 2025-11-13
33 LLM:先验偏见(2)分层分析应对 2025-11-13
34 LLM:先验偏见(3)实验效度的场景化适配 2025-11-13
35 LLM:分层落地 2025-11-13
36 LLM:零样本在金融场景落地 2025-11-13
37 LLM:跨难度泛化的局限与量化 2025-11-26
38 LLM:重复提示词解锁非推理性能上限 2025-12-17
39 LLM:用失败样本提升指令遵循能力 2025-12-29
40 LLM:概率引导的高价值信号筛选 2026-01-14
41 LLM:低成本安全检测的级联方案 2026-01-16
42 LLM:定性编码的假阳性解决方案 2026-01-16
43 LLM:先验偏见(4)挑战与落地解决方案 2026-01-22
44 LLM:先验偏见(5)工程化方案 2026-01-22
45 LLM:先验偏见(6)递进式优化与工程化落地 2026-01-22
46 LLM:SimRL(1)分层评估 2026-02-03
47 LLM:SimRL(2)理论逻辑与工程落地 2026-02-03
48 LLM:SimRL(3)质量评估与落地优化 2026-02-03
49 LLM:MCP vs Skills 核心差异 2026-03-22
50 LLM:OpenClaw 消息渠道配置实践 2026-03-22
51 LLM:OpenClaw 检索架构的工程实现与设计逻辑 2026-03-24

一、核心技术路径对比

Skill的实现逻辑为向模型注入预设的固定人工流程,用于完成标准化任务。Memory的实现逻辑为支持Agent在交互中自主总结经验,适配个性化、多场景需求。

MCP的设计为模型提供一组预定义的零散工具,具备固定调用规则与能力边界。CLI即命令行接口,将系统工具能力整合为统一入口,支持模型自主探索并生成可执行命令,适配更广泛的交互场景。

二、OpenClaw的Memory架构设计

Memory是OpenClaw Agent系统的核心组件,采用文件优先的设计,以Markdown、JSONL等格式存储内容,支持版本控制与可追溯性。

2.1 内部存储结构

OpenClaw的Memory模块默认存储路径为~/.openclaw/agents/<agent-id>/memory/,内部包含多个功能明确的子目录与文件。

OpenClaw的Memory模块默认存储路径为~/.openclaw/agents/<agent-id>/memory/,内部包含多个功能明确的子目录与文件:

  • meta.json:记忆元信息文件,记录Agent标识、更新时间、核心摘要等总控信息
  • longterm目录:存储长期生效内容,包含facts.jsonl(原子化事实)、episodes.jsonl(任务轨迹)与summary.md(自主记忆摘要)三个核心文件
  • shortterm目录:存储会话级临时内容,包含会话上下文、任务状态、激活主题等
  • vector目录:可选向量索引,支持内容快速检索
  • cachelogs目录:分别存储临时缓存与记忆读写日志

2.2 长短期记忆的划分标准

OpenClaw对长短期记忆的划分以生命周期、作用域、持久化策略与核心用途为核心标准。

短期记忆的生命周期为会话或任务级别,仅在当前会话与任务执行中生效,结束后可归档或清理。核心用途为支撑当前任务,存储对话上下文、中间结果与任务状态,采用高频读写模式,无需复杂检索。

长期记忆的生命周期覆盖Agent全周期,跨会话、跨任务全局生效,采用默认持久化策略。核心用途为沉淀Agent可复用内容,包括用户偏好、领域知识、任务成败轨迹等,仅在决策前按需召回,任务结束后完成沉淀,是Agent自主积累的核心载体。

2.3 记忆流转逻辑

Agent运行时,会话启动会从长期记忆召回相关内容,注入短期记忆工作上下文。会话执行中,交互内容、中间结果与执行状态实时写入短期记忆。任务结束或会话关闭时,Agent触发记忆沉淀流程,从短期记忆提炼可长期复用内容写入长期记忆,并定期更新全量记忆摘要。

三、Memory模块与系统的交互逻辑

Memory模块与OpenClaw系统核心组件形成全链路交互,覆盖输入、决策、执行、反馈全流程。

用户输入进入系统后,Agent核心引擎先读取Memory模块内容,为决策提供支撑。任务规划组件基于Memory存储的历史内容,生成适配场景的执行计划。执行组件完成工具调用或系统操作后,将执行结果与状态信息写入Memory模块。交互产生的内容最终沉淀至长期记忆,为后续任务执行提供参考。

四、设计的底层理论背景

现代计算机存储架构、认知科学中的记忆分类模型,以及AI系统发展中对通用方法的偏好,共同构成了OpenClaw Memory设计的理论背景。将人类知识与规则进行硬编码的实现方式,在长期发展中会被通用结构配合大规模算力的模式替代。Skill与MCP偏向预设规则,Memory与CLI更偏向自主探索与通用执行。

五、项目归属说明

OpenClaw为Peter Steinberger于2025-2026年发布的开源项目,采用MIT开源协议。部分厂商基于OpenClaw开源代码进行二次开发,推出云端SaaS产品与企业级版本,相关二次开发产品与原开源项目相互独立。

六、总结

不同技术路径对应不同场景需求,预设规则类方案适配标准化需求,自主沉淀类方案适配个性化、非标准化需求。Memory优先的设计,为LLM Agent系统提供支持自主积累内容的实现路径,相关设计的优化与落地,会持续影响LLM Agent系统的发展方向。

参考文献

Steinberger, P. (2025). OpenClaw official documentation. OpenClaw Open Source Project.

LLM 系列导航

1 LLM:Function Call(1)从传统工具调用到函数驱动 2020-09-08
2 LLM:关注因果推断研究进展 2023-06-22
3 LLM:人机协作 2024-05-19
4 LLM:分层管理风险定性 2024-08-08
5 LLM:FN分层分析与提升空间测算(1) 2024-09-12
6 LLM:FN分层分析与提升空间测算(2) 2024-09-12
7 LLM:FN分层分析与提升空间测算(3) 2024-09-12
8 LLM:FN分层分析与提升空间测算(4) 2024-09-12
9 LLM:FN分层分析与提升空间测算(5) 2024-09-12
10 LLM:推理不可复现的探索 2025-06-11
11 LLM:SFT 与 RL 的关系 2025-07-29
12 LLM:SFT 与 RL 的关系(理论修正与实践补充) 2025-07-30
13 LLM:SFT 与 RL 的关系(理论修正与实践补充II) 2025-07-31
14 LLM:表格数据特征工程(1)核心方法与框架 2025-08-03
15 LLM:表格数据特征工程(2)低数据场景的决策树生成 2025-08-03
16 LLM:表格数据特征工程(3)落地冷启动 2025-08-03
17 LLM:表格数据特征工程(4)线性可分性与模型选型 2025-08-03
18 LLM:撰写大模型落地提示词的关键 2025-08-27
19 LLM:从 Prompt 设计到工作流落地 2025-08-28
20 LLM:RL's Razor 抗遗忘 2025-09-04
21 LLM:RL's Razor 抗遗忘(2) 2025-09-04
22 LLM:RL's Razor 抗遗忘(3)SFT 与 RL 的认知偏差及应用 2025-09-04
23 LLM:RL's Razor 抗遗忘(4)on-policy认知误区 2025-09-04
24 LLM:RL's Razor 抗遗忘(5)RL在线生成样本 2025-09-04
25 LLM:MuseGraph融合GNN与LLM的通用图挖掘新框架 2025-09-05
26 LLM:幻觉成因与解决 2025-09-08
27 LLM:Agent 逻辑与应用场景 2025-09-23
28 LLM:拆解大模型缩放定律失效的三重分解 2025-10-05
29 LLM:近似on-policy数据抗遗忘 2025-10-21
30 LLM:近似on-policy数据抗遗忘(2)Iterative-SFT 2025-10-21
31 LLM:幻觉治理 2025-10-28
32 LLM:先验偏见(1)变量名带偏判断 2025-11-13
33 LLM:先验偏见(2)分层分析应对 2025-11-13
34 LLM:先验偏见(3)实验效度的场景化适配 2025-11-13
35 LLM:分层落地 2025-11-13
36 LLM:零样本在金融场景落地 2025-11-13
37 LLM:跨难度泛化的局限与量化 2025-11-26
38 LLM:重复提示词解锁非推理性能上限 2025-12-17
39 LLM:用失败样本提升指令遵循能力 2025-12-29
40 LLM:概率引导的高价值信号筛选 2026-01-14
41 LLM:低成本安全检测的级联方案 2026-01-16
42 LLM:定性编码的假阳性解决方案 2026-01-16
43 LLM:先验偏见(4)挑战与落地解决方案 2026-01-22
44 LLM:先验偏见(5)工程化方案 2026-01-22
45 LLM:先验偏见(6)递进式优化与工程化落地 2026-01-22
46 LLM:SimRL(1)分层评估 2026-02-03
47 LLM:SimRL(2)理论逻辑与工程落地 2026-02-03
48 LLM:SimRL(3)质量评估与落地优化 2026-02-03
49 LLM:MCP vs Skills 核心差异 2026-03-22
50 LLM:OpenClaw 消息渠道配置实践 2026-03-22
51 LLM:OpenClaw 检索架构的工程实现与设计逻辑 2026-03-24