2026 搬瓦工 VPS 部署 Hermes Agent 教程:开源的自主学习 AI 智能体

Hermes Agent 是 Nous Research 开源的自主 AI 智能体,最大的亮点是自学习能力——它会在完成任务后自动提炼技能,下次遇到类似问题直接调用,越用越聪明。支持 200+ 个大模型(OpenRouter、OpenAI、Anthropic、DeepSeek、LM Studio 等随便切),内置 40+ 个工具,还能通过消息网关接入多个平台远程对话。部署在搬瓦工 VPS 上 24 小时在线运行,比跑在本地电脑上实用得多。

本文介绍在搬瓦工 CN2 GIA-E 套餐上部署 Hermes Agent,接入 OpenRouter 的模型,用 SSH 远程调用等方法。整套下来大约 20 分钟,Python 环境 + 一行命令安装,配置好 API Key 就能用。

一、Hermes Agent 是什么

Hermes Agent 是 Nous Research 开发的开源 AI 智能体框架,GitHub 上近 15 万 star,MIT 协议。和普通的 AI 聊天工具不同,Hermes Agent 有几个核心能力:

能力 说明
自学习(Skills) 完成复杂任务后自动生成可复用技能,下次直接调用
技能自治(Curator) 后台自动评估、合并、清理技能库,7 天一个周期
持久记忆(Memory) 跨会话记忆,基于 FTS5 全文检索 + LLM 摘要
40+ 个内置工具 文件操作、Shell 命令、网页搜索、代码执行等
200+ 模型支持 OpenRouter、OpenAI、Anthropic、DeepSeek、LM Studio 等,零锁定
19 个平台网关 Discord、Slack、Teams、WhatsApp、Signal 等
定时任务 内置 Cron 调度器,自然语言设定定时任务

简单说,它就是一个能自我进化、能远程控制、能调度任务的 AI 助手,不绑定任何模型供应商。v0.12.0(2026 年 4 月 30 日发布)新增了 Curator 自治系统、5 个推理供应商、TUI 启动速度提升 57%。

项目地址:https://github.com/NousResearch/hermes-agent

关于 AI Agent 的基础概念,可以先看《搬瓦工 VPS 上构建私有化 AI Agent 智能体应用入门指南》

二、为什么部署在搬瓦工 VPS 上

Hermes Agent 可以装在本地电脑上,但部署在 VPS 上更合理:

1、24 小时在线

Hermes Agent 的记忆系统和技能系统需要持续运行才能发挥价值。部署在搬瓦工 VPS 上,合上笔记本也不影响——随时 SSH 进去用,定时任务照常执行。

2、远程访问

通过 SSH 或消息网关,你在手机上就能和 VPS 上的 Hermes Agent 对话,让它执行服务器上的任务。比如”帮我看一下 Nginx 的错误日志”、”把 /data 目录下的 CSV 文件做个汇总”,不用 SSH 登录就能搞定。

3、搬瓦工网络优势

Hermes Agent 需要频繁调用外部 AI API(OpenRouter、OpenAI 等),搬瓦工的 CN2 GIA-E 线路到这些 API 服务的延迟很低,响应速度比国内网络直连快不少。

4、资源消耗不大

Hermes Agent 本身是个 Python 应用,不跑本地模型,真正的 AI 推理是由云端 API 完成的。搬瓦工最便宜的 $49.99/年套餐(1GB 内存)就能跑,但站长建议至少 2GB 内存,因为你大概率还会在 VPS 上跑其他服务。

关于搬瓦工各套餐线路的区别,可以参考《2026 搬瓦工线路科普》

三、搬瓦工 VPS 安装 Hermes Agent

开始之前,确认以下条件:

条件 说明
搬瓦工 VPS 已购买并能 SSH 登录,建议 2GB+ 内存
操作系统 Ubuntu 22.04 / Debian 12 / CentOS Stream 9(本文以 Ubuntu 22.04 为例)
Python 3.11+ Hermes Agent 要求 Python 3.11 或更高版本
AI API Key 至少一个模型供应商的 API Key(OpenRouter、OpenAI 或 Anthropic)

