核心用法
memory-transfer 是 OpenClaw 生态专用的智能体记忆迁移工具,通过命令行脚本实现跨 Agent 的记忆文件传输。核心能力包括:
| 功能 | 说明 |
|------|------|
| **基础传输** | 将源 Agent 工作区的 MEMORY.md 及每日记忆文件复制到目标 Agent |
| **单文件传输** | 支持指定日期记忆文件(如 `2026-03-01.md`)精准迁移 |
| **预览模式** | `--dry-run` 预演传输内容,避免误操作 |
| **记忆管理** | `list` 命令查看指定 Agent 的记忆文件清单 |
典型工作流
1. 主从协作:将主 Agent 的项目上下文迁移至专项子 Agent(如 coder)
2. 隐私安全共享:通过 share 模式过滤用户个人信息,适配目标 Agent 身份
3. 灾难恢复:定期备份记忆文件,支持 reset 后快速恢复
显著优点
- 生态原生设计:深度适配 OpenClaw 工作区结构(
workspace-<agent-id>/),无需配置路径 - 隐私保护机制:share 模式自动识别并过滤用户个人信息(PII),降低数据泄露风险
- 智能身份适配:自动调整记忆内容中的第一人称指代,匹配目标 Agent 身份
- 增量合并能力:支持与目标 Agent 现有记忆智能合并,非简单覆盖
- 操作可逆:dry-run 预览 + 文件级操作,便于审计与回滚
潜在缺点与局限性
| 局限 | 说明 |
|------|------|
| **生态绑定** | 仅适用于 OpenClaw 框架,无法直接迁移至其他 AI 平台 |
| **格式依赖** | 依赖特定文件结构(MEMORY.md + memory/*.md),非结构化数据可能丢失 |
| **权限要求** | 需文件系统读写权限,多用户环境需额外配置 |
| **冲突处理** | 合并策略细节未公开,复杂冲突场景可能需要人工介入 |
| **无版本控制** | 原生不支持记忆版本历史管理 |
适合人群
- OpenClaw 重度用户:运行多个专项 Agent(coder、writer、researcher 等)的开发者
- 隐私敏感场景:需要在团队共享上下文时保护个人身份信息的用户
- 自动化运维:希望将 Agent 记忆备份纳入 CI/CD 或定时任务的技术团队
常规风险
- 数据覆盖:目标 Agent 同名记忆文件可能被覆盖(建议先用
--dry-run) - 隐私过滤遗漏:自动 PII 检测非 100% 准确,敏感场景建议人工复核
- 身份适配偏差:自动人称转换可能在复杂对话场景中产生语义漂移
- 路径硬编码:工作区路径依赖特定环境变量,容器化部署需额外验证