腾讯云手动部署Hermes Agent教程（轻量服务器）

Hermes Agent是Nous Research开源的AI Agent：它能在服务器上执行命令、读写文件、记住以前的对话，还会把反复做的事情沉淀成技能。部署到一台常开的服务器上，再接入Telegram等聊天工具，你就有了一个随时可以对话的私人助手。

本文讲在腾讯云轻量应用服务器上手动部署Hermes Agent。手动部署比Hostinger那种一键模板多几步，但每一步都是自己做的，出了问题知道去哪里查。

如果你更想省事，可以看《Hostinger部署Hermes Agent教程》。

先选地域：这一步最容易选错

腾讯云的服务器分境内和境外，对Hermes来说差别很大：

	境内（广州、上海、北京等）	境外（中国香港、新加坡等）
安装脚本、GitHub、依赖下载	可能慢，偶尔失败	基本顺畅
调用OpenAI、Anthropic等海外模型	访问受限，不适合	可以直连
调用国产模型（DeepSeek、Kimi、通义等）	没问题	没问题
Telegram、Discord机器人	无法稳定连接	可以正常使用
网站备案	有域名对外服务时需要	不需要

建议这样选：

想用Claude、GPT这类海外模型，或者要接Telegram：选中国香港或新加坡；
只用国产模型，不打算接海外聊天工具：境内也可以，但安装时要有耐心，必要时换国内可访问的下载方式。

下面的步骤以境外地域为例，境内的差别会单独标出来。

服务器配置建议

Hermes官方要求所用的模型上下文窗口至少64K tokens，对服务器本身没有写明硬性的内存要求。实际使用时它要装依赖、跑浏览器等工具，建议：

内存4GB起步，2GB容易在安装或运行工具时被系统杀掉进程；
系统盘40GB以上；
系统选Ubuntu 22.04或24.04。

模型本身是调用接口，不占服务器算力，所以不需要GPU。

第一步：创建轻量应用服务器

登录腾讯云控制台，进入「轻量应用服务器」，点击「新建」；
地域选好后，镜像选「Ubuntu」的纯系统镜像（不要选带应用的镜像）；
套餐选择2核4GB或以上；
设置购买时长，确认订单并付款；
回到服务器列表，等状态变成「运行中」，记下公网IP。

轻量服务器的防火墙默认只开放必要端口（SSH的22端口等）。Hermes通过Telegram这类渠道工作时是主动向外连接，不需要对外开放任何新端口，所以不要为它去放行端口。

第二步：登录服务器并新建普通用户

可以在控制台点「登录」使用网页终端，也可以用自己电脑的终端：

ssh ubuntu@服务器公网IP

腾讯云的Ubuntu镜像默认用户是ubuntu，如果你登录的是root，建议新建一个普通用户来运行Hermes。Agent能执行命令，用root运行等于把整台服务器的权限都交给它。

sudo adduser hermes
sudo usermod -aG sudo hermes
su - hermes

按提示给hermes用户设置密码。之后的操作都在这个用户下进行。

第三步：安装基础依赖

官方安装脚本需要Git、curl、tar等工具。先更新系统并装好：

sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl tar ca-certificates

第四步：安装Hermes Agent

执行官方的一行安装命令：

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

脚本会下载源码，并自动准备好所需的Python、Node.js等运行环境。程序放在~/.hermes/hermes-agent/，命令行入口是~/.local/bin/hermes，配置和数据在~/.hermes/。

安装完成后让当前终端识别新命令：

source ~/.bashrc
hermes --version

如果提示hermes: command not found，说明PATH还没生效，重新登录一次SSH再试。

境内服务器如果在这一步下载很慢或中途失败，可以先重试几次；反复失败的话，建议换成中国香港地域的服务器，比折腾网络省时间得多。

第五步：接入模型

运行配置向导：

hermes setup

向导提供三种方式：

Quick Setup：通过Nous Portal登录，不用自己管理API密钥；
Full Setup：逐项配置提供商、工具和选项，用自己的密钥；
Blank Slate：几乎所有功能关闭，只保留模型、文件操作和终端，适合想从最小权限开始的人。

