7×24小时运行AI智能体：阿里云 ECS 云服务器搭建Hermes Agent、订阅方案接入与生产避坑完整教程-阿里云开发者社区

AI智能体技术快速迭代演进，Hermes Agent作为一款开源执行型智能体框架，擅长复杂任务拆解、工具调用、代码执行、本地文件读写、多步骤自动化工作流。接收自然语言复杂指令之后，能够自主拆分目标，调用各类工具完成程序开发、数据处理、文档分析、信息采集等工作，受到大量开发者与技术爱好者青睐。把Hermes Agent部署在云服务器实例之上，可以实现7×24小时不间断后台运行，不受本地电脑关机、休眠的约束。搭配Token Plan订阅方案，无需在本地下载体积庞大的大模型权重，直接调用平台内部多款高性能推理模型，大幅降低硬件门槛，开箱即可使用大模型推理能力。

很多新手初次部署Hermes Agent时，常常遇到系统依赖缺失、网关端口无法访问、API鉴权返回401报错、SSH断开进程直接终止、模型调用链路不通、内存OOM崩溃等一系列问题。本文完整覆盖ECS实例前期硬件与网络准备、系统环境初始化、一键脚本部署、Docker容器部署两套实现方案、Token‑Plan凭证接入配置、网关与Web仪表盘验证、后台常驻开机自启配置、高频故障排查全部实操环节，附带大量可以直接复制执行的命令，零基础跟随步骤操作，就能够完成整套云端AI智能体环境落地。
阿里云部署AI Agent：OpenClaw/Hermes Agent全网最简单，只需两步，详情👉访问阿里云OpenClaw/Hermes一键部署专题页面了解。

Token Plan Token 最便宜/支持多模型切换：👉访问订阅阿里云百炼Token Plan AI大模型服务 。支持多模型切换，用于多模态模型灵活调用，实现多模型、多工具、多场景下的额度共享与统一管理，兼顾灵活性、稳定性与安全性，大幅降低企业使用大模型的门槛与成本。

一、ECS实例选型、操作系统与安全组前期配置

部署Hermes Agent，首先要完成云服务器实例基础环境准备，硬件规格直接决定智能体运行的稳定性。Hermes Agent程序本体资源占用并不高，但是执行复杂任务、并发调用多工具、批量生成代码时内存消耗会快速上涨。最低测试配置建议2核2GB内存，仅用于简单对话功能验证；日常开发调试场景优先选择2核4GB；如果需要并发执行多项任务、大量文件读写、大规模代码生成，推荐2核8GB配置。操作系统优先选择Ubuntu 22.04 LTS，CentOS Stream 9同样可以完整适配全部部署流程。

实例创建完成，进入控制台编辑安全组规则，Hermes Agent网关默认监听端口8642，Web仪表盘端口9119，需要放行TCP协议8642、9119端口。出于安全防护，个人使用场景源地址填写自己本机公网IP，不要直接配置0.0.0.0/0全网放行，避免网关直接暴露公网，出现密钥泄露、订阅额度被恶意消耗风险。后续如果修改程序监听端口，安全组规则要同步更新。

本地终端连接ECS实例，Windows系统使用PowerShell，MacOS、Linux直接使用系统自带终端，执行SSH连接命令，替换为自己实例公网IP：

ssh root@你的ECS公网IP地址

输入登录密码，登录服务器之后，优先更新系统软件源，升级基础依赖包，规避旧版本软件带来的兼容异常。

# Ubuntu 22.04 LTS系统执行
apt update && apt upgrade -y

# CentOS Stream 9系统执行
dnf update -y

安全重点提醒：Hermes Agent具备服务器文件读写、Shell命令执行能力，服务禁止裸端口直接对公网暴露，必须开启网关鉴权；API‑Key属于高敏感凭证，切勿随意复制分享，一旦密钥泄露，订阅套餐额度会被他人消耗。

二、服务器基础依赖组件安装

Hermes Agent依赖Python3.11运行环境，同时依赖git、curl、wget等基础工具链，系统自带软件版本经常无法满足运行条件，缺少依赖会直接导致安装脚本执行失败。执行命令安装全套基础组件：

# Ubuntu系统
apt install git curl wget python3 python3-pip python3-venv -y

# CentOS Stream9系统
dnf install git curl wget python3 python3-pip -y

安装结束校验Python版本，确认版本符合运行条件：

python3 --version

输出需要为Python3.11.x版本。如果系统自带Python版本不匹配，可以借助pyenv工具管理多Python版本，解决版本过低的问题。

接下来提供两种主流部署方案：方案一官方一键脚本快速安装，上手简单适合调试测试；方案二Docker容器部署，环境隔离，不会污染宿主机，更适合长期稳定的生产业务。

三、方式一：一键脚本安装Hermes Agent

官方提供Linux一键安装脚本，终端直接执行脚本，自动拉取程序、配置运行环境、设置环境变量。

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

脚本执行完毕，重载shell环境变量，系统识别hermes全局命令：

source ~/.bashrc

执行版本查看命令，确认安装成功：

hermes --version

输出版本号，代表程序本体部署完成。此时程序只是安装完毕，还没有配置大模型服务，不能执行对话任务。运行交互式初始化向导：

