需严格遵循五步迁移流程：一、验证~/.openclaw目录完整性；二、安装hermes agent并激活环境变量；三、执行--dry-run预览迁移项；四、运行hermes claw migrate正式迁移；五、通过config check、记忆查询和skill list验证配置有效性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在使用OpenClaw并希望将其完整配置与历史数据迁移至Hermes Agent，同时确保所有记忆、技能和密钥不丢失，则需遵循一套严格的数据保全流程。以下是实现数据无损迁移的具体步骤：
一、确认OpenClaw数据目录完整性
迁移前必须验证OpenClaw原始数据是否完整且可被识别，这是无损迁移的前提。Hermes Agent的迁移工具默认扫描~/.openclaw路径，若该目录缺失或结构异常，将导致部分记忆或技能无法导入。
1、打开终端，执行命令检查目录是否存在：ls -la ~/.openclaw
2、确认输出中包含SOUL.md、MEMORY.md、USER.md、skills/子目录及openclaw.json等核心文件
3、若使用非默认路径部署OpenClaw，需记录其绝对路径，后续迁移时需手动指定源位置
二、安装Hermes Agent并激活环境变量
确保Hermes Agent基础运行环境就绪，且shell能正确加载其二进制命令，避免因路径未生效导致迁移命令不可用。
1、执行标准安装脚本：curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
2、根据您的shell类型加载环境变量：source ~/.bashrc 或 source ~/.zshrc
3、验证安装结果：hermes --version，预期输出为hermes v0.8.0或更高版本
三、执行预迁移干运行（--dry-run）
该步骤不修改任何文件，仅模拟迁移过程并列出所有将被复制、转换或提取的项目，用于人工核对关键数据项是否覆盖完整。
1、运行预览命令：hermes claw migrate --dry-run
2、检查输出中是否包含以下条目：SOUL.md → ~/.hermes/SOUL.md、MEMORY.md → ~/.hermes/memory/MEMORY.md、openclaw.json → API keys extracted to ~/.hermes/.env
3、若发现缺失项（如某自定义skill未出现在列表中），需手动检查~/.openclaw/skills/下对应目录权限与命名规范
四、启动正式迁移并保留双系统共存
迁移工具采用只读+复制策略，不会删除或覆盖原有OpenClaw数据，确保在Hermes Agent运行异常时可随时回退。
1、执行迁移命令：hermes claw migrate
2、等待终端输出[SUCCESS] Migration completed.提示
3、确认目标路径~/.hermes/已生成，并检查其内部结构：ls -R ~/.hermes | grep -E "(SOUL|MEMORY|skills|config.yaml)"
五、验证迁移后配置有效性
迁移完成后需验证关键组件是否按预期加载，特别是模型连接、记忆加载与技能注册状态，防止静默失败。
1、运行配置健康检查：hermes config check
2、测试记忆读取能力：hermes chat -q "What is my name according to your memory?"
3、验证技能调用：hermes skill list，确认输出中包含从~/.openclaw/skills/导入的全部技能名称
