零基础入门教程：阿里云 Hermes Agent 一键部署完整流程详解（图文版）

一、前言

随着AI智能体技术不断普及，Hermes Agent凭借出色的长对话记忆、复杂任务拆解、逻辑推理与多轮交互能力，成为个人办公、学习答疑、日常协作、智能辅助的热门开源工具。相较于普通对话机器人，Hermes Agent能够完整承接长链路任务、记住全程对话上下文，在深度交流、方案梳理、问题分析等场景表现尤为突出。

对于零基础用户而言，传统手动部署开源项目需要一步步配置系统环境、安装依赖、修改配置文件、放行端口，操作繁琐且极易出错，很多新手卡在环境适配、服务启动、外网访问等环节无法继续。为此，结合2026年阿里云主流服务器环境与Hermes Agent最新版本特性，本文带来一键部署方案，大幅简化操作步骤，降低上手门槛。

本次部署基于阿里云云服务器ECS或轻量应用服务器实现，全程采用一键脚本自动化完成环境搭建、源码拉取、依赖安装、基础配置等工作，仅需少量手动填写核心参数，零基础用户也能在短时间内完成服务上线。同时本文完整讲解脚本使用、参数配置、端口放行、服务启停、后台常驻、开机自启、运维排错等全流程内容，附带所有可直接执行的终端命令与配置代码，全文不使用外部链接、表格、图片。无论你是第一次接触云服务器，还是没有任何编程、运维经验，按照本文流程操作，都可以顺利完成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项目兼容性最优的系统，也是一键脚本预设适配的系统版本，请勿更换为Windows Server、老旧CentOS等系统，会造成一键脚本执行失败、环境不兼容。

2.2 核心凭证与信息准备

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

该密钥是智能体与大模型通信的唯一凭证，属于隐私数据，务必妥善保存，禁止对外公开、明文上传至公共目录。同时记录好阿里云服务器公网IP地址、远程登录账号与密码，后续远程连接、外网访问Hermes Agent后台都需要使用公网IP。

2.3 远程连接阿里云服务器

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

三、一键部署前置操作与系统基础优化

在执行Hermes Agent一键部署脚本前，先完成系统基础更新与权限优化，保证脚本可以正常运行，规避权限不足、软件源失效等问题。

零基础部署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 赋予终端完整执行权限

为避免后续脚本执行出现权限拒绝报错，切换至普通管理员权限，同时确保目录读写权限正常：

sudo -i

执行后终端切换为管理员身份，后续所有命令均可直接运行，无需反复添加sudo提权。

3.3 规划项目存储目录

创建专属目录用于存放Hermes Agent项目文件、脚本与运行日志，统一管理文件，方便后期运维：

mkdir -p /data/ai_hermes
cd /data/ai_hermes

后续一键脚本、项目源码、日志文件均存放在该目录下。

四、Hermes Agent一键脚本部署核心流程

本节为本次教程核心部分，使用一键自动化脚本完成环境检测、Node.js安装、Git安装、源码克隆、依赖安装、基础配置初始化等全部繁琐步骤，全程只需复制命令执行，零基础也能轻松操作。

4.1 执行一键部署脚本

在当前/data/ai_hermes目录下，执行Hermes Agent一键部署脚本，脚本会自动检测系统环境、安装所需运行组件、拉取最新源码、安装项目依赖：

# 执行Hermes Agent一键部署脚本
bash hermes_agent_install.sh

脚本启动后会出现交互式提示，全程按照提示默认回车即可。脚本运行分为多个阶段：环境检测、基础工具安装、Node.js版本校验与升级、源码下载、依赖包安装。整个过程耗时根据服务器网络速度有所差异，请勿关闭终端、中断脚本运行。

4.2 脚本执行完成说明

当终端输出“一键部署基础环境完成，请手动配置.env文件并启动服务”字样时，代表自动化流程结束。此时系统环境、项目源码、项目依赖已全部部署完毕，仅剩核心配置文件参数填写、端口放行、服务启动三步操作。

4.3 进入项目根目录

脚本会自动生成项目文件夹，进入项目主目录开展后续配置工作：

cd Hermes-Agent

五、核心配置文件手动填写与参数详解

一键脚本仅完成基础初始化，大模型接口、调用密钥、服务端口、功能开关等核心参数，需要在.env配置文件中手动填写，这是决定智能体能否正常使用AI功能的关键步骤。

5.1 打开配置文件