如果你还没有搬瓦工 VPS,看文末的套餐推荐直接购买。如果已有 VPS 但不会 SSH 登录,参考《搬瓦工新手入门完全指南》

SSH 登录搬瓦工 VPS 后,按以下步骤操作。

1、安装 Python 3.11

搬瓦工默认的 Ubuntu 22.04 自带 Python 3.10,版本不够,需要升级:

sudo apt update
sudo apt install -y software-properties-common
sudo add-apt-repository -y ppa:deadsnakes/ppa
sudo apt update
sudo apt install -y python3.11 python3.11-venv python3.11-dev

验证版本:

python3.11 --version
# 输出:Python 3.11.x

2、一键安装 Hermes Agent(推荐)

官方提供了一键安装脚本,最省事:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

安装完成后重新加载 Shell:

source ~/.bashrc

验证安装:

hermes --version

看到版本号就说明装好了。

3、手动安装(可选)

如果你更喜欢自己控制安装过程,也可以手动装:

git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
./setup-hermes.sh

setup-hermes.sh 会自动安装 uv 包管理器、创建虚拟环境、安装所有依赖。手动安装适合需要改源码或者做二次开发的场景,一般用户直接用一键安装就行。

四、Hermes Agent 首次配置

1、运行配置向导

第一次启动 Hermes Agent 会自动进入配置向导:

hermes setup

向导会引导你完成以下配置:

  1. 选择模型供应商:OpenRouter、OpenAI、Anthropic 等
  2. 输入 API Key:填对应供应商的 Key
  3. 选择默认模型:从远程模型目录中选择,比如 deepseek-v4-flashclaude-sonnet-4-6
  4. 配置终端后端:默认选 local 即可(后面会讲其他后端)
  5. 工具权限:选择允许 Agent 使用哪些工具

2、手动配置 API Key

如果跳过了向导,也可以手动设置:

# 设置 OpenRouter API Key(推荐,模型选择最多)
hermes config set providers.openrouter.api_key "sk-or-v1-你的key"

# 或者设置 OpenAI API Key
hermes config set providers.openai.api_key "sk-你的key"

# 或者设置 Anthropic API Key
hermes config set providers.anthropic.api_key "sk-ant-你的key"

站长推荐用 OpenRouter,一个 Key 能调 200+ 个模型,包括 Nous Research 自家的 Hermes 系列、Claude、GPT-5.5、DeepSeek V4 等,切换模型不用换 Key。

3、验证配置

hermes doctor

这个命令会检查所有配置是否正确:Python 版本、依赖项、API Key 有效性、工具可用性。有问题会直接告诉你怎么修。

五、Hermes Agent 选择和切换大模型

Hermes Agent 的一大优势是模型零锁定。

1、查看和选择模型

hermes model

会弹出一个交互式选择界面,列出所有可用模型。按供应商分组,直接选就行。

2、推荐模型组合

用途 推荐模型 供应商 说明
日常对话 deepseek-v4-flash DeepSeek / OpenRouter 速度快、成本极低,中文能力强
复杂推理 deepseek-v4-pro(开 thinking) DeepSeek / OpenRouter 1M 上下文,推理能力接近顶级
代码生成 claude-sonnet-4-6 Anthropic / OpenRouter 代码和工具调用最稳
长文本 gpt-5.5 OpenAI / OpenRouter 长上下文理解能力强
省钱方案 hermes-3-llama-3.1-8b OpenRouter Nous 自家模型,有免费额度

3、会话中切换模型

在对话过程中随时切换模型,不用退出:

/model openrouter:anthropic/claude-sonnet-4-6

不同任务用不同模型,这是 Hermes Agent 的实用之处。比如日常对话用 DeepSeek V4 Flash(便宜),遇到复杂编程任务临时切到 Claude Sonnet。

六、Hermes Agent 基本使用教程

1、启动交互式终端

