必须执行规范导入操作才能将openclaw的长期积累数据迁移至hermes agent，方法包括：一、一键自动检测导入；二、显式调用claw migrate子命令；三、手动复制核心配置文件；四、从备份归档导入。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已使用 OpenClaw 长期积累记忆、技能、API 密钥或消息平台配置，现需将这些数据完整迁移至 Hermes Agent，则必须执行规范的数据导入操作。以下是多种可行的导入方法：
一、一键自动检测导入
该方式由 Hermes Agent 内置 setup 命令触发，系统会主动扫描用户主目录下的 ~/.openclaw 路径，识别全部可迁移项并交互式确认导入。适用于绝大多数标准部署场景，无需手动指定路径或过滤内容。
1、在终端中执行初始化设置命令：
hermes setup
2、当提示出现 Detected existing OpenClaw configuration at ~/.openclaw. Import it? [Y/n]: 时，输入 Y 并回车
3、等待控制台输出 Migration completed successfully 字样，表示导入完成
二、显式调用 claw migrate 子命令
该方式提供更细粒度的控制权限，支持干运行预览、选择性迁移、跳过密钥等敏感项，适合对数据安全性或结构有定制化要求的用户。
1、执行预览命令查看将被操作的文件列表：
hermes claw migrate --dry-run
2、确认输出中列出的路径（如 /home/user/.openclaw/SOUL.md → /home/user/.hermes/SOUL.md）符合预期
3、执行实际迁移：
hermes claw migrate
4、按提示逐项确认是否迁移 API keys、插件配置、记忆数据库等模块
三、手动复制核心配置文件
当自动检测失败或目标环境受限（如无网络、权限隔离）时，可直接通过文件系统复制关键配置。此法绕过 CLI 工具链，但需严格匹配 Hermes 的目录结构与文件命名规范。
1、定位 OpenClaw 配置根目录：~/.openclaw/
2、创建 Hermes 配置目录（若不存在）：
mkdir -p ~/.hermes
3、复制以下必需文件（保留原始文件名）：
- SOUL.md
- MEMORY.md
- skills/ 目录全量
- credentials.yaml（如需保留密钥）
4、确保 ~/.hermes 下所有文件属主为当前用户，且权限不高于 600（尤其 credentials.yaml）
四、从备份归档导入
若此前已对 OpenClaw 执行 tar/gz 备份（如 openclaw-backup-20260410.tar.gz），可通过解压后重定向路径的方式还原。该方式适用于跨设备迁移或恢复误删配置。
1、解压归档至临时目录：
tar -xzf openclaw-backup-20260410.tar.gz -C /tmp/claw_restore
2、检查解压后结构是否含完整 .openclaw 子目录：
ls -la /tmp/claw_restore/.openclaw/
3、使用 hermes claw migrate 指向该路径：
hermes claw migrate --source /tmp/claw_restore/.openclaw
4、按提示完成导入流程
