Hermes Agent 换服务器前,优先用官方的 hermes backup 生成备份包,再在新机器用 hermes import 恢复。不要只复制仓库目录,因为真正重要的配置、会话、技能和密钥通常在 ~/.hermes/。
迁移前要确认什么
- 旧机器能正常运行
hermes doctor,避免把坏环境直接迁过去。 - 明确是否要迁移密钥、会话、skills、cron、profiles。
- 新机器系统符合官方支持范围:Linux、macOS、WSL2 或 Termux。
- 如果涉及 Docker/SSH/Modal 后端,确认外部资源也能在新机器访问。
基础迁移流程
- 旧机器执行
hermes backup,保存生成的 zip 或归档文件。 - 把备份包传到新机器的安全位置。
- 新机器先安装 Hermes,再执行
hermes import 备份文件。 - 运行
hermes doctor和hermes status检查恢复结果。
密钥要格外小心
备份可能包含 API Key、Bot Token、邮箱授权码、Webhook secret 等敏感信息。传输时不要用公开链接,迁移完成后最好轮换关键 token,尤其是旧机器不再受控或曾经暴露给多人使用。
如果只是迁移某个独立身份,也可以考虑 profile export/import。整机迁移用 backup/import,单个角色迁移用 profile 导出,这样更清楚。