EasyClaw数据迁移:换电脑/重装系统怎么保住龙虾的记忆
为什么要迁移
换电脑、重装系统、或者从国内版切到海外版——这些时候都需要把龙虾的记忆、人格、配置搬过去,不然换完它就像失忆了一样。
推荐方案:云端备份(V1.3.33+)
最简单、最可靠的方案,适合V1.3.33及以上版本。
旧电脑操作:
- 打开EasyClaw → 主界面 → 悬停右上角头像
- 点击「云端备份/恢复」→「新建备份」
- 等待备份完成(会显示备份时间和大小)
新电脑操作:
- 安装EasyClaw → 登录同一个账号
- 悬停头像 →「云端备份/恢复」→「恢复备份」
- 选择刚才的备份 → 等待恢复完成
恢复内容包含:MEMORY.md、SOUL.md、已安装的Skills、Agent配置、渠道连接设置、定时任务。
旧版手动迁移
如果你的EasyClaw版本低于V1.3.33,或者不方便用云端备份,手动搬文件:
需要复制的文件/文件夹:
| 文件 | 作用 |
|---|---|
| SOUL.md | 人格定义 |
| AGENTS.md | Agent配置 |
| MEMORY.md | 长期记忆 |
| memory/ 文件夹 | 记忆目录(所有历史积累) |
| skills/ 文件夹 | 已安装的Skills |
| agents/ 文件夹 | 已创建的Agent |
操作步骤:
- 找到EasyClaw的工作目录(通常在
~/Library/Application Support/EasyClaw或用户主目录下的workspace文件夹) - 把上面这些文件/文件夹整体复制到U盘或网盘
- 新电脑安装EasyClaw后,先关闭EasyClaw,把这些文件粘贴到对应目录覆盖
- 重新打开EasyClaw,记忆就都在了
手动迁移的注意事项
⚠️ 这些内容不会被迁移,需要重新配置:
| 内容 | 原因 | 解决方法 |
|---|---|---|
| 渠道连接(飞书/Telegram) | 每个渠道的连接凭据是绑定当前设备的 | 在新电脑上重新扫码连接 |
| 积分/套餐 | 跟账号绑定,不跟设备绑 | 登录同一个账号自动继承 |
| 云端备份数据 | 有60天有效期,会员到期清除 | 及时迁移,别拖 |
版本切换(国内→海外/海外→国内)
版本切换是最麻烦的迁移场景——两个版本安装目录相同,装一个直接覆盖另一个,而且数据不互通。
正确的切换姿势:
- 先备份:用云端备份或手动把所有文件复制走(见上面的方法)
- 卸载当前版本:完全删除EasyClaw(包括安装目录和工作目录)
- 安装新版本:下载另一个版本的安装包,安装
- 恢复备份:把步骤1的备份文件复制回新版本的工作目录(注意两个版本的工作目录路径可能不一样)
- 重新配置渠道:飞书/Telegram等渠道需要重新扫码连接
- 重新安装Skills:国内版和海外版的Skills不互通,需要重新在新版本里安装
⚠️ 版本切换后已安装的Skills不在保留范围内——必须在新版本里重新安装。
迁移后的自检清单
- [ ] SOUL.md(人格定义)正常加载
- [ ] MEMORY.md(长期记忆)内容完整
- [ ] 已创建的Agent还在,配置没丢
- [ ] 已安装的Skills正常(版本切换后需要重装)
- [ ] 渠道重新连接成功
- [ ] 定时任务还在,执行时间正确
- [ ] 发一条简单指令测试,确认龙虾"认识你"
迁移失败怎么办
如果恢复后龙虾失忆了、Skills丢了、Agent配置乱了:
- 检查你复制的文件是不是完整复制了整个文件夹(不是只复制里面的文件)
- 检查是不是复制到了正确的工作目录(不同版本路径可能不同)
- 如果还是不行,回到旧电脑重新备份,这次多备份一次以防万一
- 实在不行,手动帮龙虾把关键的MEMORY.md内容写回去(比如你的日报格式、飞书群设置)——这虽然麻烦,但总比全丢好