Hermes Agent 完整备份教程：如何安全备份到 GitHub（2026最新版）

Hermes Agent（俗称 Hermes 助手 / 爱马仕龙虾）是一个会自我进化的开源 AI Agent，它的核心价值在于持久记忆 + 自动生成的技能。一旦数据丢失，几个月积累的记忆和技能就全部没了。

本文将手把手教你：

• 使用官方内置命令备份

• 把备份安全上传到 GitHub

• 实现自动化备份（推荐）

• 完整恢复流程

• 进阶 Git 版本控制方案

1. Hermes 数据到底存在哪里？

Hermes 的所有重要数据都集中在下面这个目录：

~/.hermes/

主要包含：config.yaml：配置

.env：API Keys（最敏感）

skills/：你所有的技能（包括自动生成的）

state.db：记忆和状态数据库

sessions/：会话历史

其他缓存和认证文件

备份的核心就是备份这个目录。

2. 官方内置备份命令（最推荐）

Hermes 从较新版本开始内置了 hermes backup 命令，非常好用。

完整备份（推荐日常使用）

hermes backup

执行后会生成类似下面的文件：

~/hermes-backup-2026-07-01-041234.zip

快速备份（只备份核心关键数据，速度快很多）

hermes backup –quick

适合每天多次备份，只包含 config.yaml、state.db、.env、auth 等核心文件。

优点：

.即使 Hermes 正在运行也可以安全执行

.使用 SQLite 原生备份机制，保证数据库一致性

.自动排除运行时临时文件和 checkpoints

3. 手动备份到 GitHub（最简单上手）

步骤：

1：在 GitHub 创建私有仓库

仓库名建议：hermes-backups 或 hermes-agent-backup

一定要选择 Private（私有）

2：生成备份

hermes backup

3：上传到 GitHub

方式一：直接把 zip 文件拖拽上传到仓库

方式二：创建 Release，把 zip 作为附件上传（推荐，便于版本管理）

4：添加说明（可选但推荐）

在仓库根目录新建 README.md，写上备份日期和说明。

优点：简单直接

缺点：需要手动操作

4. 使用 Web Dashboard 备份（图形化操作）

运行以下命令打开网页版管理界面：

hermes dashboard

在 Dashboard 页面找到 Operations（操作）区域，你会看到：

Create backup → 一键创建备份

Restore from backup → 从备份恢复

部分版本还支持直接上传/下载备份文件

适合不喜欢用命令行的用户。

5. 自动化备份到 GitHub（推荐长期使用）

方案一：让 Hermes 自己定时备份并推送（最智能）

直接对 Hermes 说：“帮我设置一个每天凌晨 3 点自动执行 hermes backup –quick，然后把生成的 zip 文件推送到我的 GitHub 私有仓库 hermes-backups。”

Hermes 有内置的定时任务系统 + 终端执行能力，可以完成整个流程（需要你提前配置好 Git 和 GitHub Token）。

方案二：使用社区 Skill（hermes-backup-repo）

社区有一个专门的 Skill 叫 hermes-backup-repo，专门用来：

.自动创建并维护 GitHub 私有备份仓库

.定期同步 Hermes 的完整状态（记忆、技能、配置等）

安装这个 Skill 后，可以实现比较完善的自动化备份。

方案三：传统 Cron + Git（稳定可靠）

如果你熟悉 Linux，可以写一个简单脚本：

#!/bin/bash DATE=(date +%Y-%m-%d_%H%M%S) BACKUP_FILE=~/hermes-backup-DATE.zip

hermes backup –quick -o $BACKUP_FILE

推送到 GitHub（需提前配置好 git）

cd ~/hermes-backups cp $BACKUP_FILE . git add . git commit -m “Hermes backup $DATE” git push origin main

再用 crontab -e 设置定时任务即可。

6. 完整恢复流程

在新服务器或新电脑上恢复非常简单：

.安装好 Hermes Agent

.把备份 zip 文件传到新机器

.执行恢复命令：

hermes import ~/hermes-backup-2026-07-01-041234.zip

.恢复后建议重新运行一次模型配置验证：

hermes model

注意：恢复前最好先停止 Hermes Gateway，避免文件冲突。

7. 进阶玩法：Git 版本控制关键文件

如果你想对技能和记忆做精细版本控制，可以采用以下方案：

把以下目录/文件放入 Git 管理（用 symlink 链接回去）：

（~/.hermes/skills/）

（~/.hermes/config.yaml）

（部分重要记忆文件）

这样每次技能更新或重要记忆变化，都可以 git commit，实现真正的版本历史。

8. 重要注意事项

常见问题 FAQ

Q：备份文件很大怎么办？

A：使用 hermes backup –quick，或者定期清理 cache/ 和不需要的历史 sessions。

Q：可以备份到多个地方吗？

A：可以，同时备份到 GitHub + 本地 NAS + 云盘是最稳妥的方案。

Q：恢复后技能和记忆还在吗？

A：是的，只要用了官方的 hermes import，技能和记忆都会完整恢复。

Q：Docker 部署怎么备份？

A：直接备份挂载的 ~/.hermes 目录，或者用 docker cp 导出整个容器数据卷。

总结推荐方案

Hermes 的价值在于它“越用越懂你”。一旦数据丢失，就等于把一个陪伴你几个月的 AI 助手重置了。所以备份真的非常重要。建议你今天就执行一次 hermes backup，并把 zip 上传到 GitHub 私有仓库。