hermes

进入终端界面后,直接打字对话就行。支持多行编辑、Tab 补全、历史记录、流式输出。

2、常用命令

在对话中输入 / 开头的斜杠命令:

命令 作用
/new 开始新对话
/model [模型] 切换模型
/personality [名称] 切换人格预设
/skills 查看已学习的技能
/retry 重新生成上一条回复
/undo 撤销上一轮对话
/compress 压缩上下文(节省 Token)
/usage 查看 Token 用量统计
/insights --days 7 查看近 7 天使用分析
/reload-skills 热加载技能库(不用重启)

3、工具调用示例

Hermes Agent 内置 40+ 个工具,AI 会根据你的指令自动调用:

> 检查一下服务器的磁盘使用情况,如果 /data 目录超过 80% 就清理一下旧的备份文件

Agent 会先执行 df -hdu 命令查看磁盘,然后根据结果决定是否清理。文件读取、网页搜索、代码执行等工具也是同样的用法——你只管用自然语言描述任务,Agent 自动选工具。

4、一行命令模式(-z)

不用进交互式终端,直接一行命令让 Agent 执行任务并返回结果:

hermes -z "检查 /var/log/nginx/error.log 最近有没有 5xx 错误,有的话总结一下"

可以写进 crontab 或 shell 脚本里,配合 --model 参数指定模型。也可以通过 SSH 远程调用(详见第八章)。

5、技能与记忆

Agent 完成复杂任务后会自动提炼”技能”保存下来,下次遇到类似任务直接调用。v0.12.0 新增的 Curator 系统会在后台每 7 天自动评估、合并、清理技能库,用 hermes curator status 查看技能排名。

Agent 也会自动记住跨会话的重要信息——比如你说过”我的项目用 Python 3.11 + FastAPI”,下次新对话它会自动用这个技术栈。记忆基于 SQLite FTS5 全文检索。

七、Hermes Agent 远程访问

部署在搬瓦工 VPS 上之后,有几种方式远程使用 Hermes Agent,不必每次都 SSH 登录敲命令。

1、SSH + 一行命令模式(-z)

最简单的远程方式——从本地或手机 SSH 客户端(Termius、JuiceSSH 等)直接调用:

ssh root@你的VPS "hermes -z '检查 Nginx 错误日志最近有没有 5xx 报错,有的话总结一下'"

不用开额外端口,不用配置任何东西,装完 Hermes Agent 就能用。

2、Web Dashboard

Hermes Agent 内置了 Web 管理界面,可以在浏览器中对话、管理技能库和 Cron 任务。通过 hermes gateway setup 向导配置并启动(具体配置项参考官方文档)。

⚠️ Web 端口暴露在公网有风险,建议用 Nginx 反向代理 + HTTPS,或通过防火墙限制访问 IP。

3、消息平台网关(可选)

Hermes Agent 支持接入 19 个消息平台(Discord、Slack、Microsoft Teams、WhatsApp、Signal、邮件等)。通过 hermes gateway setup 选择平台,设置 Token 和允许的用户列表,然后用 hermes gateway start 启动。

如果要让网关长期在后台运行,用 systemd 管理:

sudo tee /etc/systemd/system/hermes-gateway.service << 'EOF'
[Unit]
Description=Hermes Agent Gateway
After=network.target

[Service]
Type=simple
User=root
ExecStart=/root/.local/bin/hermes gateway start
Restart=always
RestartSec=5
Environment=HOME=/root

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable hermes-gateway
sudo systemctl start hermes-gateway

⚠️ 消息平台安全提醒:务必设置 allowed_users 限制谁能和 Agent 对话,定期通过 /usage 检查 API 用量是否异常。

八、Hermes Agent 定时任务(Cron)

Hermes Agent 内置了 Cron 调度器,用自然语言就能设定定时任务,任务结果可以推送到消息平台。

比如,在对话中直接说:

> 每天早上 9 点检查一下服务器的磁盘使用率和内存使用率