使用系统自带文本编辑器打开环境配置文件：

vim .env

5.2 写入完整配置内容

进入编辑模式后，清空原有默认示例内容，粘贴下方完整配置，并将API_KEY替换为你在阿里云百炼申请的有效密钥，其余参数可保持默认，也可根据自身需求自定义修改：

# 阿里云百炼大模型固定接口地址，无需修改
MODEL_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
# 替换为个人阿里云百炼API密钥
API_KEY=你的百炼专属API_Key
# Hermes Agent对外访问端口，本次统一使用8090，可自定义修改
SERVER_PORT=8090
# 接口请求超时时间，单位秒，网络较差可适当调大
REQUEST_TIMEOUT=180
# 开启长会话记忆，保留多轮对话上下文（Hermes Agent核心功能）
SESSION_MEMORY=true
# 默认调用大模型名称
DEFAULT_MODEL=qwen3.7-plus
# 模型生成随机性，0-1区间，常规使用保持0.7
TEMPERATURE=0.7
# 开启运行日志记录，方便故障排查
LOG_ENABLE=true
# 日志等级
LOG_LEVEL=info
# 最大同时会话数量，限制访问人数，提升服务稳定性
MAX_SESSION=25

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

5.3 配置参数详细解读

1. MODEL_BASE_URL：对接阿里云百炼大模型的标准接口地址，固定不变，无需修改；
2. API_KEY：大模型调用身份凭证，填写错误会直接导致AI对话、推理功能失效；
3. SERVER_PORT：服务访问端口，本文统一使用8090，若自行修改端口，后续防火墙、安全组也必须同步修改；
4. SESSION_MEMORY：长会话记忆开关，开启后完整保留对话上下文，是Hermes Agent核心优势功能；
5. DEFAULT_MODEL：指定默认调用的大模型，可根据自身订阅套餐灵活切换型号；
6. REQUEST_TIMEOUT：接口超时时间，服务器网络延迟较高时，建议增大数值。

六、服务器防火墙与阿里云安全组端口放行

配置文件填写完成后，外网设备依然无法访问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地址，保存规则。至此外网访问的网络限制全部解除。

七、服务启动、后台常驻与功能测试

端口放行完成后，分三步操作：前台启动测试功能、切换后台常驻运行、访问页面验证全部功能，保证服务稳定可用。

7.1 前台启动服务（功能自检）

在Hermes Agent项目根目录下，执行前台启动命令，用于排查启动报错、验证基础环境：

npm start

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

打开本地浏览器，在地址栏输入服务器公网IP:8090，进入Hermes Agent后台界面。发送对话指令、进行多轮连续交流，测试长会话记忆、逻辑推理、模型回复等核心功能。若功能全部正常，使用快捷键终止前台进程。

7.2 后台常驻运行服务

前台测试无误后，使用nohup命令将服务转入后台运行，关闭远程终端、本地电脑关机都不会中断服务，同时将运行日志输出到指定文件：

# 后台启动服务，日志写入hermes_log.log文件
nohup npm start > hermes_log.log 2>&1 &

命令执行完成后，服务静默在后台运行。

7.3 实时查看运行日志

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

tail -f hermes_log.log

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

八、进阶配置：一键设置开机自启

云服务器意外断电、手动重启后，后台运行的服务会自动停止。为实现无人值守、服务器开机自动拉起Hermes Agent，配置系统开机自启脚本，属于长期运行必备优化。

8.1 编辑系统开机启动文件

Ubuntu系统通过/etc/rc.local实现开机自启，执行编辑命令：

sudo vim /etc/rc.local

在文件内exit 0上方，添加后台启动命令，严格填写项目完整路径：

# 开机自动启动Hermes Agent
cd /data/ai_hermes/Hermes-Agent && nohup npm start > hermes_log.log 2>&1 &

保存并退出编辑器。

8.2 赋予启动文件执行权限

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

sudo chmod +x /etc/rc.local

8.3 验证开机自启效果

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

sudo reboot

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

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

使用一键脚本部署完成后，日常运维仅需简单命令即可完成进程查看、服务启停、端口检测、日志清理、版本更新等操作，本节整理高频命令，方便新手长期维护。

9.1 查看服务运行进程

检查Hermes Agent是否正常在线：

ps aux | grep node

9.2 停止运行中的服务

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

pkill -f "npm start"

9.3 重启服务

修改配置文件、更新源码后，重启服务加载新内容：

