游乐游手机版
首页/AI热点日报/热点详情

阿里云ECS部署Hermes Agent并配置百炼Coding Plan与Token Plan全流程

类型:热点整理2026-07-24
阿里云ECS部署Hermes Agent并对接百炼服务全攻略 本文将详细介绍如何在阿里云ECS实例上部署具备自我进化能力的AI智能体框架Hermes Agent,并成功对接阿里云百炼的Coding Plan与Token Plan两大订阅方案。通过本文,您可以构建一个稳定、高效的企业级AI智能体系统,

阿里云ECS部署Hermes Agent并对接百炼服务全攻略

本文将详细介绍如何在阿里云ECS实例上部署具备自我进化能力的AI智能体框架Hermes Agent,并成功对接阿里云百炼的Coding Plan与Token Plan两大订阅方案。通过本文,您可以构建一个稳定、高效的企业级AI智能体系统,实现跨会话记忆、经验沉淀和代码自动生成等核心功能。

一、核心概念:Hermes Agent与阿里云百炼订阅方案

在开始部署前,先了解这两个核心组件:

  • Hermes Agent:一个具备自我进化能力的AI智能体框架,核心优势包括跨会话持久化记忆、经验自动沉淀与技能复用。它能深度适配代码开发、任务自动化等场景,在云服务器上部署可实现7×24小时稳定运行
  • 阿里云百炼:提供Coding PlanToken Plan两种订阅方案,二者独立计费、互不兼容,均为Hermes Agent提供强大的模型能力支撑,是构建企业级AI智能体的核心基础设施。

Coding Plan面向个人开发者,提供固定月费套餐,按请求次数计量,专注于代码生成、交互式编程等轻量高频场景。Token Plan以Credits统一计量,覆盖个人与团队多档位套餐,兼容文本、图像生成等多类模型,适配更广泛的AI应用场景,且目前仅支持华北2(北京)地域。两种方案均需通过专属API Key与Base URL接入,凭证不可混用。

二、阿里云ECS实例创建与基础环境准备

(一)ECS实例创建全流程

  1. 登录阿里云ECS控制台,点击「创建实例」,付费模式按需选择:短期测试选按量付费,长期稳定运行选包年包月。
  2. 地域选择华北2(北京),与百炼Token Plan地域保持一致;实例规格推荐ecs.t6或ecs.e系列,2核2G及以上配置可满足Hermes Agent基础运行需求,内存不低于2GiB
  3. 系统镜像选择Ubuntu 22.04 64位公共镜像,系统盘配置为ESSD Entry 40GB,登录凭证优先选择SSH密钥对,创建后下载私钥文件(.pem)并妥善保管。
  4. 填写实例名称(如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官方扩展程序,无需手动配置环境与依赖,适合新手快速部署。

  1. 登录阿里云OOS控制台,左侧导航栏选择「服务器管理」→「扩展程序」。
  2. 在公共扩展程序页签中,找到「Hermes Agent」扩展程序卡片,点击「安装扩展程序」。
  3. 选择目标ECS实例,点击「创建」,等待安装任务完成(约1-3分钟)。
  4. 验证安装:通过SSH连接ECS实例,执行以下命令,输出版本信息即部署成功:
    hermes --version

方案二:命令行手动部署(适合自定义配置)

  1. 安装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
    
  2. 全局安装Hermes Agent最新版:
    npm install -g hermes-agent@latest
  3. 启动初始化向导,完成基础配置:
    hermes setup
  4. 验证安装:执行hermes --version,确认版本信息正常输出。

方案三:Docker容器部署(生产环境推荐)

  1. 安装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
    
  2. 创建Hermes Agent配置目录:
    mkdir -p ~/.hermes/config
  3. 编写Docker Compose配置文件:
    vim ~/.hermes/docker-compose.yml
    写入以下配置内容:
    version: '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
    
  4. 启动Docker容器:
    cd ~/.hermes
    docker-compose up -d
    
  5. 验证部署:执行docker ps,查看hermes-agent容器是否正常运行。

四、阿里云百炼Coding Plan与Token Plan开通及API Key获取

(一)开通百炼订阅服务

  1. 登录阿里云百炼控制台(bailian.console.aliyun.com),完成实名认证后自动开通基础服务。
  2. 开通Coding Plan:进入「Coding Plan」页面,选择Pro高级套餐(200元/月),完成支付后订阅生效。
  3. 开通Token Plan:进入「Token Plan」页面,个人版可选Lite、Standard、Pro三档,团队版可选标准、高级、尊享坐席三档,选择对应套餐并支付,目前仅支持华北2(北京)地域。

(二)获取专属API Key与Base URL

  1. 进入百炼控制台「API Key管理」页面,点击「创建API Key」。
  2. 填写API Key描述(如「Hermes Agent专用」),权限选择「全部」,归属业务空间保持默认。
  3. 点击「确定」创建,立即复制并保存完整API Key(关闭弹窗后无法再次查看):
    • Coding Plan专属API Key:以sk-开头
    • Token Plan专属API Key:以sk-sp-开头
  4. 记录对应Base URL(华北2地域):
    • Coding Plan:https://coding.dashscope.aliyuncs.com/v1
    • Token Plan:https://sp-api.aliyuncs.com/v1

五、Hermes Agent对接百炼Coding Plan与Token Plan配置

(一)环境变量配置(推荐,安全持久)

通过配置环境变量,实现Hermes Agent与百炼服务的自动对接,避免明文存储API Key。

  1. 编辑环境变量配置文件:
    vim ~/.bashrc
  2. 在文件末尾添加以下配置(替换为你的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"
    
  3. 生效环境变量配置:
    source ~/.bashrc

(二)Hermes Agent命令行配置

  1. 配置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
    
  2. 配置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
    

(三)配置文件手动编辑(进阶)

  1. 编辑Hermes Agent配置文件:
    vim ~/.hermes/config.json
  2. 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"
     }
    }
    }
    
  3. 保存退出后,重启Hermes Agent服务:
    # 命令行部署重启
    hermes restart
    # Docker部署重启
    cd ~/.hermes && docker-compose restart
    

(四)Web界面可视化配置

  1. 访问Hermes Agent Web界面(http://ECS公网IP:8080),登录后进入「设置」→「模型管理」。
  2. 点击「添加模型提供商」,分别选择「阿里云百炼Coding Plan」与「阿里云百炼Token Plan」。
  3. 粘贴对应API Key与Base URL,选择默认模型,点击「保存」并启用配置。
  4. 验证对接:在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团队版,支持多席位管理、用量分析,保障服务稳定性。

七、常见问题与避坑指南

  1. API Key认证失败:检查API Key是否正确复制,确认订阅方案与API Key匹配(Coding Plan用sk-开头,Token Plan用sk-sp-开头),Base URL是否对应华北2地域。
  2. Hermes Agent无法调用模型:检查ECS安全组是否放行8080端口,服务器网络是否正常,可通过ping coding.dashscope.aliyuncs.com测试连通性;确认模型提供商已启用,默认模型选择正确。
  3. Credits/请求额度消耗过快:在Hermes Agent中设置模型调用频率限制,优先选择低消耗模型(如qwen3.6-flash),避免批量自动化调用;定期查看百炼控制台用量详情,及时调整套餐档位。
  4. 服务启动失败:查看Hermes Agent日志(hermes logs),检查Node.js版本是否为18+,依赖是否完整安装;Docker部署时,确认容器端口映射正确,配置文件路径无误。
  5. 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智能体生态。

来源:https://developer.aliyun.com/article/1750699

相关热点

继续查看同栏目近期热点。

延伸阅读

补充最近整理过的热点入口。