Memory Palace#

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 环境时：系统自动降级为文本搜索，功能正常使用。

何时使用#

✅ Use when:

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

❌ Do NOT use:

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

---

快速开始#

json

// 记住用户信息
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 参数#

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+ 次验证才标记为"已验证"

---

详细文档#

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