保姆级实操：阿里云ECS/轻量服务器完整部署Hermes Agent全流程手册

Hermes Agent是一款具备自我进化能力的开源AI智能体，内置跨会话持久化记忆、经验自动沉淀、多任务自主编排等核心能力，可实现代码开发、文件处理、联网检索、自动化任务执行等功能。本地部署存在设备断电、算力不足、多终端无法同步等问题，依托阿里云服务器部署可实现7×24小时稳定运行，无缝对接阿里云百炼大模型，解锁完整智能体能力。本文覆盖服务器选型、环境准备、一键部署、模型配置、端口放行、功能测试、运维优化与故障排查全流程，零基础用户可直接按步骤完成搭建。

一、部署前置准备工作

1. 账号与实名认证

需完成阿里云账号实名认证，未实名无法创建服务器实例、开通百炼大模型服务。个人用户完成个人实名，企业用户完成企业实名，认证流程简单，刷脸即可快速通过。

2. 百炼API密钥获取

Hermes Agent依赖大模型接口实现核心功能，需提前进入阿里云百炼控制台创建API密钥。密钥分为按量计费API Key与Token Plan/Coding Plan专属密钥，均可接入Hermes Agent。密钥生成后仅展示一次，务必复制保存，丢失需重新创建。新用户可享受免费调用额度，用于前期功能测试。

3. 服务器基础配置要求

Hermes Agent最低配置为2核2G内存、40G高速云盘，推荐2核4G及以上配置，避免内存溢出、服务闪退。操作系统优先选择Alibaba Cloud Linux 3或Ubuntu 22.04，兼容性最佳。带宽3M起步即可满足日常访问需求。

二、阿里云服务器选型与地域设置

1. 轻量应用服务器（新手首选）

适合个人开发者、小型团队、轻度测试场景，内置Hermes Agent专属应用镜像，无需手动配置环境。操作界面简洁，性价比高，支持一键部署。地域优先选择中国香港、新加坡等海外节点，无需备案，且不限制联网检索功能。国内内地地域需备案，且联网功能受限，不推荐用于Hermes Agent部署。

2. ECS云服务器（进阶选择）

适合企业开发、高频商用、多智能体并行场景，支持弹性扩容、自定义安全组、集群扩展，性能稳定性更强。可通过OOS扩展程序一键安装Hermes Agent，无需手动配置依赖。地域同样优先免备案海外节点。

创建实例时设置登录密码，记录公网IP地址，后续远程连接、Web后台访问均需使用。

三、三种部署方案实操步骤

方案一：轻量应用服务器一键部署（最简便）

零基础部署AI Agent：OpenClaw/Hermes Agent喂饭级步骤流程

第一步：👉点击打开访问阿里云OpenClaw/Hermes Agent一键部署专题页面。

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

第二步：👉打开选择阿里云轻量应用服务器，配置参考如下：

• 镜像：OpenClaw(或Hermes Agent)镜像（已经购买服务器的用户可以重置系统重新选择镜像）
• 实例：内存必须2GiB及以上。
• 地域：默认美国（弗吉尼亚），目前中国内地域（除香港）的轻量应用服务器，联网搜索功能受限。
• 时长：根据自己的需求及预算选择。

第三步：打开访问阿里云百炼大模型控制台，找到密钥管理，单击创建API-Key。

前往轻量应用服务器控制台，找到安装好OpenClaw的实例，进入「应用详情」放行18789端口、配置百炼API-Key、执行命令，生成访问OpenClaw的Token。

• 端口放通：需要放通对应端口的防火墙，单击一键放通即可。
• 配置百炼API-Key，单击一键配置，输入百炼的API-Key。单击执行命令，写入API-Key。
• 配置OpenClaw/Hermes：单击执行命令，生成访问OpenClaw/Hermes的Token。
• 访问控制页面：单击打开网站页面可进入OpenClaw/Hermes对话页面。

阿里云百炼Coding Plan API-Key 获取、配置保姆级教程：

创建API-Key，推荐访问订阅阿里云百炼Coding Plan，阿里云百炼Coding Plan每天两场抢购活动，从按tokens计费升级为按次收费，可以进一步节省费用！

