记忆宫殿

Agent 的持久化记忆系统。让 AI Agent 能够记住用户偏好、对话上下文、项目状态、经验教训，并在需要时主动检索。

可选：语义搜索增强

语义搜索需要 Python 环境和向量模型（约100MB，首次使用自动下载）：

bash

检查 Python 环境

python3 --version # 需要 3.8+

安装依赖

pip install sentence-transformers

首次搜索时自动下载模型到 ~/.openclaw/models/embedding/

模型：BAAI/bge-small-zh-v1.5

无 Python 环境时：系统自动降级为文本搜索，功能正常使用。

何时使用

✅ 适用场景：

• - 用户告知个人信息、偏好、习惯
• 需要记录项目状态、技术决策
• 完成任务后积累了可复用经验
• 需要回忆之前的对话内容
• 用户提到记住别忘了下次注意

❌ 不适用场景：

• - 临时性的单次查询（直接回答即可）
• 不需要持久化的即时计算
• 已有明确文档记录的信息

---

快速开始

json
// 记住用户信息
memorypalacewrite: { content: 用户叫盘古，喜欢简洁回复, tags: [用户, 偏好], importance: 0.9 }

// 搜索记忆
memorypalacesearch: { query: 用户名字 }

// 记录经验
memorypalacerecord_experience: { content: API 用名词命名端点, category: development, applicability: 设计新 API, source: task-001 }

---

核心工具

基础操作

工具	功能	必填参数
memorypalacewrite	写入记忆	content
memorypalacesearch

搜索记忆 | query | | memorypalaceget | 获取记忆 | id | | memorypalaceupdate | 更新记忆 | id | | memorypalacedelete | 删除记忆 | id | | memorypalacelist | 列出记忆 | — | | memorypalacestats | 统计信息 | — |

经验管理

工具	功能	必填参数
memorypalacerecordexperience	记录经验	content, applicability, source
memorypalacegetexperiences

查询经验 | — | | memorypalaceverify_experience | 验证经验 | id, effective | | memorypalacegetrelevantexperiences | 相关经验 | context |

LLM 增强

工具	功能	必填参数
memorypalacesummarize	智能总结	id
memorypalaceparse_time

解析时间 | expression | | memorypalaceexpand_concepts | 扩展概念 | query |

---

参数速查

write 参数

json
{
content: 记忆内容, // 必填
tags: [标签], // 可选，分类检索
importance: 0.7, // 可选，0-1，重要记忆建议 0.7+
location: default, // 可选，存储位置
type: fact // 可选：fact/experience/lesson/preference/decision
}

search 参数

json
{
query: 搜索词, // 必填，支持自然语言
tags: [标签], // 可选，过滤标签
topK: 10 // 可选，返回数量
}

record_experience 参数

json
{
content: 经验内容, // 必填
applicability: 适用场景, // 必填
source: 来源标识, // 必填
category: development // 可选：development/operations/product/communication/general
}

---

经验有效性机制

经验按 effectivenessScore（0-1）排序：

操作	分数变化
新建经验	初始 0.1
查询使用

+0.1 |
| 验证有效 | +0.3 |
| 验证无效 | -0.1 |

验证规则：需 2+ 次验证才标记为已验证

---

详细文档

• - 完整参数说明
• 使用场景示例
• 工作原理与架构