hermes setup

交互式向导选择参考，这里先跳过模型配置，后续手动接入Token Plan服务：

Choose setup mode：Quick‑start
Model provider：Skip setup for now
Configure gateway service later：Yes
Configure chat channels：No
Finish and exit wizard

Hermes Agent全部配置文件默认存放于~/.hermes/目录，核心配置文件为~/.hermes/config.yaml，后续模型、鉴权参数全部写入这份配置文件。

四、获取Token‑Plan凭证，完成Hermes Agent模型接入配置

登录百炼平台控制台，确认Token Plan订阅套餐已经完成开通，进入密钥管理页面，创建API‑Key，复制sk开头密钥字符串。密钥只展示一次，丢失只能重新生成，妥善保存密钥。Token‑Plan提供两套兼容接口，Anthropic兼容接口地址：https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic，OpenAI兼容接口地址：https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1。

Hermes Agent支持命令行快速写入配置，也可以直接编辑yaml配置文件。下面使用命令行写入配置，把YOUR_API_KEY替换成自己复制得到的密钥：

hermes config set model.provider custom
hermes config set model.base_url https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic
hermes config set model.api_mode anthropic_messages
hermes config set model.api_key YOUR_API_KEY
hermes config set model.default qwen3.8-max

参数写入完成，可以手动打开配置文件核对参数：

nano ~/.hermes/config.yaml

model节点完整配置模板参考：

model:
  default: qwen3.8-max
  provider: custom
  base_url: https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic
  api_mode: anthropic_messages
  api_key: "YOUR_API_KEY"

nano编辑器操作：Ctrl+O回车保存，Ctrl+X退出编辑器。

配置修改完成，运行健康检测命令，校验配置文件格式合法性：

hermes doctor

全部检测项显示正常，说明配置格式无误。启动Hermes Agent网关服务：

hermes gateway run

新开一个SSH终端窗口，执行命令行对话测试，验证Token‑Plan模型调用链路是否正常：

hermes chat

输入测试问题，例如：简述Hermes Agent可以完成哪些自动化任务。大模型正常输出回答，说明鉴权、接口调用全部配置成功。

五、方式二：Docker容器部署Hermes Agent（推荐生产环境）

如果希望环境隔离，规避宿主机软件版本冲突，优先选择Docker容器部署。首先在ECS服务器安装Docker运行环境：

# Ubuntu系统
apt install docker.io -y
systemctl start docker
systemctl enable docker

# CentOS Stream9系统
dnf install docker -y
systemctl start docker
systemctl enable docker

拉取官方Hermes Agent镜像，执行docker run启动容器，挂载配置目录持久化配置，映射网关、仪表盘端口：

docker run -d \
--name hermes-agent \
--restart unless‑stopped \
-p 8642:8642 \
-p 9119:9119 \
-v ~/.hermes:/opt/data \
-e HERMES_DASHBOARD=1 \
--memory=3g \
nousresearch/hermes-agent:latest gateway run

参数说明：‑d后台守护进程运行，‑p端口映射，‑v挂载配置目录；--restart unless‑stopped实现服务器重启自动拉起容器。

容器启动之后，修改宿主机~/.hermes/config.yaml填入Token‑Plan相关配置，修改完成重启容器加载新配置：

docker restart hermes-agent

查看容器运行日志，排查启动报错信息：

docker logs hermes-agent --tail 120

日志无报错，代表网关服务启动成功。

六、Web仪表盘访问验证与网关鉴权配置

网关正常运行后，浏览器访问http://ECS公网IP:9119，打开Hermes Agent Web仪表盘。公网部署必须开启网关鉴权，禁止无鉴权裸跑。执行命令生成网关访问令牌：

hermes gateway token generate

复制生成鉴权令牌，访问Web界面时携带令牌参数，没有令牌会拒绝访问网关接口。Web页面新建对话会话，发送测试指令，验证模型调用、工具调用功能。

使用curl命令做网关连通测试，替换YOUR_GATEWAY_TOKEN为生成的网关令牌：

curl http://127.0.0.1:8642/v1/chat/completions \
-H "Authorization: Bearer YOUR_GATEWAY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"messages":[{"role":"user","content":"简单介绍Hermes Agent"}],
"max_tokens":512
}'

接口返回模型输出，整套服务链路完全通。

七、配置网关后台常驻与开机自启

很多新手直接执行hermes gateway run，关闭SSH终端服务就停止，因为进程依附SSH会话窗口。脚本安装模式执行内置systemd服务安装命令，配置用户级守护进程：

hermes gateway install

执行完成，启用并且启动systemd用户服务：

systemctl --user enable --now hermes-gateway
systemctl --user status hermes-gateway

输出active(running)，常驻服务部署完成。服务器重启服务自动启动，断开SSH连接程序持续后台运行。

Docker部署模式，容器参数已经配置--restart unless‑stopped，无需额外配置systemd守护服务。

查看网关实时运行日志，用于排查后续运行异常：

journalctl --user -u hermes-gateway -f

八、高频报错排查与避坑指南

