阿里云ECS部署Hermes Agent并对接百炼服务全攻略
本文将详细介绍如何在阿里云ECS实例上部署具备自我进化能力的AI智能体框架Hermes Agent,并成功对接阿里云百炼的Coding Plan与Token Plan两大订阅方案。通过本文,您可以构建一个稳定、高效的企业级AI智能体系统,实现跨会话记忆、经验沉淀和代码自动生成等核心功能。
一、核心概念:Hermes Agent与阿里云百炼订阅方案
在开始部署前,先了解这两个核心组件:
- Hermes Agent:一个具备自我进化能力的AI智能体框架,核心优势包括跨会话持久化记忆、经验自动沉淀与技能复用。它能深度适配代码开发、任务自动化等场景,在云服务器上部署可实现7×24小时稳定运行。
- 阿里云百炼:提供Coding Plan与Token Plan两种订阅方案,二者独立计费、互不兼容,均为Hermes Agent提供强大的模型能力支撑,是构建企业级AI智能体的核心基础设施。
Coding Plan面向个人开发者,提供固定月费套餐,按请求次数计量,专注于代码生成、交互式编程等轻量高频场景。Token Plan以Credits统一计量,覆盖个人与团队多档位套餐,兼容文本、图像生成等多类模型,适配更广泛的AI应用场景,且目前仅支持华北2(北京)地域。两种方案均需通过专属API Key与Base URL接入,凭证不可混用。
二、阿里云ECS实例创建与基础环境准备
(一)ECS实例创建全流程
- 登录阿里云ECS控制台,点击「创建实例」,付费模式按需选择:短期测试选按量付费,长期稳定运行选包年包月。
- 地域选择华北2(北京),与百炼Token Plan地域保持一致;实例规格推荐ecs.t6或ecs.e系列,2核2G及以上配置可满足Hermes Agent基础运行需求,内存不低于2GiB。
- 系统镜像选择Ubuntu 22.04 64位公共镜像,系统盘配置为ESSD Entry 40GB,登录凭证优先选择SSH密钥对,创建后下载私钥文件(.pem)并妥善保管。
- 填写实例名称(如hermes-agent-server),确认配置后创建实例,创建完成后记录实例公网IP,用于后续远程连接与服务访问。
(二)安全组端口放行配置
登录ECS控制台,进入实例安全组页面,放行以下核心端口,确保Hermes Agent服务与远程连接正常:
- 22端口:SSH远程连接服务器专用端口
- 8080端口:Hermes Agent Web管理界面默认端口
- 443端口:HTTPS安全访问端口(可选,后续配置SSL时启用)
通过SSH连接ECS实例后,执行以下命令配置防火墙:
# 放行22端口
sudo ufw allow 22/tcp
# 放行8080端口
sudo ufw allow 8080/tcp
# 启用防火墙
sudo ufw enable
# 查看防火墙状态,确认端口放行
sudo ufw status
(三)SSH远程连接与系统初始化
Windows系统可使用MobaXterm、Xshell等工具,Mac/Linux系统直接通过终端执行SSH连接命令:
# 替换为你的私钥文件路径与ECS公网IP
ssh -i "your-key.pem" root@你的ECS公网IP
连接成功后,执行系统更新命令,确保软件包为最新版本:
apt update && apt upgrade -y
三、Hermes Agent在阿里云ECS上的部署(三种方案任选)
方案一:OOS扩展程序一键部署(官方推荐,零配置)
阿里云OOS系统运维管理提供Hermes Agent官方扩展程序,无需手动配置环境与依赖,适合新手快速部署。
- 登录阿里云OOS控制台,左侧导航栏选择「服务器管理」→「扩展程序」。
- 在公共扩展程序页签中,找到「Hermes Agent」扩展程序卡片,点击「安装扩展程序」。
- 选择目标ECS实例,点击「创建」,等待安装任务完成(约1-3分钟)。
- 验证安装:通过SSH连接ECS实例,执行以下命令,输出版本信息即部署成功:
hermes --version
方案二:命令行手动部署(适合自定义配置)
- 安装Node.js环境(Hermes Agent依赖Node.js 18+版本):
# 安装Node.js 20 LTS curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt install -y nodejs # 验证安装 node -v npm -v - 全局安装Hermes Agent最新版:
npm install -g hermes-agent@latest - 启动初始化向导,完成基础配置:
hermes setup - 验证安装:执行
hermes --version,确认版本信息正常输出。
方案三:Docker容器部署(生产环境推荐)
- 安装Docker与Docker Compose:
# 安装Docker sudo apt install docker.io -y sudo systemctl start docker sudo systemctl enable docker # 免sudo执行Docker(需重新登录生效) sudo usermod -aG docker $USER # 安装Docker Compose sudo apt install docker-compose -y - 创建Hermes Agent配置目录:
mkdir -p ~/.hermes/config - 编写Docker Compose配置文件:
写入以下配置内容:vim ~/.hermes/docker-compose.ymlversion: '3' services: hermes-agent: image: nousresearch/hermes-agent:latest container_name: hermes-agent restart: always ports: - "8080:8080" volumes: - ~/.hermes/config:/root/.hermes environment: - NODE_ENV=production - 启动Docker容器:
cd ~/.hermes docker-compose up -d - 验证部署:执行
docker ps,查看hermes-agent容器是否正常运行。
四、阿里云百炼Coding Plan与Token Plan开通及API Key获取
(一)开通百炼订阅服务
- 登录阿里云百炼控制台(bailian.console.aliyun.com),完成实名认证后自动开通基础服务。
- 开通Coding Plan:进入「Coding Plan」页面,选择Pro高级套餐(200元/月),完成支付后订阅生效。
- 开通Token Plan:进入「Token Plan」页面,个人版可选Lite、Standard、Pro三档,团队版可选标准、高级、尊享坐席三档,选择对应套餐并支付,目前仅支持华北2(北京)地域。
(二)获取专属API Key与Base URL
- 进入百炼控制台「API Key管理」页面,点击「创建API Key」。
- 填写API Key描述(如「Hermes Agent专用」),权限选择「全部」,归属业务空间保持默认。
- 点击「确定」创建,立即复制并保存完整API Key(关闭弹窗后无法再次查看):
- Coding Plan专属API Key:以
sk-开头 - Token Plan专属API Key:以
sk-sp-开头
- Coding Plan专属API Key:以
- 记录对应Base URL(华北2地域):
- Coding Plan:
https://coding.dashscope.aliyuncs.com/v1 - Token Plan:
https://sp-api.aliyuncs.com/v1
- Coding Plan:
五、Hermes Agent对接百炼Coding Plan与Token Plan配置
(一)环境变量配置(推荐,安全持久)
通过配置环境变量,实现Hermes Agent与百炼服务的自动对接,避免明文存储API Key。
- 编辑环境变量配置文件:
vim ~/.bashrc - 在文件末尾添加以下配置(替换为你的API Key):
# 配置Coding Plan凭证 export CODING_PLAN_API_KEY="sk-xxx" export CODING_PLAN_BASE_URL="https://coding.dashscope.aliyuncs.com/v1" # 配置Token Plan凭证 export TOKEN_PLAN_API_KEY="sk-sp-xxx" export TOKEN_PLAN_BASE_URL="https://sp-api.aliyuncs.com/v1" - 生效环境变量配置:
source ~/.bashrc
(二)Hermes Agent命令行配置
- 配置Coding Plan模型提供商:
# 设置模型提供商为阿里云百炼Coding Plan hermes model set provider aliyun-bailian-coding # 配置API Key hermes model set api-key "$CODING_PLAN_API_KEY" # 配置Base URL hermes model set base-url "$CODING_PLAN_BASE_URL" # 选择默认模型(如qwen3.7-plus) hermes model set model qwen3.7-plus # 启用Coding Plan提供商 hermes model set enabled true - 配置Token Plan模型提供商:
# 设置模型提供商为阿里云百炼Token Plan hermes model set provider aliyun-bailian-token # 配置API Key hermes model set api-key "$TOKEN_PLAN_API_KEY" # 配置Base URL hermes model set base-url "$TOKEN_PLAN_BASE_URL" # 选择默认模型(如qwen3.8-max-preview) hermes model set model qwen3.8-max-preview # 启用Token Plan提供商 hermes model set enabled true
(三)配置文件手动编辑(进阶)
- 编辑Hermes Agent配置文件:
vim ~/.hermes/config.json - 在
modelProviders节点下添加以下配置:{ "modelProviders": { "aliyun-bailian-coding": { "apiKey": "sk-xxx", "baseUrl": "https://coding.dashscope.aliyuncs.com/v1", "enabled": true, "model": "qwen3.7-plus" }, "aliyun-bailian-token": { "apiKey": "sk-sp-xxx", "baseUrl": "https://sp-api.aliyuncs.com/v1", "enabled": true, "model": "qwen3.8-max-preview" } } } - 保存退出后,重启Hermes Agent服务:
# 命令行部署重启 hermes restart # Docker部署重启 cd ~/.hermes && docker-compose restart
(四)Web界面可视化配置
- 访问Hermes Agent Web界面(
http://ECS公网IP:8080),登录后进入「设置」→「模型管理」。 - 点击「添加模型提供商」,分别选择「阿里云百炼Coding Plan」与「阿里云百炼Token Plan」。
- 粘贴对应API Key与Base URL,选择默认模型,点击「保存」并启用配置。
- 验证对接:在Web界面发送测试请求,确认模型调用正常。
六、订阅方案计费规则与选型建议
(一)Coding Plan计费规则
- 仅提供Pro套餐,200元/月,每日限量发售。
- 按请求次数计量,包含月度固定请求额度,适合代码生成、交互式编程等高频轻量场景。
- 支持Qwen3.5-Plus、Kimi K2.5等文本生成模型,专注于AI编码能力。
(二)Token Plan计费规则
- 个人版:Lite、Standard、Pro三档,按Credits统一抵扣,不同模型消耗系数不同。
- 团队版:标准坐席(198元/月/坐席,含2.5万Credits)、高级坐席(698元/月/坐席,含10万Credits)、尊享坐席(1398元/月/坐席,含25万Credits)。
- 支持文本、图像生成模型,兼容Hermes Agent、Cursor等主流AI工具,适配多场景AI应用。
(三)方案选型建议
- 个人开发者专注代码开发:优先选择Coding Plan,固定月费成本可控,专注编码场景。
- 团队协作、多模型混合使用:选择Token Plan,Credits统一计量,灵活适配文本、图像等多类模型需求。
- 生产环境部署:建议选择Token Plan团队版,支持多席位管理、用量分析,保障服务稳定性。
七、常见问题与避坑指南
- API Key认证失败:检查API Key是否正确复制,确认订阅方案与API Key匹配(Coding Plan用
sk-开头,Token Plan用sk-sp-开头),Base URL是否对应华北2地域。 - Hermes Agent无法调用模型:检查ECS安全组是否放行8080端口,服务器网络是否正常,可通过
ping coding.dashscope.aliyuncs.com测试连通性;确认模型提供商已启用,默认模型选择正确。 - Credits/请求额度消耗过快:在Hermes Agent中设置模型调用频率限制,优先选择低消耗模型(如qwen3.6-flash),避免批量自动化调用;定期查看百炼控制台用量详情,及时调整套餐档位。
- 服务启动失败:查看Hermes Agent日志(
hermes logs),检查Node.js版本是否为18+,依赖是否完整安装;Docker部署时,确认容器端口映射正确,配置文件路径无误。 - Web界面无法访问:检查ECS公网IP是否正确,防火墙是否放行8080端口;Docker部署时,确认容器正常运行,端口未被占用。
八、总结与扩展应用
通过本教程,您可以在阿里云ECS上完成Hermes Agent的稳定部署,并成功对接阿里云百炼Coding Plan与Token Plan订阅服务,构建起具备自我进化能力的AI智能体系统。Hermes Agent依托ECS的弹性算力,结合百炼的强大模型能力,可实现跨会话记忆、经验沉淀、代码自动生成等核心功能,大幅提升开发与任务自动化效率。
后续可进一步扩展Hermes Agent的应用场景:对接钉钉、企业微信等办公渠道,实现智能消息处理;集成本地模型(如Ollama)实现离线AI能力;结合阿里云函数计算、对象存储等服务,构建端到端的AI自动化工作流。同时,可根据业务需求灵活切换Coding Plan与Token Plan,平衡成本与功能,打造专属的企业级AI智能体生态。
