夜雨聆风Hermes Agent 从 OpenClaw 迁移保姆级教程：技能、记忆、配置一键搬家不丢失
如果你之前已经在使用 OpenClaw，现在准备切换到 Hermes Agent，最担心的一件事一定是：之前辛辛苦苦积累的技能、记忆、配置，会不会全丢？
好消息是：官方已经提供了迁移能力。也就是说，从 OpenClaw 迁移到 Hermes Agent，并不是“重装重来”，而是一次相对平滑的升级过程。
这篇文章就用最保姆级、最稳妥的方式，带你一步一步完成迁移：安装、识别旧配置、迁移技能、迁移记忆、确认配置是否生效、排查常见问题。
本文说明： 内容严格基于 Hermes Agent 官方 GitHub 仓库、官方文档以及安装/设置流程说明整理，不杜撰、不臆测。如果后续版本更新，请以官方最新文档和命令行为准。
🚀 为什么很多 OpenClaw 用户会迁移到 Hermes Agent？
Hermes Agent 本身就是在更完整的产品化、生态化方向上持续演进的 Agent 项目。从官方公开信息来看，Hermes Agent 强调的是：
• 自我改进（self-improving） • 跨会话记忆 • 自动技能创建与复用 • 多平台 Gateway 能力 • 更统一的 CLI 与配置体验
而对于老用户来说，迁移成本是否低，决定了值不值得切换。官方之所以提供迁移支持，核心就是：尽量让 OpenClaw 用户把已有积累带过去，而不是从零开始。
💡 迁移前你最该知道的 3 件事
在开始操作之前，先把最关键的结论说清楚：
1. 最推荐的方式：先安装 Hermes，再运行官方 setupHermes Agent 的安装与初始化流程中，会检查是否存在旧配置，并在支持的情况下提示迁移。不要先手工乱拷文件，优先走官方 setup 流程。 2. 迁移前一定要备份即使官方支持迁移，也建议你先备份以下内容：OpenClaw 配置目录、技能目录、记忆/数据库目录、 .env或相关密钥配置文件。3. 迁移后要做验证，不能只看“命令执行成功”确认旧技能是否能被看到、历史记忆是否能被召回、原有 Provider 是否正常工作。
🛠️ 迁移前准备：先把这几项做好
环境准备
确保你的系统已经满足 Hermes Agent 的基本运行要求：
• Linux / macOS / Windows（推荐 WSL2） • 网络环境正常，当前用户对配置目录有读写权限。
备份 OpenClaw 数据
你至少应该备份以下几类内容：
# 示例：请按你本机实际目录执行cp -r ~/.openclaw ~/.openclaw.backup建议重点关注：
• 配置文件、Skills/技能文件、记忆存储文件。 • 环境变量文件（.env）、自定义脚本或扩展。
第一步：安装 Hermes Agent
官方推荐的使用安装脚本方式：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash安装完成后，重启终端验证：
hermes --version第二步：运行初始化流程，检查是否触发迁移
安装完成后，不要急着直接开用，执行：
hermes setup这是最关键的一步。 官方支持的迁移入口，本质上是在 setup 过程中完成的。你需留意提示：
• 是否检测到旧版 OpenClaw 配置？ • 是否询问要不要导入已有数据？ • 如果出现迁移选项，建议优先使用官方引导。
第三步：确认哪些内容可能被迁移
1. 配置（Configuration）
包括已配置的模型 Provider、运行参数、Agent 基础设置。
• 重点确认：默认 Provider 是否正确？API Key 是否仍需重新填写？本地模型地址是否正确？
2. 技能（Skills）
Hermes Agent 的核心是技能系统。
• 重点确认：技能文件是否仍存在？是否能在 Hermes 中被识别？
3. 记忆（Memory）
这是迁移中的高价值资产。
• 重点确认：过去的用户偏好是否还能被召回？项目上下文是否仍然存在？
第四步：迁移完成后，立即做 5 项验证
验证 1：确认 Hermes 能正常启动
执行 hermes 或 hermes chat。
验证 2：检查原有 Provider 是否可用
直接提问：“介绍一下你当前可用的能力，并说明是否已加载配置。” 如果报错，说明需手动补充 Key 或 Endpoint。
验证 3：检查技能是否还在
通过官方方式查看技能，或做一个“技能验证任务”，观察它是否能复用旧工作流。
验证 4：检查记忆是否还能召回
提问过去它应该知道的信息：“我的某个项目偏好是什么？” 或 “我平时喜欢使用哪种编程语言？”
验证 5：检查多平台或工具链配置
重新测试 Telegram / Discord 接入。能迁移配置，不代表所有外部依赖（Token、路径、权限）都会自动恢复。
🔍 如果官方没有自动识别 OpenClaw，怎么办？
1. 检查目录：确认 OpenClaw 是否使用的是标准路径。 2. 确认用户：确保当前执行安装的用户与原 OpenClaw 用户一致。 3. 目录权限：检查当前用户是否有权读取旧目录。 4. 最后考虑手工迁移：仅在官方自动迁移失败时，在充分备份后尝试手工整理。
⚠️ 手工迁移时，最容易踩的 6 个坑
• 坑 1：只复制配置，不复资源（遗漏数据库或依赖文件）。 • 坑 2：密钥没迁过去（.env 文件未同步）。 • 坑 3：路径变化导致工具失效（脚本路径已变更）。 • 坑 4：技能文件在，但没识别（格式不兼容或位置不对）。 • 坑 5：记忆数据在，但搜索不到（索引未重建）。 • 坑 6：以为启动成功就代表迁移成功（未验证历史资产可用性）。
✅ 最稳妥的迁移建议
1. 完整备份 OpenClaw 2. 全新安装 Hermes Agent 3. 运行 hermes setup优先走官方迁移4. 迁移后做 5 项验证 5. 保留旧备份一段时间，不要立刻删除
📅 迁移完成后，建议你立刻做的 3 件事
1. 重新跑一个复杂任务：观察工具调用与技能复用。 2. 检查记忆是否继续增长：确认新记忆能被正确保存。 3. 尽快配置 Gateway：稳定后接入 Telegram 等平台，实现 24/7 运行。
✍️ 结语
从 OpenClaw 迁移到 Hermes Agent，最重要的是你过去积累的资产——技能、记忆、工作流。按照“备份、安装、官方 setup、逐项验证”的顺序来做，能最大限度降低风险。
推荐继续阅读系列文章：
• 《为什么 Hermes Agent 爆火？从安装开始告诉你它的“自我进化”秘密》 • 《Hermes Agent 安装后必做 5 件事：让你的 Agent 立刻进入“学习模式”》 • 《Hermes Agent Gateway 配置完整指南》
欢迎在评论区留言：你是从 OpenClaw 成功迁移过来的吗？过程中遇到了什么问题？
如果对你有帮助，欢迎点赞、收藏、转发！我们下篇见。
