保姆级教学！阿里云服务器从零搭建Hermes Agent AI智能体配置Token Plan流程

一、前言

在AI智能体快速普及的当下，Hermes Agent凭借优秀的长会话交互、复杂任务拆解、深度逻辑推理能力，成为个人办公、学习辅助、项目协作、智能问答场景中备受青睐的开源AI应用。和传统对话工具不同，Hermes Agent主打多轮连续对话、上下文强记忆、复杂指令分步执行，能够承接逻辑链条长、步骤繁琐的工作任务，搭配主流大模型使用后，可极大提升日常工作与学习效率。

很多新手想要长期稳定使用Hermes Agent，都会选择将其部署在阿里云服务器上。相比本地电脑部署，云服务器可以实现7×24小时不间断在线，不受本地关机、休眠、网络波动、设备性能限制等问题影响，使用体验更加稳定。但对于完全没有服务器运维、开源项目部署经验的零基础用户来说，面对系统环境配置、代码依赖安装、配置文件编写、端口放行、后台运行等一系列操作，很容易出现操作失误、服务启动失败、外网无法访问、模型调用异常等问题。

结合2026年阿里云主流服务器环境、Ubuntu系统特性以及Hermes Agent最新版本运行要求，本文整理一套纯新手向、超详细的全流程部署步骤。从服务器选型、前期准备、远程连接，到系统环境初始化、源码拉取、依赖安装、核心参数配置、防火墙与安全组放行、服务测试、后台常驻、开机自启，再到日常运维、版本更新、故障排查，每一步都搭配可直接复制执行的终端命令与配置代码。全文不包含外部链接、表格与图片，语言通俗易懂，操作步骤清晰连贯，哪怕是第一次接触云服务器和开源项目的新手，按照流程一步步操作，也能顺利完成Hermes Agent的完整部署并正常投入使用。阿里云部署AI Agent：OpenClaw/Hermes Agent全网最简单，只需两步，详情👉访问阿里云OpenClaw/Hermes一键部署专题页面 了解。









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

二、部署前期准备工作

2.1 服务器选型与操作系统推荐

本次部署适配阿里云两大类服务器产品，分别是云服务器ECS与轻量应用服务器，两者操作逻辑基本一致，新手可根据自身需求自由选择。

硬件配置方面，仅个人单机使用、日常对话、少量简单任务处理，最低选择1核2G配置即可满足运行需求；如果后续需要多人同时访问、频繁执行复杂推理任务、叠加拓展功能，建议选择2核2G及以上配置，避免内存资源不足造成服务卡顿、自动闪退。系统硬盘使用服务器默认配置即可，足以存放系统文件、项目源码和运行日志。

操作系统优先选用 Ubuntu 22.04 LTS，这是目前Node.js类开源AI项目兼容性最好、社区问题解决方案最多的系统。Hermes Agent基于Node.js开发，该系统能够完美适配运行环境，不建议使用Windows Server、旧版本CentOS等系统，极易出现环境报错、依赖缺失等兼容问题。

2.2 必备账号与调用凭证准备

Hermes Agent本身仅作为智能体载体，需要对接大模型才能实现AI对话、推理等核心功能，本文以阿里云百炼大模型为例进行讲解。提前登录阿里云百炼平台，开通大模型调用服务，并申请专属API Key。

该密钥是智能体与大模型通信的唯一身份凭证，属于隐私核心数据，务必单独保存，严禁对外分享、明文上传至公共文件夹或公开网络平台。同时记录好阿里云服务器的公网IP地址、远程登录账号与密码，后续远程连接服务器、外网访问Hermes Agent后台页面都需要用到公网IP。

2.3 远程连接服务器

本地设备通过终端工具远程登录阿里云服务器。Linux、macOS系统可直接使用系统自带终端；Windows系统可使用常用远程终端工具。输入远程连接指令并填写登录密码，成功进入服务器终端界面后，后续所有部署、配置、运维操作均在此界面完成。

三、服务器全局环境搭建

Hermes Agent依赖Node.js运行环境、Git代码拉取工具，本节从零开始搭建全套基础环境，所有命令按顺序执行，一次性完成全局配置，无需重复操作。

零基础部署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 的地址。
  
  

3.1 更新系统软件源与系统组件

首次登录服务器，首先更新系统软件索引和自带组件，修复潜在的版本冲突、源失效问题，为后续软件安装打下基础：

sudo apt update && sudo apt upgrade -y

命令执行过程中会自动下载更新包，全程等待执行完成即可，无需手动干预。

3.2 安装基础工具组件

