需执行结构化迁移：一、环境校验与路径确认；二、启用密钥隔离的显式迁移；三、分层校验与记忆文件人工复核，确保配置、技能与记忆无损迁移至Hermes Agent。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在使用OpenClaw并希望将其配置、技能与记忆等数据完整迁移至Hermes Agent，则需执行结构化迁移操作。以下是三种确保数据无损的关键步骤，每种均基于当前稳定版本v2026.3.31及Hermes v0.8.0兼容协议设计。
一、执行迁移前环境校验与路径确认
该步骤旨在识别OpenClaw实际部署位置并验证Hermes Agent运行环境完整性，避免因路径误判或依赖缺失导致迁移中断或文件损坏。系统将自动比对Python版本、权限模型及配置目录可读性。
1、运行环境检查命令：hermes doctor --env-only
2、确认OpenClaw主配置目录是否存在且可读：ls -la ~/.openclaw/config.yaml 2>/dev/null || echo "未在默认路径发现配置"
3、若OpenClaw安装于非标准路径（如/opt/openclaw），手动记录其绝对路径，供后续显式迁移调用。
4、检查当前用户对~/.hermes/目录的写入权限：test -w ~/.hermes || mkdir -p ~/.hermes
二、启用密钥隔离的显式迁移流程
该方式通过命令行参数控制敏感信息处理策略，在保留OpenClaw原始密钥文件的同时，仅导入Hermes兼容格式的配置项，实现密钥与配置的物理分离，满足安全审计要求。
1、执行干运行预览，确认待迁移文件清单：hermes claw migrate --dry-run --no-secrets
2、观察输出中是否包含SOUL.md、MEMORY.md、skills/子目录及config.yaml的映射路径。
3、执行无密钥迁移：hermes claw migrate --no-secrets
4、迁移完成后，手动校验~/.hermes/config.yaml中model_provider字段是否已清空API Key值，仅保留endpoint与model_name字段。
三、分层校验与记忆文件人工复核
该步骤聚焦于OpenClaw核心记忆组件的语义一致性保障，针对SOUL.md（人格定义）、MEMORY.md（长期事实）和USER.md（用户画像）三类文件进行内容级比对，防止格式转换过程中的截断、编码错乱或元数据丢失。
1、对比原始与目标文件行数：wc -l ~/.openclaw/SOUL.md ~/.hermes/SOUL.md
2、检查MEMORY.md末尾是否保留完整段落（非截断状态）：tail -n 5 ~/.hermes/MEMORY.md
3、确认USER.md中关键字段（如preferred_language、timezone、coding_style）是否存在于迁移后文件：grep -E "(preferred_language|timezone|coding_style)" ~/.hermes/USER.md
4、若发现缺失字段，从~/.openclaw/对应文件中提取并追加至~/.hermes/USER.md末尾，保存后执行：hermes memory reload