• 购买后，在控制台生成API Key。注：这里复制并保存好你的API Key，后面要用。
  
• 回到轻量应用服务器-控制台，单击服务器卡片中的实例 ID，进入服务器概览页。
  
• 在服务器概览页面单击应用详情页签，进入服务器详情页面。
  
• 端口放通在OpenClaw使用步骤区域中，单击端口放通下的执行命令，可开放获取OpenClaw 服务运行端口的防火墙。
  
• 这里系统会列出我们第一步中创建的阿里云百炼 Coding Plan的API Key，直接选择就可以。
  
• 获取访问地址单击访问 Web UI 面板下的执行命令，获取 OpenClaw WebUI 的地址。
  
  

1. 登录阿里云轻量应用服务器控制台，选择应用镜像中的Hermes Agent镜像。
2. 选择实例配置（2核2G起）、地域、购买时长，提交订单并支付。
3. 实例创建完成后，进入应用详情页，点击“初始化配置百炼API Key”。
4. 选择百炼地域，输入API密钥（支持Coding Plan密钥），点击下一步。
5. 点击“安全代理访问”进入WebUI面板，查看版本、日志与配置信息。

方案二：ECS服务器OOS扩展程序一键安装

1. 登录阿里云OOS控制台，进入“服务器管理 > 扩展程序”。
2. 在公共扩展程序中找到Hermes Agent卡片，点击“安装扩展程序”。
3. 选择目标ECS实例，点击创建，等待安装完成。
4. SSH登录服务器，执行hermes --version验证安装成功。

方案三：手动部署（自定义配置）

1. 远程连接与系统更新

SSH登录服务器，执行系统更新命令：

# Ubuntu/Debian
sudo apt update && sudo apt upgrade -y
# CentOS/Alibaba Cloud Linux
sudo yum update -y

2. 安装基础环境

sudo yum install git nodejs npm python3 python3-pip wget unzip -y

3. 拉取源码与安装依赖

cd /usr/local
mkdir hermes_agent
cd hermes_agent
git clone 项目源码地址
cd hermes_source
npm install

4. 配置文件编写

cp .env.example .env
vim .env

写入配置内容：

MODEL_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
API_KEY=你的百炼API密钥
SERVER_PORT=8090
REQUEST_TIMEOUT=180
SESSION_MEMORY=true
DEFAULT_MODEL=qwen3.7-max

四、端口放行与服务启动

1. 安全组配置

登录阿里云控制台，进入服务器安全组，添加入站规则：协议TCP，端口8090，授权对象0.0.0.0/0。

2. 本地防火墙放行（Ubuntu）

sudo ufw allow 8090/tcp
sudo ufw reload

3. 启动服务

nohup npm start > hermes.log 2>&1 &

五、功能测试与验证

1. 浏览器访问http://服务器公网IP:8090，进入Hermes Agent WebUI。
2. 输入测试指令，如“编写Python读取文件代码”，验证模型调用与任务执行。
3. 测试联网检索功能，验证智能体是否可正常获取外部信息。

六、运维优化方案

1. 开机自启配置

sudo vim /etc/rc.local
# 添加启动命令
cd /usr/local/hermes_agent/hermes_source
nohup npm start > hermes.log 2>&1 &
# 保存退出
sudo chmod +x /etc/rc.local

2. 资源监控

定期查看服务器CPU、内存占用，高负载时升级配置。

3. 数据备份

定时备份.env配置文件与日志，避免数据丢失。

七、常见故障排查

1. WebUI无法访问：检查安全组8090端口是否放行、服务是否正常运行、公网IP是否正确。
2. 模型调用失败：核对API密钥是否正确、地域是否匹配、额度是否耗尽。
3. 服务频繁闪退：升级内存至4G，减少并发任务数量。
4. 联网检索失效：更换海外地域服务器。

八、总结

阿里云服务器部署Hermes Agent可解决本地部署的稳定性问题，实现全天候在线智能体服务。三种部署方案覆盖不同用户需求，一键部署适合新手，手动部署适合自定义配置。通过合理配置模型密钥、端口放行与运维优化，可长期稳定运行Hermes Agent，用于代码开发、自动化任务、数据处理等各类场景。