migrating-memory

迁移记忆

此技能可将现有 Agent 的记忆块迁移到新 Agent，类似于 macOS 迁移助理，但适用于 AI Agent。

需要 Memory Filesystem (memfs)

此工作流以 memfs 为优先。如果已启用 memfs，请勿使用旧版记忆块命令——它们可能会与基于文件的编辑冲突。

**检查方法：**查看系统提示词中是否有 memory_filesystem 块。如果它显示的树结构以 /memory/ 开头，并包含 system/ 目录，则表示已启用 memfs。

**启用方法：**请用户运行 /memfs enable，然后重新加载 CLI。

何时使用此技能

• 用户正在设置一个需要继承现有 Agent 记忆的新 Agent
• 用户想要在多个 Agent 之间共享记忆块
• 用户要用新 Agent 替换旧 Agent
• 用户提到自己有一个包含有用记忆的现有 Agent

迁移方法（以 memfs 为优先）

导出 → 复制 → 同步

推荐使用以下流程：

1. 将源 Agent 的 memfs 导出到临时目录

   letta memory export --agent <source-agent-id> --out /tmp/letta-memory-<source-agent-id>
   

2. 将需要的文件复制到自己的 memfs 中

   • system/ = 附加的记忆块（始终加载）
   • 根目录 = 未附加的记忆块

   示例：

   cp -r /tmp/letta-memory-agent-abc123/system/project ~/.letta/agents/$LETTA_AGENT_ID/memory/system/
   cp /tmp/letta-memory-agent-abc123/notes.md ~/.letta/agents/$LETTA_AGENT_ID/memory/
   

3. 提交并推送记忆仓库

   cd ~/.letta/agents/$LETTA_AGENT_ID/memory
   git add system/project notes.md
   git commit -m "Import memory from source agent"
   git push
   

这样，你就能完全控制要迁移的内容，并确保与 memfs 保持一致。

如果未启用 MemFS

旧版块级 CLI 命令已被移除。请先启用 MemFS，然后使用上述导出 → 复制 → 同步工作流。

如果复制记忆文件时遇到重复文件名，请重命名新复制的文件，或在提交前手动合并其内容。

工作流

步骤 1：确定源 Agent

请用户提供源 Agent 的 ID（例如 agent-abc123）。

如果用户不知道 ID，请调用 finding-agents 技能进行搜索：

Skill({ skill: "finding-agents" })

示例：“你想从哪个 Agent 迁移记忆？它的 ID 是什么？”

示例：迁移项目记忆

场景：你是一个新 Agent，想要继承现有 Agent“ProjectX-v1”的记忆。

1. 向用户获取源 Agent ID： 用户提供：agent-abc123

2. 导出其 memfs：

   letta memory export --agent agent-abc123 --out /tmp/letta-memory-agent-abc123
   

3. 将相关文件复制到你的 memfs 中：

   cp -r /tmp/letta-memory-agent-abc123/system/project ~/.letta/agents/$LETTA_AGENT_ID/memory/system/
   

4. 提交并推送：

   cd ~/.letta/agents/$LETTA_AGENT_ID/memory
   git add system/project
   git commit -m "Import project memory"
   git push