部署调试遇到异常，优先运行官方诊断工具，自动扫描配置、环境、网络问题：

hermes doctor --fix

问题1：浏览器访问8642、9119打不开页面

排查步骤：

确认ECS安全组放行TCP协议8642、9119端口；

服务器本机防火墙放行端口；
Ubuntu执行：

ufw allow 8642/tcp
ufw allow 9119/tcp
ufw reload

CentOS执行：

firewall‑cmd --add‑port=8642/tcp --permanent
firewall‑cmd --add‑port=9119/tcp --permanent
firewall‑cmd --reload

确认网关监听地址为0.0.0.0，而不是仅本地回环127.0.0.1，仅回环监听公网无法访问Web界面。

问题2：接口返回401 Unauthorized鉴权报错

代表Token‑Plan的API‑Key错误、密钥复制携带多余空格换行、密钥已经过期失效。重新复制平台完整密钥写入配置，清除多余空白字符，修改配置之后重启网关服务。同时检查订阅套餐，确认套餐额度没有耗尽。

问题3：网关启动成功，模型接口连接失败

核对base_url接口地址完整无误，区分Anthropic协议、OpenAI协议，api_mode参数必须和接口地址匹配；确认ECS服务器出站网络可以访问外部API；修改配置文件之后必须重启网关，新配置才会加载生效。

问题4：程序运行OOM内存崩溃

并发执行任务内存占用飙升，进程被系统OOM杀死。可以创建swap交换分区缓解内存压力：

fallocate -l 2G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile

问题5：hermes命令找不到

安装脚本结束没有执行source ~/.bashrc重载环境变量；或者脚本执行失败，需要重新运行一键安装脚本。

问题6：交互式对话可以聊天，但是工具调用失败

部分模型对工具调用格式适配存在差异；优先保证基础对话正常返回，再测试文件读写、命令执行等高级工具能力，可以更换默认模型版本测试。

九、后续扩展与生产环境优化建议

Hermes Agent部署完成之后，可以加载各类MCP工具插件，拓展文件解析、数据库查询、网页检索等能力。用量统计前往百炼控制台查看Token消耗报表。

公网长期生产使用，建议搭配域名部署Nginx反向代理，启用HTTPS加密访问，不要直接对外暴露原始端口，进一步提升服务安全等级。密钥配置文件设置文件权限保护，禁止普通用户读取密钥：

chmod 600 ~/.hermes/.env

定期执行hermes update更新程序版本，获取功能更新与安全补丁；定期查看~/.hermes/logs/运行日志，及时发现异常行为。

Hermes Agent搭配Token‑Plan订阅方案部署在ECS云服务器，不需要本地高性能算力硬件，就可以搭建7×24小时不间断运行的云端执行AI智能体。整套部署关键点在于服务器依赖版本匹配、安全组端口管控、API密钥正确配置、网关鉴权开启、后台常驻服务配置。遇到故障优先使用hermes doctor诊断命令，绝大多数部署问题可以快速定位。

本文完整覆盖ECS前期准备、脚本一键部署、Docker容器部署两套方案、Token‑Plan接入配置、Web仪表盘验证、systemd开机常驻、大量常见故障处理，新手按照完整步骤操作，即可搭建属于自己的云端AI执行智能体服务。

7×24小时运行AI智能体：阿里云 ECS 云服务器搭建Hermes Agent、订阅方案接入与生产避坑完整教程

一、ECS实例选型、操作系统与安全组前期配置

二、服务器基础依赖组件安装

三、方式一：一键脚本安装Hermes Agent

四、获取Token‑Plan凭证，完成Hermes Agent模型接入配置

五、方式二：Docker容器部署Hermes Agent（推荐生产环境）

六、Web仪表盘访问验证与网关鉴权配置

七、配置网关后台常驻与开机自启

八、高频报错排查与避坑指南

问题1：浏览器访问8642、9119打不开页面

问题2：接口返回401 Unauthorized鉴权报错

问题3：网关启动成功，模型接口连接失败

问题4：程序运行OOM内存崩溃

问题5：hermes命令找不到

问题6：交互式对话可以聊天，但是工具调用失败

九、后续扩展与生产环境优化建议

热门文章

最新文章

相关电子书

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

7×24小时运行AI智能体：阿里云 ECS 云服务器搭建Hermes Agent、订阅方案接入与生产避坑完整教程

一、ECS实例选型、操作系统与安全组前期配置

二、服务器基础依赖组件安装

三、方式一：一键脚本安装Hermes Agent

四、获取Token‑Plan凭证，完成Hermes Agent模型接入配置

五、方式二：Docker容器部署Hermes Agent（推荐生产环境）

六、Web仪表盘访问验证与网关鉴权配置

七、配置网关后台常驻与开机自启

八、高频报错排查与避坑指南

问题1：浏览器访问8642、9119打不开页面

问题2：接口返回401 Unauthorized鉴权报错

问题3：网关启动成功，模型接口连接失败

问题4：程序运行OOM内存崩溃

问题5：hermes命令找不到

问题6：交互式对话可以聊天，但是工具调用失败

九、后续扩展与生产环境优化建议

热门文章

最新文章

相关电子书