Agent 会自动创建一个 Cron 任务。也可以用命令行管理:

# 查看所有定时任务
hermes cron list

# 删除指定任务
hermes cron delete <任务ID>

搭配网关使用,定时任务的结果可以推送到消息平台,相当于一个轻量级的运维监控。比如”每天早上 9 点检查磁盘和内存”、”每小时检查 Nginx 5xx 错误”、”每周一检查 SSL 证书过期时间”。v0.12.0 还支持 context_from 字段串联任务输出。

九、Hermes Agent 安全配置

Hermes Agent 能执行 Shell 命令和文件操作,安全配置一定要做好。

1、命令审批模式

默认情况下,Agent 执行危险命令前会要求你确认。可以设置白名单,让常用的安全命令自动通过:

# 查看当前工具配置
hermes tools

# 在交互式界面中启用/禁用特定工具

2、使用 Docker 终端后端

Hermes Agent 支持 6 种终端后端:local、Docker、SSH、Daytona、Singularity、Modal。最安全的方式是让 Agent 在 Docker 容器内执行命令,和宿主机隔离。

先安装 Docker(如果还没装):

curl -fsSL https://get.docker.com | bash

然后在配置向导中选择 Docker 后端,或者通过 hermes toolshermes config set 调整终端后端设置(具体配置项可查阅官方文档)。

用 Docker 后端后,Agent 的所有命令执行都在容器沙箱内,即使 AI 误操作也不会影响宿主机。v0.12.0 还支持以宿主机用户身份运行容器,避免权限问题。

十、进阶:从 OpenClaw 迁移到 Hermes Agent

如果你之前在搬瓦工上用过 OpenClaw,可以一键迁移数据:

hermes claw migrate

迁移内容包括:

  • 人格文件(SOUL.md)
  • 记忆数据(MEMORY.md、USER.md)
  • 已创建的技能
  • 命令白名单
  • 消息平台配置
  • API Key(OpenRouter、OpenAI、Anthropic 等)
  • 工作区指令(AGENTS.md)

如果想先预览迁移内容不实际执行:

hermes claw migrate --dry-run

关于 OpenClaw 的更多信息,可以参考《2026 搬瓦工 VPS 一键安装部署 OpenClaw 图文详细教程》《OpenClaw 部署到飞书教程》

十一、Hermes Agent 常见问题

1、安装时提示 Python 版本不够

Hermes Agent 要求 Python 3.11+。如果你的系统是 Python 3.10 或更低,按第四节的步骤安装 Python 3.11。安装后确认 python3.11 --version 正确输出版本号。

2、hermes 命令找不到

安装后执行 source ~/.bashrc(或 source ~/.zshrc),重新加载 Shell 环境。如果还是找不到,检查 ~/.local/bin 是否在 PATH 中:

echo $PATH | grep -o '.local/bin'

没有的话手动添加:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

3、网关不响应

按以下顺序排查:

  1. systemctl status hermes-gateway 检查网关是否在运行
  2. 确认配置中的 Token 和 allowed_users 正确

4、内存不够用

Hermes Agent 本身大约占用 200-400MB 内存。如果你的 VPS 只有 1GB 内存且跑了其他服务,可能不够。两个办法:

  • 加 Swap:

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

5、怎么更新 Hermes Agent

hermes update --check    # 先检查更新内容(不实际更新)
hermes update            # 确认后执行更新

更新不会影响你的配置、记忆和技能数据。

十二、搬瓦工推荐套餐和新手教程

以上就是搬瓦工 VPS 部署 Hermes Agent 的完整教程。Hermes Agent 本身比较轻量,搬瓦工 $49.99/年的入门套餐就能跑。如果你还要跑网关 + 定时任务 + 其他服务,建议至少 2GB 内存的 CN2 GIA-E 套餐,线路质量好、API 调用延迟低。

如果你还没有搬瓦工 VPS,可以参考下面的推荐方案购买。

搬瓦工实时库存:https://stock.bwg.net