批量安装Git和curl工具，Git用于拉取Hermes Agent项目源码，curl可用于网络连通性测试、接口调试：

sudo apt install git curl -y

3.3 安装Node.js与npm运行环境

Node.js是Hermes Agent的核心运行环境，npm是项目依赖包管理工具，执行以下命令完成安装：

sudo apt install nodejs npm -y

3.4 校验环境版本

安装完成后，执行版本查看命令，确认工具正常安装且版本符合要求：

node -v
npm -v
git --version

Hermes Agent要求Node.js版本不低于18.x，若查询到的版本低于该标准，会直接导致项目启动失败、功能异常，必须进行版本升级。

3.5 升级Node.js至长期稳定版

使用Node版本管理工具n完成一键升级，操作命令如下：

# 全局安装版本管理工具
sudo npm install -g n
# 切换为官方长期支持版本
sudo n lts

升级完成后，再次执行node -v，确认版本已经更新至18.x及以上，至此服务器全局运行环境搭建完毕。

3.6 规划项目存放目录

为了方便后期文件管理、运维和项目迁移，单独创建专属目录存放Hermes Agent，不使用系统默认路径：

# 创建AI项目总目录
mkdir -p /usr/local/ai_service
# 进入新建目录
cd /usr/local/ai_service

后续所有针对Hermes Agent的操作，都将在该目录下开展。

四、Hermes Agent源码拉取与项目依赖安装

环境搭建完成后，开始下载项目源码并安装项目专属依赖包，这是部署流程中的核心环节。

4.1 克隆项目源码

在当前目录下，使用Git工具拉取Hermes Agent完整项目源码：

git clone 项目源码地址

等待源码下载完成，目录中会生成对应的项目文件夹，进入项目根目录：

cd Hermes-Agent

4.2 安装项目依赖包

Hermes Agent包含会话管理、接口调用、日志记录、任务调度等多个模块，需要通过npm自动安装所有项目依赖组件：

npm install

该命令会自动读取项目配置文件，批量下载所需依赖。执行过程中不要关闭终端、不要中断命令，当终端输出成功提示信息时，代表依赖安装完成。

五、核心配置文件编写与参数详解

Hermes Agent的服务端口、大模型接口地址、调用密钥、功能开关、请求超时时间等核心运行参数，全部通过.env环境配置文件管理。项目自带示例配置文件，新手基于示例文件修改即可，操作简单不易出错。

5.1 生成正式配置文件

复制官方示例配置文件，生成可编辑的正式配置文件：

cp .env.example .env

使用系统文本编辑器打开配置文件：

vim .env

5.2 填写完整配置内容

进入编辑界面后，清空原有示例内容，粘贴下方完整配置代码，并将其中密钥、地址替换为自己的实际信息。本次配置对接阿里云百炼大模型，适配日常使用的全部核心功能：

# 大模型统一接口地址，阿里云百炼固定地址无需修改
MODEL_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
# 个人阿里云百炼API密钥，替换为自己的有效密钥
API_KEY=你的百炼API_Key
# Hermes Agent对外访问端口，自定义设置，本文统一使用8090
SERVER_PORT=8090
# 接口请求超时时间，单位为秒，网络较差可适当调大
REQUEST_TIMEOUT=180
# 开启长会话记忆功能，保留多轮对话上下文
SESSION_MEMORY=true
# 设置默认调用大模型名称
DEFAULT_MODEL=qwen3.7-plus
# 模型随机度参数，数值区间0-1，常规使用保持0.7即可
TEMPERATURE=0.7
# 开启系统运行日志
LOG_ENABLE=true
# 日志输出等级
LOG_LEVEL=info
# 最大单会话连接数，提升服务安全性
MAX_SESSION=30

编辑完成后，保存并退出文本编辑界面。

5.3 配置参数详细说明

1. MODEL_BASE_URL：大模型接口地址，对接阿里云百炼直接使用固定地址，无需改动；
2. API_KEY：大模型调用凭证，必须填写自己申请的有效密钥，填写错误会导致AI功能完全失效；
3. SERVER_PORT：服务访问端口，本文使用8090端口，可根据个人习惯修改，修改后防火墙和安全组端口也需要同步变更；
4. REQUEST_TIMEOUT：接口请求超时时间，服务器网络偏弱时建议调大数值；
5. SESSION_MEMORY：长会话记忆开关，开启后多轮对话可完整保留上下文，是Hermes Agent的核心特色功能；
6. DEFAULT_MODEL：指定默认使用的大模型，可根据自身订阅套餐灵活切换；
7. TEMPERATURE：模型创作随机性参数，数值越低回答越严谨，数值越高内容越灵活。

