OpenClaw Memory 使用指南
OpenClaw一个很重要的应用场景就是可以通过IM工具（例如企业微信）来进行交流，但一次交流的输入不会太复杂， 否则输入成本太高，有没有办法可以和OpenClaw达成一个默契，让它能够仅仅通过几个关键词就知道用户在说什么事，就像用户在和一个老熟人聊共同的往事一样？ 这种方法在OpenClaw中被称为memory（记忆），下面我就以一个 RSA 密钥生成器项目为例， 介绍如何使用 Memory 系统记录和查询工作进展
📖 什么是 Memory
OpenClaw Memory 是智能体工作空间中的纯 Markdown 文件。这些文件是唯一的事实来源——模型只"记住"写入磁盘的内容。
Memory 系统让 AI 助手能够：
📝 记录工作进展和决策
🔍 通过语义搜索快速查找信息
💬 在跨会话中保持上下文连续性
📊 向用户汇报项目状态
🗂️ Memory 文件结构
默认工作空间布局使用两个记忆层：
~/.openclaw/workspace/├── MEMORY.md 长期记忆└── memory/├── 2026-03-10.md 每日日志├── 2026-03-11.md└── 2026-03-12.md 今天的工作记录
文件用途
MEMORY.md：
长期记忆、重要决策、偏好设置
仅私人会话加载
memory/YYYY-MM-DD.md：
每日工作日志、项目进展
所有会话加载（今天 + 昨天）
📝 实战示例：RSA 密钥生成器项目
场景回顾
今天（2026-03-12）上午，用户要求创建一个 RSA 公私钥生成工具。工作流程如下：
08:55 → 创建项目结构和代码08:56 → 配置虚拟环境并安装依赖08:56 → 测试密钥生成和验证功能09:13 → 将项目记录写入 Memory
写入 Memory 的内容
在memory/2026-03-12.md中记录了：
2026-03-12 - Daily Log## RSA 密钥生成器项目### 任务概述创建基于命令行的 RSA 公私钥创建和检验工具。### 项目信息- 项目位置: ~/Downloads/rsa-keygen- 完成时间: 2026-03-12 08:56- 技术栈: Python 3.7+, cryptography 库### 项目结构rsa-keygen/├── rsa_keygen.py # 主程序（6.7KB）├── requirements.txt # 依赖：cryptography>=41.0.0├── README.md # 使用文档├── venv/ # Python 虚拟环境├── private_key.pem # 测试生成的私钥└── public_key.pem # 测试生成的公钥### 功能特性1. 密钥生成：支持 1024/2048/4096 位 RSA 密钥对2. 密码保护：可选密码加密私钥（AES 加密）3. 密钥验证：通过 OAEP 加密/解密测试验证密钥对有效性4. PEM 格式：兼容 OpenSSL、OpenSSH 等工具### 测试结果- ✓ 虚拟环境创建成功- ✓ 依赖安装成功（cryptography-46.0.5）- ✓ 密钥生成测试通过- ✓ 密钥验证测试通过
💬 在企业微信中查询项目进展
方式一：自然语言提问
在企业微信中直接向助手提问：
用户：今天上午做的 RSA 项目放在哪里了？助手：RSA 密钥生成器项目位于 ~/Downloads/rsa-keygen完成时间是 08:56，包含密钥生成和验证功能。
工作原理：助手通过memory_search工具语义搜索 Memory 文件，找到相关片段后回复。
方式二：查询特定关键词
用户：查询 rsa-keygen 项目助手：找到相关记录：📁 项目位置：~/Downloads/rsa-keygen📅 完成时间：2026-03-12 08:56✅ 状态：测试通过📄 文件：rsa_keygen.py, README.md, requirements.txt
方式三：查询今日工作
用户：今天都完成了什么工作？助手：今天（2026-03-12）完成的工作：1. RSA 密钥生成器项目 - 已完成 ✓- 位置：~/Downloads/rsa-keygen- 功能：命令行 RSA 密钥生成和验证
方式四：查询项目状态
用户：RSA 项目的测试通过了吗？助手：是的，测试全部通过：✓ 虚拟环境创建成功✓ 依赖安装成功（cryptography-46.0.5）✓ 密钥生成测试通过✓ 密钥验证测试通过
🔧 Memory 工具使用
命令行工具
OpenClaw 提供 CLI 工具管理 Memory：
# 查看 Memory 状态openclaw memory status# 深度检查（包含向量存储和嵌入模型）openclaw memory status --deep# 手动索引 Memory 文件openclaw memory index# 语义搜索openclaw memory search "RSA 项目"openclaw memory search "今天的工作"
📋 最佳实践
何时写入 Memory
✅应该记录：
项目完成状态和位置
重要决策和原因
测试结果和验证情况
用户偏好和特殊要求
遇到的问题和解决方案
❌不需要记录：
临时性、一次性的对话
可以通过文件内容推断的信息
敏感信息（密码、密钥等）
写入格式建议
项目名称
### 任务概述简要描述任务目标### 项目信息- 位置: 文件路径- 时间: YYYY-MM-DD HH:MM- 状态: 进行中/已完成/已暂停### 关键内容- 功能点 1- 功能点 2### 测试结果- ✓ 测试项 1- ✓ 测试项 2### 备注其他需要记录的信息
查询技巧
用户提问建议：
使用具体关键词（项目名、文件名、功能名）
包含时间范围（"今天"、"上周"、"3 月 12 日"）
明确查询目标（位置、状态、测试结果）
示例：
✅ "RSA 项目放在哪里了？"✅ "今天上午完成的工作"✅ "rsa-keygen 的测试通过了吗？"
🚀 高级功能
语义搜索
Memory 系统使用向量嵌入进行语义搜索，即使措辞不同也能找到相关内容：
搜索："密钥生成工具"匹配："RSA 公私钥创建和检验工具" ✓
混合搜索（BM25 + 向量）
结合两种搜索方式：
向量相似度：语义匹配（"Mac Studio" ↔ "运行 gateway 的机器"）
BM25 关键词：精确匹配（ID、错误代码、文件名）
会话记忆（实验性）
可选择索引会话记录，让助手记住对话历史：
agents: {defaults: {memorySearch: {experimental: { sessionMemory: true },sources: ["memory", "sessions"]}}}
🔐 安全说明
Memory 加载策略
私人会话：加载MEMORY.md+memory/*.md
群组会话：仅加载memory/*.md（不加载MEMORY.md）
这是为了防止私人信息泄露到群组中。
写入权限
Memory 文件需要工作空间可写
沙箱模式（workspaceAccess: "ro"）下无法写入
建议定期备份 Memory 文件
💡 小结
Memory 系统是 OpenClaw 的"长期记忆"，让 AI 助手能够：
📝记录工作进展和重要信息
🔍搜索历史内容（语义 + 关键词）
💬回复用户查询（跨会话连续性）
📊汇报项目状态（如企业微信通知）
关键要点：
写入 Memory = 让助手真正"记住"
结构化记录 = 更容易查询和汇报
语义搜索 = 即使用词不同也能找到