如何使用一键命令从OpenClaw无缝迁移至Hermes Agent？

本文共计913个文字，预计阅读时间需要4分钟。

如果您已经是OpenClaw用户，想切换至Hermes Agent，无需重新配置。Hermes Agent内置专用迁移命令hermes claw migrate，可自动识别。

一、一键自动迁移（推荐）

该方式适用于希望快速完成全量配置继承的用户。迁移工具会主动扫描 OpenClaw 配置目录，生成符合 Hermes Agent v0.10.0 规范的 config.yaml 及对应数据结构，并保留原始 OpenClaw 数据不作任何修改。

1、在已部署 OpenClaw 的终端中执行安装脚本：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

2、安装完成后，系统将自动检测 ~/.openclaw 目录并提示：
Detected existing OpenClaw configuration at ~/.openclaw. Import it? [Y/n]:

3、输入 Y 并回车，等待迁移完成。迁移过程默认启用 --dry-run 验证阶段，确认无误后自动写入。

4、迁移结束后，执行 hermes doctor 检查配置完整性，再运行 hermes chat -q "Hello" 进行基础对话验证。

二、手动精细迁移（按需选择）

该方式适用于需控制迁移粒度的场景，例如仅同步用户数据而不迁移敏感密钥，或需跳过特定配置项。迁移命令支持参数化控制，所有操作均基于只读预检先行原则，确保目标环境安全。

1、执行预览命令查看实际将被处理的文件列表：
hermes claw migrate --dry-run

2、确认输出中显示的迁移路径与预期一致，例如：
[DRY RUN] Would copy: /home/user/.openclaw/SOUL.md -> /home/user/.hermes/SOUL.md

3、如需仅迁移用户数据（排除 API Key 等凭证），执行：
hermes claw migrate --preset user-data

4、如目标位置已存在同名文件且需强制覆盖，追加参数：
hermes claw migrate --overwrite

三、迁移后配置消息网关

此步骤为 Hermes Agent 特有功能，OpenClaw 未提供等效机制。消息网关统一管理 Telegram、Discord、Slack、WhatsApp、Signal 和 Email 入口，通过交互式向导完成绑定，提升跨平台任务触发能力。

1、运行初始化命令：
hermes gateway setup

2、根据提示选择首选通信平台，例如输入 telegram 后按回车。

3、粘贴 Bot Token 并确认 Webhook 地址，系统将自动完成注册与连通性测试。

4、启动网关服务：
hermes gateway start

四、迁移验证与状态检查

迁移完成后需验证关键组件是否正常加载。Hermes Agent 提供多层级健康检查机制，覆盖配置解析、模型连接、记忆索引与技能加载四大维度，避免因格式转换遗漏导致运行异常。

1、执行全量诊断命令：
hermes doctor

2、检查输出中 config、memory、skills 三项状态均为 OK。

3、若 memory 显示 FTS5 index not built，手动重建索引：
hermes memory rebuild

4、测试长期记忆调用：
hermes chat -q "What is my preferred coding language?"