六、防火墙与安全组端口放行

配置文件设置完成后，外网依旧无法访问Hermes Agent服务，需要同时完成服务器本地防火墙和阿里云控制台安全组两处端口放行，两个步骤缺一不可。

6.1 服务器本地防火墙放行端口

Ubuntu系统默认搭载ufw防火墙，执行以下命令放行8090端口：

# 放行8090端口，允许外网通过TCP协议访问
sudo ufw allow 8090/tcp
# 重新加载防火墙规则，让配置立即生效
sudo ufw reload
# 查看防火墙当前放行状态
sudo ufw status

执行后可看到8090端口已处于允许访问状态。

6.2 阿里云控制台安全组配置

登录阿里云官网，进入当前云服务器的管理控制台，找到安全组配置入口。编辑安全组入方向规则，新增一条规则，选择TCP协议、填写8090端口，授权范围设置为全部IP地址，保存规则。完成这一步后，外网设备才能通过服务器公网IP加端口正常访问服务页面。

七、服务启动测试与后台持久化运行

端口放行全部完成后，分两步启动服务：首先前台启动进行功能测试，排查启动报错、功能异常；测试正常后切换为后台常驻运行，保证关闭远程终端后服务不会中断。

7.1 前台启动服务（功能测试）

在Hermes Agent项目根目录下，执行前台启动命令：

npm start

终端会实时输出服务启动日志，若日志显示端口监听成功、环境加载完成、配置读取正常，代表服务启动无误。

此时打开本地浏览器，输入服务器公网IP:8090，即可进入Hermes Agent后台界面。发送对话指令，测试多轮会话、逻辑推理、模型调用等核心功能是否正常。如果出现无响应、报错等问题，根据日志提示回到前文检查配置文件、环境、端口设置。测试完成后，使用快捷键终止前台运行的进程。

7.2 后台常驻运行服务

前台测试确认所有功能正常后，使用nohup命令将服务转入后台运行，同时将运行日志单独输出到日志文件，方便后续查看与排错：

# 后台启动服务，日志输出至hermes_run.log文件
nohup npm start > hermes_run.log 2>&1 &

命令执行完成后，服务在后台静默运行，关闭远程终端、本地电脑关机都不会影响服务正常运行。

7.3 实时查看运行日志

日常监控服务状态、排查故障时，执行以下命令实时查看日志：

tail -f hermes_run.log

查看完成后，使用快捷键退出日志查看界面即可。

八、进阶配置：服务器开机自启设置

云服务器意外断电、手动重启后，后台运行的服务会自动停止。想要实现服务器开机后Hermes Agent自动启动，无需人工干预，需要配置系统开机自启脚本，这是长期稳定运行的必备进阶配置。

8.1 编辑系统开机启动文件

Ubuntu系统通过/etc/rc.local文件配置开机自启，执行编辑命令：

sudo vim /etc/rc.local

在文件内exit 0代码行的上方，添加Hermes Agent后台启动命令，注意替换为你实际的项目路径：

# 切换至项目目录并后台启动Hermes Agent
cd /usr/local/ai_service/Hermes-Agent && nohup npm start > hermes_run.log 2>&1 &

编辑完成后保存并退出。

8.2 赋予文件执行权限

开机文件默认无执行权限，必须手动授权，自启规则才能生效：

sudo chmod +x /etc/rc.local

8.3 验证开机自启效果

执行服务器重启命令进行测试：

sudo reboot

服务器重启完成后，重新远程连接服务器，查看进程和日志，确认Hermes Agent已经自动启动。

九、日常运维常用命令汇总

Hermes Agent长期运行过程中，进程查看、服务启停、端口检测、日志清理、项目更新都是高频操作，本节整理全套实用命令，方便新手日常运维。

9.1 查看服务运行进程

查看Node进程，判断Hermes Agent是否正常运行：

ps aux | grep node

9.2 停止运行中的服务

修改配置、更新版本前，需要先停止服务：

# 终止所有npm启动的Node进程
pkill -f "npm start"

9.3 重启服务

修改配置文件、更新源码后，执行重启命令：

cd /usr/local/ai_service/Hermes-Agent
nohup npm start > hermes_run.log 2>&1 &

9.4 排查端口占用问题

若启动服务提示端口被占用，执行命令查询占用端口的进程：

sudo lsof -i :8090

找到对应进程ID后终止进程，即可释放端口。

9.5 清空日志文件

