什么是EasyClaw Brain Migration
EasyClaw Brain Migration 是一个专为从旧版 EasyClaw 工作区向新版 OpenClaw 工作区迁移智能助手核心配置而设计的工具。它并非用于复制运行时参数，而是专注于迁移定义助手行为模式、人格特征和持续性的关键文件。该工具通过系统性地识别和对比源工作区与目标工作区中的关键配置文件，帮助开发者安全地将原有知识体系、记忆片段和操作逻辑无缝过渡到新的架构中。
迁移过程强调安全性与可控性，避免盲目覆盖可能已适配 OpenClaw 新规范的活跃文件。工具提供分阶段操作机制：首先生成详细迁移报告，明确哪些文件可直接导入、哪些需人工审查；随后将旧文件安全地暂存至隔离目录，防止意外覆盖；最后支持选择性导入非冲突的记忆数据，确保核心原则和自动化机制得到妥善处理。整个过程遵循‘优先保留、谨慎合并’的策略，最大限度减少迁移风险。
此工具特别适用于已完成 EasyClaw 环境搭建但计划升级至 OpenClaw 框架的项目团队或个人。无论是需要延续原有助手的个性设定（如 SOUL.md 中的身份描述），还是希望继承其长期积累的工作记忆（MEMORY.md 及 memory/ 目录内容），该工具都能提供结构化的迁移路径，显著降低手动整理和错误替换带来的维护成本。
核心功能特点
- 自动识别并对比旧版 EasyClaw 工作区的核心配置文件（如 AGENTS.md、SOUL.md、MEMORY.md 等）
- 生成详细的迁移报告，区分可直接导入与需人工审查的文件类别
- 提供安全的暂存机制，将所有旧文件先复制到 imports/easyclaw/ 目录避免覆盖现有文件
- 支持选择性导入记忆数据（MEMORY.md 和 memory/ 目录），不干扰活跃的 AGENTS.md、SOUL.md 等文件
- 对自动化机制（如 launchd plist 文件）提供迁移建议，引导用户重建为 OpenClaw 兼容的 cron 或 heartbeat 方式
- 强调增量式迁移策略，优先采用添加而非破坏性替换，保障工作区稳定性
适用场景
该工具最适合那些正在从传统 EasyClaw 架构向现代化 OpenClaw 框架转型的开发场景。例如，一个长期使用 EasyClaw 构建个性化 AI 助手的项目，积累了丰富的 AGENTS.md 行为规则、SOUL.md 人格设定以及大量 MEMORY.md 历史交互记录。当决定切换至 OpenClaw 以利用其更灵活的上下文管理和调度能力时，直接删除或忽略这些文件会导致助手失去原有的专业性和连续性。此时，EasyClaw Brain Migration 能精准提取这些关键资产，并按需整合进新工作流，确保用户体验的一致性。
另一个典型应用场景是团队协作中的知识传承。假设多个成员基于 EasyClaw 各自开发了独特的上下文管理脚本（scripts/load_context.sh）和定时心跳任务（HEARTBEAT.md），在统一迁移至 OpenClaw 后，这些定制逻辑往往无法自动适配。该工具不仅会标记出此类自动化组件，还会提示用户将其转化为 OpenClaw 支持的 cron job 或 workspace 内置脚本形式，从而实现既有功能的平滑过渡，同时保持代码的可维护性和可扩展性。
此外，对于重视数据安全性和操作可追溯性的用户而言，该工具的 staging 机制尤为关键。它允许用户在正式合并前全面审查暂存文件，判断哪些原则应保留、哪些旧习惯需摒弃。这种‘先观察、再决策’的流程，有效避免了因误判导致的功能回退或人格错乱问题，尤其适合对 AI 助手行为有严格要求的商业或科研环境。