温馨提醒 如果您有选择困难症,直接选中间的 CN2 GIA-E方案,季付 $49.99,多达 12 个机房任意切换
方案内存CPU硬盘流量/月带宽推荐机房价格购买
KVM
(最便宜)
1GB2核20GB1TB1GbpsDC2 AO
DC8 ZNET
$49.99/年购买
KVM2GB3核40GB2TB1Gbps$52.99/半年
$99.99/年
购买
CN2 GIA-E
(最推荐)
1GB2核20GB1TB2.5Gbps美国 DC6 CN2 GIA-E
美国 DC9 CN2 GIA
日本软银 JPOS_1
荷兰 EUNL_9
美国圣何塞 CN2 GIA
加拿大 CN2 GIA
$49.99/季度
$169.99/年
购买
CN2 GIA-E
(AI 部署)
2GB3核40GB2TB2.5Gbps$89.99/季度
$299.99/年
购买
SLA
(SLA 保障)
1GB独享2核20GB1TB2.5Gbps美国 DC5 SLA
99.99% 在线率保证
每两周免费换 IP 一次
$65.89/季度
$239.99/年
购买
SLA
(外贸建站)
2GB独享3核40GB2TB2.5Gbps$116.99/季度
$399.99/年
购买
HK
(高端首选)
2GB2核40GB0.5TB1Gbps中国香港 CN2 GIA
日本东京 CN2 GIA
日本大阪 CN2 GIA
新加坡 CN2 GIA
$89.99/月
$899.99/年
购买
HK
(高端建站)
4GB4核80GB1TB1Gbps$155.99/月
$1559.99/年
购买
OSAKA
(高端性价比)
2GB2核40GB0.5TB1.5Gbps日本大阪 CN2 GIA$49.99/月
$499.99/年
购买
OSAKA4GB4核80GB1TB1.5Gbps$86.99/月
$869.99/年
购买
搬瓦工优惠码:暂无搬瓦工购买教程:《2026 年最新搬瓦工购买教程和支付宝支付教程
最新补货通知:点击查看2026 搬瓦工补货通知群200475672 | 280724862 | 852461608

选择建议:

  • 入门:KVM 套餐,目前最便宜,可选 CN2 GT 机房,入门之选。
  • 推荐:CN2 GIA-E 套餐,速度超快,可选机房多(DC6、DC9、日本软银、荷兰联通等),性价比最高。
  • 高端:香港 CN2 GIA 套餐,价格较高,但是无可挑剔。大阪 CN2 GIA 套餐也是非常不错的高端选择。

搬瓦工新手教程

  1. 搬瓦工新手入门:《搬瓦工新手入门完全指南:方案推荐、机房选择、优惠码和购买教程(推荐阅读)
  2. 搬瓦工购买教程:《2026 年最新搬瓦工购买教程和支付宝支付教程
  3. 搬瓦工补货通知:《欢迎订阅搬瓦工补货通知(补货提醒)/ 加入搬瓦工交流群
  4. 搬瓦工方案推荐:《搬瓦工高性价比 VPS 推荐:目前哪款方案最值得买?

搬瓦工补货通知

渠道名称ID / 群号说明
QQ 群(禁言)搬瓦工补货通知群 5200475672全员禁言,仅发送通知
QQ 群(禁言)搬瓦工补货通知群 11280724862全员禁言,仅发送通知
QQ 群(禁言)搬瓦工补货通知群 12852461608全员禁言,仅发送通知
TG 频道搬瓦工补货通知 TG 频道@BandwagonHostNews补货推送频道
微信微信公众号搬砖部落补货会发推送
微信微信号bwgvps补货通知会发在朋友圈
实时库存搬瓦工实时库存网站stock.bwg.net实时刷新库存状态
补货通知欢迎订阅搬瓦工补货通知(补货提醒)/ 加入搬瓦工交流群

未经允许不得转载:Bandwagonhost中文网 » 2026 搬瓦工 VPS 部署 Hermes Agent 教程:开源的自主学习 AI 智能体