你好，我是茂林，一个AI爱好者，最近一直在折腾OpenClaw/Hermes，踩过老多坑了。我把踩过的坑整理出来，帮你少走弯路。
解决什么问题
点了保存记忆，但是提示保存失败，或者保存了搜不到。这篇整理了最常见的几种原因，一步步排查解决。
原因一：权限不足
现象
提示 Permission denied 或者 无法写入文件。
原因
OpenClaw 运行的用户对记忆目录没有写权限。
解决方法
先看你的记忆目录在哪，一般是 ~/openclaw/memory/，改权限：
# 改成你当前用户
chown -R your-user:your-user ~/openclaw/memory/
# 给写权限
chmod -R u+w ~/openclaw/memory/如果你用 Docker 运行，可能是目录挂载权限不对，检查 docker run 的 -v 参数权限。
原因二：磁盘满了
现象
提示 No space left on device。
原因
磁盘满了，写不进去新文件。
解决方法
# 看磁盘使用
df -h找到哪个分区满了，清理不用的大文件：
- 删除旧的日志文件
- 删除不用的 Docker 镜像
- 清空浏览器缓存
- 删除过期的临时文件
清完就能写了。
原因三：文件名有特殊字符
现象
保存的时候没报错，但是文件找不到，搜不到。
原因
文件名里有空格、斜杠、问号这些特殊字符，不同文件系统处理不一样，导致保存了但读不出来。
解决方法
命名记住：
- 只用小写字母、数字、连字符
-、下划线_ - 不要用空格、斜杠
/、问号?、星号*这些特殊字符 - 中文文件名尽量少用，不是不能用，就是有些工具处理容易出问题
比如：
✅ 好：openclaw-save-failed-fix.md
❌ 不好：OpenClaw 保存失败解决方法.md（有空格）
原因四：索引没更新
现象
文件保存成功了，磁盘上也有，就是搜不到。
原因
保存了文件，但没更新搜索索引，所以索引里没有。
解决方法
# 更新索引
openclaw index update等索引更新完，再搜就能搜到了。如果你用 Web UI，点「更新索引」按钮就行。
原因五：文件内容太大
现象
保存大文件提示失败，或者保存了加载慢。
原因
单个文件太大，超过 OpenClaw 默认处理限制。
解决方法
- 拆分文件：把大文件拆成多个小文件，一个主题一个文件
- 调整限制：在配置文件里改最大文件大小限制：
storage: max_file_size_mb: 10 # 默认一般是 5MB，改大一点
单个文件一般不要超过 10MB，太大了搜索和加载都慢。
原因六：保存路径不对
现象
保存成功了，但是不知道存哪了，找不到。
解决方法
看配置文件里的存储路径：
storage:
memory_path: /path/to/memory去这个路径找，就能找到你的文件。默认一般在 ~/openclaw/memory/。
快速排查流程
按这个顺序来，几分钟就能找到问题：
- 看报错信息：先看提示什么错误，是权限还是磁盘满
- 检查磁盘：
df -h看是不是满了 - 检查权限：看目录权限对不对
- 检查文件名：是不是有特殊字符
- 更新索引：保存完了更一下索引再搜
90% 的问题在这几步就能解决。
总结
保存失败大部分都是简单问题：权限、磁盘满、索引没更新，按照上面流程一步步排查，很快就能修好。