OpenClaw的持久记忆（Persistent Memory）是让AI真正“记住”你个人偏好、重要事实和历史决策的核心机制。它不像普通聊天记录那样容易丢失，而是通过Markdown文件存储在本地磁盘上，即使重启设备或切换聊天渠道也能保留。

本教程基于OpenClaw官方文档（docs.openclaw.ai/concepts/memory）和社区最佳实践，从零教你一步步设置，让AI像老朋友一样记住你的习惯和信息。

一、OpenClaw持久记忆的工作原理

OpenClaw的记忆主要依赖两种Markdown文件（位于默认工作区 ~/.openclaw/workspace 下）：

  • memory/YYYY-MM-DD.md：每日日志（append-only），自动加载今天和昨天的内容，适合记录日常对话和临时上下文。
  • MEMORY.md：长期记忆文件（curated），存放重要事实、偏好、规则等，供每次会话注入上下文。

此外，还支持语义搜索（memory_search工具）和向量索引（sqlite-vec 或 QMD后端），让AI能主动检索旧记忆。

记忆文件是“源头真相”，AI只有把信息写入磁盘才能持久记住。聊天历史会自动压缩（compaction），但磁盘文件不会丢失。

二、准备工作

1. 确保OpenClaw已安装并运行：

openclaw status

2. 打开本地仪表盘（默认 http://localhost:18789）查看状态。

3. 检查工作区路径（默认 ~/.openclaw/workspace），可通过配置文件修改。

三、基础持久记忆设置（最简单，推荐新手）

步骤1：创建记忆文件目录和核心文件

在终端运行：

mkdir -p ~/.openclaw/workspace/memory
touch ~/.openclaw/workspace/MEMORY.md
touch ~/.openclaw/workspace/USER.md

（USER.md 可用于存放你的个人偏好，例如“用户喜欢简洁回复”“用户是程序员”等）

步骤2：编辑MEMORY.md写入重要信息

用任意编辑器打开 ~/.openclaw/workspace/MEMORY.md，写入示例内容：

# 我的长期记忆

## 个人信息
- 姓名：你的名字
- 偏好：喜欢简洁、实用回答，避免过多表情
- 工作：程序员，常用Python和JavaScript
- 重要事实：不喜欢在周末讨论工作相关话题

## 规则
- 每次回复前先检查MEMORY.md和今日日志
- 如果我不记得某事，请主动搜索memory文件夹

保存后，这些内容会在每次会话开始时自动注入上下文。

步骤3：启用语义搜索（让AI能主动回忆）

编辑配置文件 ~/.openclaw/openclaw.json（或通过仪表盘配置），确保包含以下内容（顶层 memory 配置）：

{
"memory": {
"backend": "qmd",
"qmd": {
"includeDefaultMemory": true,
"paths": ["~/.openclaw/workspace"],
"update": {
"onBoot": true,
"interval": "10m"
}
}
},
"agents": {
"defaults": {
"memorySearch": {
"enabled": true,
"provider": "local"
}
}
}
}

保存后重启网关：

openclaw restart

四、让AI自动写入和使用记忆

1. 在Telegram/WhatsApp等渠道对AI说类似指令：

  • “记住我喜欢用深色模式”
  • “把这个重要决定写入长期记忆：下次优先推荐开源工具”
  • “总结今天的对话并保存到MEMORY.md”

2. 启用自动记忆刷新：在会话接近压缩前，OpenClaw会自动提醒AI将重要信息写入磁盘（pre-compaction memory flush）。

3. 测试回忆：问AI“还记得我喜欢什么吗？” 或使用 memory_search 工具查询。

五、进阶：使用插件增强持久记忆（可选）

如果内置记忆不够强，可安装第三方插件：

  • Mem0插件：openclaw plugins add @mem0/openclaw-mem0，然后配置API Key。
  • 其他向量记忆插件：如Hindsight、Cognee或Supermemory，根据需求选择。

插件安装后，重启并在配置中启用对应内存槽。

六、常见问题与注意事项

  • 记忆不生效：确认文件路径正确、配置文件使用顶层 “memory” 而非 agents.defaults；重启后测试。
  • 每日日志过多：定期手动整理，将重要内容移到MEMORY.md。
  • 搜索慢：本地向量索引依赖硬件，推荐至少16GB内存；或使用云嵌入模型（如Gemini）。
  • 多设备同步：复制 ~/.openclaw/workspace 文件夹即可迁移记忆。
  • 隐私：所有记忆文件都在本地，不会上传云端。
  • 更新配置后运行 openclaw doctor 检查问题。

总结

通过创建MEMORY.md和每日日志 + 启用语义搜索，你就能让OpenClaw真正记住你，成为一个有“记忆”的私人AI助手。坚持让AI把重要信息写入磁盘，是保持记忆持久的关键。

设置完成后，试着和AI聊聊你的习惯，看看它是否能回忆起来！如果遇到具体错误，欢迎在评论区贴出日志，我可以帮你排查。

官方参考链接：
记忆概念文档：https://docs.openclaw.ai/concepts/memory
工作区布局：https://docs.openclaw.ai/concepts/agent-workspace
配置参考：https://docs.openclaw.ai/gateway/configuration-reference
GitHub：https://github.com/openclaw/openclaw