血泪教训!EasyClaw 装个记忆插件,我踩了 4 个坑

为什么我要写这篇血泪史

昨天帮 EasyClaw 安装 MemOS 云端记忆插件，本来以为就是个简单的配置活儿，结果硬是折腾了 3 个小时。

4 个坑，每个都能让你怀疑人生。

今天把完整的安装流程和踩坑记录整理出来，希望能帮你省下这 3 个小时。

安装步骤（快速带过）

MemOS 云端记忆插件的安装其实很简单：

# 1. 确保 EasyClaw 已安装并运行easyclaw gateway status# 2. 安装插件easyclaw plugins install @memtensor/memos-cloud-openclaw-plugin@latest# 3. 重启 Gatewayeasyclaw gateway restart

然后修改配置文件 easyclaw.json，添加下面的配置代码块。

完整配置代码块

{  "plugins": {    "allow": ["memos-cloud-openclaw-plugin"],    "entries": {      "memos-cloud-openclaw-plugin": {        "enabled":true,        "config": {          "apiKey": "你的MemOS API Key",          "userId": "自定义唯一标识",          "captureStrategy": "last_turn",          "recallGlobal":true        }      }    }  },  "agents": {    "defaults": {      "memorySearch": {        "enabled":false      }    }  }}

4 个核心踩坑点

坑1：plugins.allow 必须加

不加 allow 列表，插件显示 disabled，hooks 根本不触发。

必须加：

"allow": ["memos-cloud-openclaw-plugin"]

坑2：内置记忆不关 = 反复串台

不关闭内置记忆会和云端记忆插件冲突。

必须关：

"memorySearch": { "enabled":false }

坑3：.env 路径找不到？直接传 API Key！

插件只在以下路径找 .env：

• • ~/.openclaw/.env
• • ~/.moltbot/.env
• • ~/.clawdbot/.env

但 EasyClaw 的配置目录是 ~/.easyclaw，不在列表里！

解决方案： 直接在 config 传 apiKey，不用 .env 了。

坑4：slots.memory 根本不用填！

插件是 lifecycle 类型，不是 memory 类型。

填了 slots.memory 会报警告：memory slot plugin not found

不管它就行，不影响使用。

多实例隔离

多台电脑共用同一个 MemOS 账号？用 userId 隔离：

"config": {  "userId": "easyclaw-t3680-dell"}

每台机器的记忆完全隔离，互不干扰。

验证

检查日志中是否有：

✅ [plugins] [memos-cloud] Multi-agent mode enabled

或者看日志是否有报错：

❌ "API Key not found"

❌ "memorySearch conflict detected"

如果日志干净，说明配置成功。

总结：4 个坑，一张表

最后说两句

技术这东西，很多时候不是难，而是坑多。

一个插件，4 个坑，每个都不在文档的显眼位置。

希望这篇血泪史能帮你省下那 3 个小时，把时间花在更有价值的事情上。

如果你在配置过程中遇到其他问题，欢迎在评论区留言，我会持续更新这篇文章。

觉得有用？分享给同样在用 EasyClaw 的朋友，帮他们避开这些坑。