日志文件长期积累会占用磁盘空间，定期执行命令清空日志：

> /usr/local/ai_service/Hermes-Agent/hermes_run.log

十、项目版本更新操作流程

Hermes Agent官方会持续迭代版本、修复漏洞、优化功能，定期升级项目可以体验最新特性，完整升级步骤如下：

# 进入项目目录
cd /usr/local/ai_service/Hermes-Agent
# 停止当前运行的服务
pkill -f "npm start"
# 拉取官方最新源码
git pull
# 重新安装依赖（版本更新后依赖可能发生变化）
npm install
# 后台重启服务
nohup npm start > hermes_run.log 2>&1 &

十一、常见故障问题与解决方案

结合新手部署与使用过程中高频出现的问题，整理故障现象、原因分析和对应解决办法，遇到问题可直接对照排查。

11.1 npm install 执行报错，提示模块缺失、版本不兼容

故障现象：依赖安装失败，终端提示环境版本过低、模块冲突。
解决方案：检查Node.js版本，确保为18.x及以上长期稳定版；清理npm缓存后重新安装依赖：

npm cache clean -f
npm install

11.2 服务启动无报错，外网无法访问页面

故障现象：日志显示端口监听正常，但公网IP加端口打不开后台界面。
解决方案：依次检查两处端口规则：第一，服务器本地防火墙是否放行8090端口；第二，阿里云控制台安全组是否添加对应端口规则，两处必须全部配置正确。

11.3 页面可以正常打开，发送对话指令无AI回复

故障现象：界面访问正常，提交问题后长时间无响应。
解决方案：重点检查.env配置文件中的MODEL_BASE_URL和API_KEY，确认地址无误、密钥有效；测试服务器外网连通性，排查网络问题；适当调大REQUEST_TIMEOUT超时参数。

11.4 服务启动后短时间内自动闪退

故障现象：服务启动几秒或几分钟后自动停止。
解决方案：首要原因是服务器内存不足，关闭服务器内闲置进程释放资源，内存占用过高建议升级服务器配置；同时查看运行日志，排查插件冲突、参数填写错误等问题。

11.5 修改.env配置后，参数不生效

故障现象：修改端口、密钥、功能开关后，服务运行状态无变化。
解决方案：配置文件修改后，必须彻底终止后台进程，再重新启动服务，新的配置参数才会加载生效，仅刷新网页无法更新配置。

十二、安全规范与使用优化建议

12.1 密钥安全防护

API Key是大模型调用的核心凭证，一旦泄露会导致额度被盗用、产生额外扣费。不要将密钥明文分享、上传至公开代码仓库、社交平台。定期在百炼平台查看用量明细，发现异常调用立即重置密钥。

12.2 功能权限管控

Hermes Agent支持指令解析、任务执行等功能，对外公开使用时，合理限制会话权限与指令执行范围，避免恶意指令造成安全风险。

12.3 资源优化建议

长期运行场景下，定期清理日志、重启服务释放内存；关闭非必要的日志输出、限制最大会话数，减少服务器资源占用，让服务运行更加流畅。

12.4 访问安全加固

面向公网使用时，为Hermes Agent设置登录账号与密码，避免无关人员随意访问后台，提升整体服务安全性。

十三、总结

本文面向纯新手群体，结合2026年阿里云服务器环境，完整讲解了Hermes Agent从前期准备、环境搭建、源码拉取、依赖安装、核心配置、端口放行、服务启动，到后台常驻、开机自启、日常运维、版本更新、故障排查的全套操作流程。全程使用通俗易懂的语言，每一条操作命令、每一段配置代码都可以直接复制使用，降低了零基础用户的上手难度。

将Hermes Agent部署在阿里云服务器上，彻底摆脱了本地设备的诸多限制，依托云服务器的稳定算力与网络，实现全天候在线服务。其强大的长会话记忆、复杂任务推理能力，搭配主流大模型后，无论是作为个人专属AI助理、学习答疑工具，还是小型团队协作智能体，都能发挥出色的实用价值。

文中整理的运维命令、故障解决方案、安全优化建议，覆盖了日常使用中的绝大多数场景，能够帮助新手长期稳定维护服务。按照本文流程完成部署后，不仅可以正常使用Hermes Agent全部核心功能，还能掌握阿里云服务器基础运维、Node.js开源项目部署的基础技能。后续用户可以根据自身需求，调整模型参数、切换不同大模型、拓展拓展功能模块，进一步挖掘Hermes Agent的应用潜力，让AI工具更好地服务于工作与生活。