第一次建议选Full Setup，然后用下面的命令选择模型提供商：

hermes model

Hermes支持很多提供商，几类常见的：

海外：Anthropic、OpenAI Codex、OpenRouter、Google AI Studio；
国内：DeepSeek、Kimi（Moonshot）、阿里云百炼（DashScope）、智谱，以及腾讯自家的TokenHub和TokenPlan；
自建/兼容接口：只要是OpenAI兼容的接口，都能通过自定义Endpoint接入。

选好后按提示填入API Key。密钥会保存在~/.hermes/.env，非敏感设置在~/.hermes/config.yaml。这两个文件不要上传到GitHub，也不要截图发给别人。

提示：Hermes会拒绝上下文窗口小于64K的模型，选模型时留意这一点。

第六步：先在终端里试一下

配好之后不要急着接聊天工具，先确认基本对话是通的：

hermes

随便问一句话，能正常回复就说明模型接通了。想检查环境是否有遗漏，运行：

hermes doctor

它会列出缺失的依赖和没配好的密钥。提示配置缺失时，可以依次运行hermes config check和hermes config migrate。

第七步：接入Telegram

这一步需要服务器能访问Telegram，所以只适用于境外地域。

在Telegram里找到官方的 @BotFather，发送/newbot，按提示设置机器人名字和以bot结尾的用户名，拿到Bot Token；
给 @userinfobot 发一条消息，它会回复你的数字用户ID（不是用户名）；
在服务器上运行向导：

hermes gateway setup

选择Telegram，填入Token和你的用户ID。也可以手动编辑~/.hermes/.env：

TELEGRAM_BOT_TOKEN=你的Token
TELEGRAM_ALLOWED_USERS=你的数字用户ID

多个用户ID用英文逗号隔开。

启动网关：

hermes gateway

回到Telegram，给你的机器人发一句话，收到回复就成功了。

一定要设置TELEGRAM_ALLOWED_USERS。 Hermes默认会拒绝不在白名单里的用户，但如果你为了省事开启“允许所有人”，任何找到这个机器人的人都可以指挥一个能执行命令的Agent，官方也不建议这样做。

第八步：设为后台服务，开机自启

上面直接运行hermes gateway，关掉终端就停了。要让它长期在线，把网关装成系统服务。

在VPS这类需要开机自动启动的服务器上，用系统级服务（仍然以你的普通用户身份运行）：

sudo hermes gateway install --system
sudo hermes gateway start --system
sudo hermes gateway status --system

查看日志：

journalctl -u hermes-gateway -f

注意不要同时安装用户级服务和系统级服务，两个并存会让启动和停止的行为变得混乱。

之后重启一次服务器，再用status命令确认网关自己起来了，这个部署才算真正完成。

日常维护

更新：运行hermes update获取新版本；更新后如果提示配置缺失，用hermes config check和hermes config migrate补齐；
排错：先看hermes doctor，再看journalctl日志；
网关启动了但没人能对话：依次检查Bot Token、白名单用户ID、hermes gateway status；
备份：重要的是~/.hermes/目录，里面有配置、技能和记忆。可以在腾讯云控制台给服务器做快照，换服务器时把这个目录复制过去即可。

安全清单

Agent能执行命令，部署前后都要过一遍：

用普通用户运行，不用root；
防火墙只保留SSH，不为Hermes额外放行端口；
SSH尽量改用密钥登录，不要用弱密码；
聊天渠道必须设置白名单；
API Key设置用量上限，万一泄露也不会产生巨额账单；
不要把~/.hermes/.env提交到代码仓库。

和一键部署比，怎么选

手动部署的好处是完全自己掌控，也能顺便学会Linux服务器的基本操作；代价是要自己处理网络、更新和排错。腾讯云境内机房还要面对GitHub访问和海外模型的限制。

如果你只想尽快用上Hermes，托管方案更省心：

《Hostinger部署Hermes Agent教程》：VPS加Docker模板，十几分钟搞定；
《Cloudways托管AI Agent部署Hermes》：连服务器都不用管。