Memory Palace
Agent 的持久化记忆系统。让 AI Agent 能够记住用户偏好、对话上下文、项目状态、经验教训，并在需要时主动检索。
可选：语义搜索增强
语义搜索需要 Python 环境和向量模型（~100MB，首次使用自动下载）：
# 检查 Python 环境
python3 --version # 需要 3.8+
# 安装依赖
pip install sentence-transformers
# 首次搜索时自动下载模型到 ~/.openclaw/models/embedding/
# 模型：BAAI/bge-small-zh-v1.5
无 Python 环境时：系统自动降级为文本搜索，功能正常使用。
何时使用
✅ Use when:
- 用户告诉你个人信息、偏好、习惯
- 需要记录项目状态、技术决策
- 完成任务后积累了可复用经验
- 需要回忆之前的对话内容
- 用户提到"记住""别忘了""下次注意"
❌ Do NOT use:
- 临时性的单次查询（直接回答即可）
- 不需要持久化的即时计算
- 已经有明确文档记录的信息
快速开始
// 记住用户信息
memory_palace_write: { "content": "用户叫盘古，喜欢简洁回复", "tags": ["用户", "偏好"], "importance": 0.9 }
// 搜索记忆
memory_palace_search: { "query": "用户名字" }
// 记录经验
memory_palace_record_experience: { "content": "API 用名词命名端点", "category": "development", "applicability": "设计新 API", "source": "task-001" }
核心工具
基础操作
| 工具 | 功能 | 必填参数 |
|---|---|---|
memory_palace_write | 写入记忆 | content |
memory_palace_search | 搜索记忆 | query |
memory_palace_get | 获取记忆 | id |
memory_palace_update | 更新记忆 | id |
memory_palace_delete | 删除记忆 | id |
memory_palace_list | 列出记忆 | — |
memory_palace_stats | 统计信息 | — |
经验管理
| 工具 | 功能 | 必填参数 |
|---|---|---|
memory_palace_record_experience | 记录经验 | content, applicability, source |
memory_palace_get_experiences | 查询经验 | — |
memory_palace_verify_experience | 验证经验 | id, effective |
memory_palace_get_relevant_experiences | 相关经验 | context |
LLM 增强
| 工具 | 功能 | 必填参数 |
|---|---|---|
memory_palace_summarize | 智能总结 | id |
memory_palace_parse_time | 解析时间 | expression |
memory_palace_expand_concepts | 扩展概念 | query |
参数速查
write 参数
{
"content": "记忆内容", // 必填
"tags": ["标签"], // 可选，分类检索
"importance": 0.7, // 可选，0-1，重要记忆建议 0.7+
"location": "default", // 可选，存储位置
"type": "fact" // 可选：fact/experience/lesson/preference/decision
}
search 参数
{
"query": "搜索词", // 必填，支持自然语言
"tags": ["标签"], // 可选，过滤标签
"topK": 10 // 可选，返回数量
}
record_experience 参数
{
"content": "经验内容", // 必填
"applicability": "适用场景", // 必填
"source": "来源标识", // 必填
"category": "development" // 可选：development/operations/product/communication/general
}
经验有效性机制
经验按 effectivenessScore（0-1）排序：
| 操作 | 分数变化 |
|---|---|
| 新建经验 | 初始 0.1 |
| 查询使用 | +0.1 |
| 验证有效 | +0.3 |
| 验证无效 | -0.1 |
验证规则：需 2+ 次验证才标记为"已验证"