迁移指南
更新时间:2026-05-25
对于本地 Agent 已有的内置记忆,可以通过迁移功能将其导入到 Agent 记忆服务中,从而获得跨会话、跨设备和多 Agent 共享等能力。
迁移流程通常包括三个步骤:先导出本地记忆文件,再通过仪表盘导入云端,最后将 Agent 连接到 Agent 记忆服务,使后续记忆能够统一存储、持续更新并在不同使用场景中共享。
定位本地数据
找到 Agent 本地保存的记忆文件。不同 Agent 的记忆存储位置不同,可根据对应工具或框架的说明进行查找。
导入到云端
在控制台中,使用「添加文档」功能上传已导出的本地记忆文件。系统会将文件内容写入云端记忆库,作为后续检索和推理的基础。
连接 Agent
完成导入后,将 Agent 配置为使用 Agent 记忆服务替代原有的本地记忆存储。连接成功后,Agent 的记忆即可实现持久化管理,并支持在跨会话、跨设备和多 Agent 场景中共享使用。
常见 Agent 的迁移方式
以下列出了三种常见 Agent 的记忆位置及导出命令,导出后统一在控制台「添加文档」中上传。
OpenClaw
记忆位置:~/.openclaw/memory/(SQLite 数据库 + 向量索引)
Bash
1# 导出 OpenClaw 记忆,然后通过仪表盘导入
2openclaw memory export --format json --output ~/openclaw-memories.json
3# 在仪表盘 → 添加文档中上传 openclaw-memories.json
Claude Code
记忆位置:~/.claude/projects/<project>/memory/(Markdown 文件)
Bash
1# 合并所有记忆文件并导入
2cat ~/.claude/projects/*/memory/*.md > ~/claude-memories.md
3# 在仪表盘 → 添加文档中上传 claude-memories.md
Cursor
记忆位置:~/.cursor/memory/ 或项目级 .cursor/ 目录
Bash
1# 导出 Cursor 的记忆文件
2find ~/.cursor/memory -name '*.json' -exec cat {} \; > ~/cursor-memories.json
3# 在仪表盘 → 添加文档中上传 cursor-memories.json
控制台导入
选择或创建一个记忆库,点击「添加文档」,然后粘贴或上传导出的记忆内容。Agent 记忆服务会自动提取事实、实体和关系。
导入完成后,建议进入 Recall 页面,用自然语言查询导入内容。如果能够召回相关内容,说明迁移已经完成。
使用建议
- 使用有意义的文档ID(如 openclaw-migration-2024),方便后续更新导入而不产生重复。
- 添加标签如 source:openclaw 或 migrated:true 来追踪哪些记忆是导入的。
- 导入后,使用仪表盘的 Recall 页面验证记忆是否可搜索且相关。
评价此篇文章