cd /data/ai_hermes/Hermes-Agent
nohup npm start > hermes_log.log 2>&1 &

9.4 排查端口占用

启动服务提示端口被占用时，查询占用进程：

sudo lsof -i :8090

9.5 清空日志文件

日志长期堆积占用磁盘空间，定期一键清空：

> /data/ai_hermes/Hermes-Agent/hermes_log.log

9.6 项目版本更新

官方发布新版本后，一键更新项目：

cd /data/ai_hermes/Hermes-Agent
pkill -f "npm start"
git pull
npm install
nohup npm start > hermes_log.log 2>&1 &

十、常见故障排查与解决方案

结合一键部署场景下的高频问题，整理故障现象、原因与解决办法，新手遇到问题可直接对照排查。

10.1 一键脚本执行中断、提示权限不足

故障现象：运行bash hermes_agent_install.sh时脚本终止，提示permission denied。
解决方案：执行sudo -i切换管理员权限后，重新运行一键部署脚本。

10.2 脚本执行完成，npm install 依赖报错

故障现象：自动化流程结束后，手动启动服务提示模块缺失、版本不兼容。
解决方案：一键脚本会自动将Node.js升级至18.x及以上稳定版，若仍报错，清理缓存后重新安装依赖：

npm cache clean -f
npm install

10.3 服务启动正常，外网无法访问页面

故障现象：日志显示端口监听成功，公网IP+端口打不开界面。
解决方案：依次检查两处端口规则：服务器本地防火墙8090端口、阿里云安全组8090端口，两处必须全部放行。

10.4 页面可正常访问，发送对话无AI回复

故障现象：界面加载正常，提交问题后一直转圈无响应。
解决方案：进入.env文件，核对MODEL_BASE_URL地址与API_KEY密钥是否填写正确；测试服务器外网连通性；适当增大REQUEST_TIMEOUT超时参数。

10.5 修改配置文件后参数不生效

故障现象：修改端口、密钥、功能开关后，服务运行无变化。
解决方案：配置文件修改后，必须执行pkill -f "npm start"停止进程，再重新启动服务，新配置才会加载。

10.6 服务启动后自动闪退

故障现象：启动后短时间内服务停止。
解决方案：主要原因为服务器内存不足，关闭闲置进程释放资源；查看日志定位插件冲突、参数错误问题，内存不足建议升级服务器配置。

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

11.1 密钥安全管理

API Key是大模型调用核心凭证，严禁明文分享、上传至公共平台。定期在百炼平台查看用量统计，发现异常调用立即重置密钥，防止额度被盗用。

11.2 访问安全加固

对外公开使用时，为Hermes Agent设置登录账号密码，限制陌生IP访问；合理调整MAX_SESSION参数，避免大量并发拖垮服务。

11.3 资源优化

长期运行场景下，定期清理日志、阶段性重启服务释放内存；关闭非必要日志输出，降低服务器资源消耗。

11.4 脚本维护

保留一键部署脚本，后续重装、迁移服务器时可重复使用；不要随意修改脚本内部代码，避免破坏自动化逻辑。

十二、总结

本文基于2026年阿里云服务器环境，推出Hermes Agent一键部署方案，大幅简化传统手动部署的复杂流程，通过自动化脚本完成环境搭建、源码拉取、依赖安装等重复操作，真正做到零基础、零门槛入门。整个部署流程逻辑清晰、命令简单，即使是第一次接触云服务器与开源AI项目的新手，也能快速完成服务搭建。

将Hermes Agent部署在阿里云服务器中，摆脱了本地电脑关机、休眠、网络不稳的限制，实现7×24小时全天候在线。依托其强大的长会话记忆、复杂任务推理能力，搭配阿里云百炼大模型，可满足个人学习、办公辅助、团队协作等多样化使用需求。

文中不仅提供了一键部署脚本使用方法，还完整讲解了配置编写、端口放行、后台常驻、开机自启、日常运维、故障排查等全套内容，同时汇总大量实用命令与优化建议，兼顾短期使用与长期稳定运维。一键部署降低了上手难度，而完善的运维与排错内容，能够支撑用户长期正常使用。

按照本文流程完成部署后，你不仅可以正常使用Hermes Agent全部核心功能，还能掌握云服务器基础操作、一键脚本使用、Node.js项目运维等实用技能。后续可根据自身需求调整模型参数、切换大模型、优化访问权限，不断挖掘AI智能体的使用价值，让智能工具更好地服务于工作与生活。