Hermes Agent 迁移教程：本地 → VPS 全流程
适用版本：Hermes Agent v0.9.0+ 适用系统：本地 macOS / Windows（WSL2）→ VPS Ubuntu 22.04 / 24.04
前言
本地部署的 Hermes 只能在电脑开机时运行，关机即断。迁移到 VPS 的核心价值是 24/7 在线：
- Telegram / Discord 随时可达，不依赖电脑是否开机
- 定时任务（cron job）可靠运行
- 学习循环持续积累，飞轮效应更强
- 最低 $5/月即可跑起来
注意：VPS 无法直接操作你本地电脑的文件，需要通过 Telegram 收发文件来间接处理。
一、购买 VPS
推荐以下几家，按需选择：
| 服务商 | 最低价格 | 推荐节点 | 支付方式 |
|---|---|---|---|
| Hetzner | €3-4/月 | 欧洲 | 信用卡 |
| Vultr | $6/月 | 新加坡 / 东京 | 支付宝 |
| DigitalOcean | $6/月 | 新加坡 | 信用卡 |
配置建议：1核 1G 内存即可（不跑本地 LLM 的情况下，Hermes 内存占用 < 500MB）。
系统选择：统一选 Ubuntu 22.04 LTS 或 Ubuntu 24.04 LTS。
二、连接服务器
部署完成后，在服务器详情页找到 IP 地址和初始密码，然后：
ssh root@你的服务器IP
首次连接输入 yes 确认，然后输入密码（输入时不显示字符，直接回车）。
三、系统初始化
# 更新系统
apt update && apt upgrade -y
# 更新完成后重启
reboot
等待 30 秒后重新 SSH 连接。
四、安装 Hermes
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
安装过程中会弹出配置向导：
- 选择 1（Quick setup）
- Provider 随便选一个（后续会被覆盖）
- API key 先填占位符（如
skip） - 最后选 n，暂不启动
五、迁移本地数据
在本地电脑终端执行（不是 VPS）：
rsync -av --exclude='hermes-agent/' ~/.hermes/ root@你的服务器IP:~/.hermes/
这条命令会把你本地的记忆、Skill、配置、API key 全部同步到 VPS，自动排除代码目录（VPS 上已有最新版本）。
六、修复路径问题
从 Mac 迁移到 Linux VPS 时，本地路径需要修正，这是跨系统迁移最常见的问题。
第一步：创建工作目录
在 VPS 上创建一个对应的工作目录（建议和本地保持相似的命名习惯）：
mkdir -p /root/你的工作目录名
第二步：修改配置文件中的路径
sed -i 's|cwd: /你的本地路径|cwd: /root/你的工作目录名|' ~/.hermes/config.yaml
第三步：删除本地代理服务地址
如果你本地用了代理中转服务（如 CAMOFOX 等），这类 localhost 地址在 VPS 上无效，需删除：
# 示例，根据实际情况替换变量名
sed -i '/CAMOFOX_URL/d' ~/.hermes/.env
第四步：检查 Skills 中的硬编码路径
grep -r "/Users/你的用户名" ~/.hermes/skills/
有输出的话，逐个替换：
sed -i 's|/Users/你的用户名/你的本地路径|/root/你的工作目录名|g' 对应的SKILL.md路径
第五步：重新加载 shell
source ~/.bashrc
七、处理记忆中的旧路径
记忆数据库里可能存有本地路径的记录。进入 Hermes 后直接告诉它：
我从本地迁移到了 VPS，以前所有涉及
/Users/xxx/本地路径的路径现在都变成了/root/工作目录，请更新你的记忆。
Hermes 会自己翻找记忆并修正相关条目。
八、启动 Telegram Gateway
确保 .env 文件里已配置好 TELEGRAM_BOT_TOKEN 和 TELEGRAM_ALLOWED_USERS，然后：
# 注册为系统服务（开机自启）
hermes gateway install
# 启动服务
systemctl --user start hermes-gateway
# 确认运行状态
systemctl --user status hermes-gateway
看到 active (running) 说明启动成功。此后无需手动管理，VPS 重启后自动恢复。
九、验证迁移结果
- 在 Telegram 给你的 Bot 发一条消息
- 收到回复说明 Gateway 正常运行
- 问它「告诉我你记住了什么关于我的信息」，验证记忆是否成功加载
十、迁移后必做事项
修改 VPS 密码（安全起见，替换掉服务商生成的初始密码）
passwd
定期备份数据（在本地执行，防止 VPS 到期或出故障时数据丢失）
rsync -av --exclude='hermes-agent/' root@你的服务器IP:~/.hermes/ ~/hermes-backup/
建议设置手机提醒，在 VPS 到期前 3 天备份数据或续费。
十一、访问 VPS 上的文件
VPS 没有图形界面，推荐以下方式：
图形界面（推荐新手） ：下载 Cyberduck（Mac 免费），新建 SFTP 连接，填入服务器 IP、用户名 root、密码，连上后即可像本地文件夹一样拖拽操作。
命令行：
ls /root/你的工作目录/
cat /root/你的工作目录/某个文件
十二、常见问题
Q：迁移后记忆都没了？
大概率是 LLM provider 配置问题导致模型无法连接，检查 ~/.hermes/config.yaml 中的 base_url 和 api_key 是否在 VPS 上可访问（本地代理地址在 VPS 上不可用）。
Q：Gateway 启动失败，提示 Unit not found？
Hermes 的 gateway 服务安装在用户级 systemd，需要加 --user 参数：
systemctl --user start hermes-gateway
Q：VPS 到期了还能取回数据吗？
到期后通常有几天宽限期，在此期间仍可 SSH 登录取数据。宽限期过后服务器会被销毁，数据无法恢复。强烈建议提前备份。
Q：本地 Hermes 还需要保留吗？
建议保留一段时间作为过渡。本地版本的唯一优势是可以直接操作本地文件，如果你的工作流不依赖这个，VPS 版本完全可以替代。
附：本地 vs VPS 对比
| 维度 | 本地部署 | VPS 部署 |
|---|---|---|
| 可用性 | 电脑开机才能用 | 24/7 在线 |
| 本地文件操作 | 直接操作 | 需通过 Telegram 收发 |
| 移动端访问 | 不支持 | Telegram 随时可达 |
| cron 任务 | 依赖电脑开机 | 可靠运行 |
| 成本 | 仅电费 | $5-6/月起 |
| 隐私 | 数据在本地 | 数据在自己的 VPS |
| 迁移难度 | - | 首次跨系统麻烦，之后简单 |
两者不是非此即彼，可以并行使用：本地处理文件密集型任务，VPS 负责后台持续运行和移动端交互。
Hermes Agent 官方文档：hermes-agent.nousresearch.com GitHub：github.com/NousResearc…
