Hermes Agent是一款轻量化、可自进化的AI智能体框架，能深度集成操作系统，实现任务自动化、工具调度与记忆持久化。在阿里云ECS云服务器上部署Hermes Agent，可快速搭建稳定的私有化AI服务环境，适配个人开发者、小型团队的AI应用需求。本教程从ECS实例创建、环境准备、两种部署方案（一键部署与手动部署）、百炼API Key配置、服务启动、功能验证到常见问题排查，提供零基础、保姆级全流程指导，新手可直接复制命令执行，确保顺利完成部署。
一、部署前准备：ECS实例创建与基础配置
1.1 选择ECS实例规格与操作系统
部署Hermes Agent需满足基础硬件与系统要求，避免因配置不足导致服务卡顿或启动失败。
- 实例规格：推荐2核4GiB内存及以上，公网带宽1M及以上；最低配置为2核2GiB内存，仅适合测试场景。
- 操作系统：优先选择Alibaba Cloud Linux 3、Ubuntu 22.04、CentOS 7+，兼容性最佳。
- 地域选择：选择就近地域（如华北2-北京、华东1-杭州），降低网络延迟；若需对外提供服务，内地地域需完成域名备案。
- 阿里云部署AI Agent：OpenClaw/Hermes Agent全网最简单，只需两步，详情👉访问阿里云OpenClaw/Hermes一键部署专题页面了解。
Token Plan Token最便宜/支持多模型切换：👉访问订阅阿里云百炼Token Plan AI大模型服务 。支持多模型切换，用于多模态模型灵活调用，实现多模型、多工具、多场景下的额度共享与统一管理，兼顾灵活性、稳定性与安全性，大幅降低企业使用大模型的门槛与成本。
1.2 创建ECS实例
- 登录阿里云控制台，进入ECS实例创建页面。
- 选择“自定义配置”，依次设置地域、可用区、实例规格（2核4GiB）、操作系统（Alibaba Cloud Linux 3）。
- 网络配置：选择默认VPC与交换机，公网带宽选择“按流量计费”或“固定带宽”，确保实例获取公网IP。
- 安全组：默认安全组需放行22端口（远程连接）、8090端口（Hermes Agent默认服务端口），后续可手动补充配置。
- 登录设置：设置root密码或绑定密钥对，牢记登录凭证。
- 确认配置并完成支付，等待实例创建完成（约3-5分钟）。
1.3 远程连接ECS实例
实例创建完成后，通过Workbench或SSH工具远程连接：
- Workbench连接：在ECS控制台实例列表中，点击目标实例的“远程连接”，选择“Workbench一键连接”，输入root密码登录。
- SSH连接：本地终端执行命令（替换为公网IP与密码）：
ssh root@ECS公网IP
零基础部署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 的地址。
二、方案一：ECS一键部署（推荐新手）
阿里云ECS提供扩展程序一键部署功能，无需手动处理依赖，5分钟即可完成安装。
2.1 安装扩展程序
- 登录ECS实例后，进入“运维与监控”→“扩展程序”页面。
- 搜索“Hermes Agent”，选择官方扩展程序，点击“安装”。
- 系统自动下载安装包、配置依赖、注册服务，等待安装完成（约2分钟）。
2.2 验证安装结果
安装完成后，执行版本查询命令，确认安装成功：
hermes --version
正常输出应包含完整版本号（如v2026.2.9-cn），无报错提示。
三、方案二：手动部署（适合自定义配置）
手动部署适合需要自定义安装路径、调整配置的用户，需手动安装依赖、克隆代码、配置服务。
3.1 安装系统依赖
根据操作系统执行对应命令，安装Git、Python3等基础依赖：
- Alibaba Cloud Linux 3/CentOS：
sudo yum update -y sudo yum install -y git python3 python3-devel python3-pip sudo ln -s /usr/bin/python3 /usr/bin/python sudo ln -s /usr/bin/pip3 /usr/bin/pip - Ubuntu：
sudo apt update -y sudo apt install -y git python3 python3-pip sudo ln -s /usr/bin/python3 /usr/bin/python sudo ln -s /usr/bin/pip3 /usr/bin/pip
3.2 配置Python环境
升级pip并配置国内镜像源，加速依赖安装：
pip install --upgrade pip
pip config set global.index-url https://pypi.npmmirror.com/simple
3.3 克隆Hermes Agent代码
创建安装目录，克隆官方仓库：
mkdir -p /opt/ai-agent
cd /opt/ai-agent
git clone https://github.com/NousResearch/Hermes-Agent.git
cd Hermes-Agent
3.4 执行安装脚本
运行官方安装脚本，自动配置环境与服务：
chmod +x scripts/install.sh
sudo scripts/install.sh
安装完成后，系统会创建专用用户agentuser，需切换至该用户执行后续配置：
su - agentuser
四、配置百炼API Key（核心步骤）
Hermes Agent需对接阿里云百炼大模型服务，需提前获取并配置API Key，确保模型调用正常。
4.1 获取百炼API Key
- 登录阿里云百炼控制台，进入“API密钥管理”页面。
- 点击“创建API密钥”，选择默认工作区，生成专属API Key。
- 复制API Key（格式：sk-xxx），妥善保存，避免泄露。
- 确认API Key对应的地域与ECS实例地域一致，否则会导致模型调用失败。
4.2 初始化Hermes配置
切换至agentuser用户，执行交互式配置向导：
hermes setup
按照提示依次配置：
- 选择模型提供商：输入
bailian（阿里云百炼）。 - 输入百炼API Key：粘贴复制的密钥。
- 选择默认模型：推荐
qwen3.7-max或qwen3.5-plus。 - 配置服务端口：默认8090，可自定义。
- 开启记忆持久化：选择
yes，保存对话历史。
配置完成后，生成核心配置文件~/.hermes/config.yaml，可手动修改参数。
五、端口放行与网络配置
需同时放行ECS安全组与本地防火墙端口，确保外网可访问Hermes Agent服务。
5.1 阿里云安全组配置
- 进入ECS控制台，找到目标实例的安全组。
- 编辑入方向规则，新增规则：
- 协议：TCP
- 端口范围：8090
- 授权对象：0.0.0.0/0（允许所有IP访问）
- 描述：Hermes Agent服务端口
- 保存规则，等待生效（约1分钟）。
5.2 本地防火墙放行
根据操作系统执行命令，放行8090端口：
- Alibaba Cloud Linux 3/CentOS（firewalld）：
sudo firewall-cmd --add-port=8090/tcp --permanent sudo firewall-cmd --reload sudo firewall-cmd --list-ports - Ubuntu（ufw）：
命令输出显示8090端口已放行，代表配置完成。sudo ufw allow 8090/tcp sudo ufw reload sudo ufw status
六、服务启动与后台运行
6.1 前台启动（测试用）
前台启动服务，实时查看日志，验证功能：
hermes gateway
正常日志应包含“Server listening on 0.0.0.0:8090”“Model loaded successfully”等信息，无报错。
6.2 后台常驻（生产用）
使用nohup或systemd将服务转为后台运行，避免终端关闭后服务终止：
- nohup方式：
nohup hermes gateway > ~/.hermes/logs/gateway.log 2>&1 & - systemd方式（推荐）：
```bash创建服务文件
sudo tee /etc/systemd/system/hermes-gateway.service <<EOF
[Unit]
Description=Hermes Agent Gateway Service
After=network.target
[Service]
User=agentuser
WorkingDirectory=/opt/ai-agent/Hermes-Agent
ExecStart=/usr/local/bin/hermes gateway
Restart=always
[Install]
WantedBy=multi-user.target
EOF
加载并启动服务
sudo systemctl daemon-reload
sudo systemctl start hermes-gateway
sudo systemctl enable hermes-gateway
sudo systemctl status hermes-gateway
服务状态显示“active (running)”，代表后台运行成功。
## 七、功能验证与使用
### 7.1 Web控制台访问
在浏览器中输入地址：`http://ECS公网IP:8090`，访问Hermes Agent Web控制台，可查看服务状态、日志、配置信息。
### 7.2 命令行交互测试
在ECS终端执行命令，与智能体交互：
```bash
hermes run "创建一个test.txt文件，写入'Hermes Agent部署成功'，并返回文件路径"
验证结果：
- 智能体自动拆解任务，调用文件工具完成操作。
- 生成
test.txt文件，内容正确。 - 终端返回文件路径，任务状态显示“Completed”。
7.3 模型调用验证
执行复杂任务，验证模型调用正常：
hermes run "总结以下内容：阿里云ECS是弹性计算服务，支持快速创建、扩容云服务器，适合部署AI智能体。Hermes Agent是轻量化AI框架，可实现任务自动化。"
智能体应返回准确的总结内容，无模型调用失败、响应错乱问题。
八、常见问题排查
8.1 安装脚本执行失败
- 原因：网络异常、权限不足、Git未安装。
- 解决：切换root用户执行；安装Git（
sudo yum install git -y）；使用国内镜像源重试。
8.2 服务启动失败（端口占用）
- 原因：8090端口被其他进程占用。
- 解决：执行
lsof -i :8090查看占用进程，关闭后重启服务；或修改配置文件端口。
8.3 模型调用失败（401/503错误）
- 原因：API Key错误、地域不匹配、百炼额度耗尽。
- 解决：核对API Key有效性；确保ECS与百炼地域一致；检查百炼控制台额度。
8.4 Web控制台无法访问
- 原因：安全组未放行端口、本地防火墙拦截、服务未启动。
- 解决：检查安全组与防火墙配置；重启Hermes服务。
8.5 服务重启后记忆丢失
- 原因：未开启记忆持久化、配置文件错误。
- 解决：执行
hermes setup重新开启记忆功能；核对config.yaml中记忆配置。
九、总结
阿里云ECS部署Hermes Agent有一键部署与手动部署两种方案，新手推荐使用扩展程序一键部署，快速完成安装；进阶用户可选择手动部署，自定义配置。核心步骤包括ECS实例创建、依赖安装、百炼API Key配置、端口放行、服务启动与功能验证。部署完成后，可通过Web控制台与命令行交互使用Hermes Agent，实现AI任务自动化、工具调度与记忆持久化。日常使用中，建议定期检查服务状态、更新配置，遇到问题可通过日志排查，确保智能体稳定运行。
