零基础上手！阿里云ECS+Hermes Agent+百炼Token Plan部署详细步骤 含完整代码

一、部署前核心准备

1.1 账号与权限准备

部署阿里云ECS云服务器、Hermes Agent并对接百炼Token Plan，首要前提是拥有阿里云账号并完成实名认证。个人用户可通过支付宝刷脸快速完成认证，全程仅需10秒；企业用户需上传营业执照及法人信息，审核周期1-3个工作日。未完成实名认证的账号无法购买ECS实例、开通百炼大模型服务，这是所有操作的基础门槛。

完成认证后，需开通阿里云百炼大模型服务，新用户可自动领取超7000万免费Tokens，有效期90天，满足初期测试需求。核心是订阅百炼Token Plan团队版套餐，这是对接AI智能体的核心计费方案，2026年套餐分为三档：标准版198元/月（25000 Credits）、高级版698元/月（100000 Credits）、尊享版1398元/月（250000 Credits）。订阅后获取专属API Key（以sk-sp开头），该密钥为套餐专用，所有调用统一抵扣Credits，不产生额外按量费用。阿里云部署AI Agent：OpenClaw/Hermes Agent全网最简单，只需两步，详情访问阿里云OpenClaw/Hermes一键部署专题页面 了解。访问订阅阿里云百炼Token Plan AI大模型服务 。支持多模型切换，用于多模态模型灵活调用，实现多模型、多工具、多场景下的额度共享与统一管理，兼顾灵活性、稳定性与安全性，大幅降低企业使用大模型的门槛与成本。

1.2 ECS云服务器选型与环境配置

（1）ECS实例规格选择（2026年推荐）

ECS云服务器具备弹性算力、稳定运行、灵活管控等特点，是承载Hermes Agent的理想载体，2026年推荐以下配置：

• 入门级（新手首选）：2核4GB内存+40GB ESSD云盘+5Mbps带宽，操作系统优先选择Alibaba Cloud Linux 3或Ubuntu 22.04 LTS，预装所有依赖，兼容所有部署命令。内存≥4GB可确保Hermes Agent稳定运行，低于4GB会导致服务启动失败。
• 企业级（高并发场景）：4核8GB内存+80GB ESSD云盘+10Mbps带宽，支持弹性扩容，满足团队协作与大规模智能体部署需求。
• 地域选择：优先选择华北2（北京）或华东1（杭州），与百炼API Key地域一致，降低网络延迟。

（2）本地工具准备

• 远程连接工具：FinalShell、Xshell或阿里云Web终端，用于SSH连接ECS实例执行命令。
• 文本编辑器：用于保存Token Plan API Key、访问Token等敏感信息，避免丢失。

（3）核心依赖要求

Hermes Agent运行依赖Python3.9+、Node.js≥22.0.0、Git、Docker等。阿里云ECS官方镜像已预装部分依赖，新手可通过一键安装脚本自动补全，避免环境配置错误。

二、百炼Token Plan API Key获取（核心步骤）

2.1 订阅Token Plan套餐

1. 登录阿里云百炼大模型服务平台，进入Token Plan团队版订阅页面。
2. 选择对应套餐（标准版/高级版/尊享版），确认购买时长（单月/连续包月），新用户首月可享5折优惠。
3. 完成支付订阅，套餐立即生效，Credits额度自动到账。

2.2 创建专属API Key

1. 进入百炼控制台「API密钥管理」页面，点击「创建API Key」。
2. 选择「Token Plan专属API Key」（格式为sk-sp-xxxxxx），归属业务空间选择默认，权限选择全部。
3. 生成后立即复制保存，关闭弹窗后无法再次查看，严禁泄露给第三方。
4. 记录Token Plan专属Base URL：OpenAI兼容协议地址为https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1，Anthropic兼容协议地址为https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic。

三、ECS云服务器创建与登录（2026年最新流程）

3.1 创建ECS实例

1. 登录阿里云ECS控制台，点击「创建实例」。
2. 选择「按量付费」或「包年包月」，实例规格选择2核4GB，镜像选择Alibaba Cloud Linux 3或Ubuntu 22.04 LTS。
3. 系统盘选择40GB ESSD云盘，带宽选择5Mbps，地域选择华北2（北京）。
4. 设置登录密码（8-30位，含大小写字母+数字），完成购买。
5. 等待5-10分钟，ECS实例状态变为「运行中」，记录公网IP、登录账号（默认root）与密码。

3.2 登录ECS实例

1. 打开远程连接工具，输入ECS公网IP、端口22、账号root与密码，点击连接。
2. 首次登录需修改初始密码，设置新密码后进入ECS终端。
3. （可选）关闭ECS自动休眠功能，确保Hermes Agent 7×24小时运行。

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

  四、Hermes Agent安装（两种方式，按需选择）

  4.1 OOS扩展程序一键安装（零代码，推荐）

  步骤1：进入OOS扩展程序页面

1. 登录阿里云系统运维管理（OOS）控制台。
2. 在左侧导航栏，选择「服务器管理 > 扩展程序」。
3. 在公共扩展程序页签中，找到「Hermes Agent」扩展程序卡片。

步骤2：安装Hermes Agent

1. 点击「安装扩展程序」，选择需要安装的ECS实例。
2. 点击「创建」，等待3-5分钟，安装完成。

步骤3：验证安装

1. 通过SSH登录ECS实例，执行以下命令验证版本：

   hermes --version
   
   
   

2. 正常显示版本号（如0.14.0），代表安装成功。

4.2 命令行手动安装（灵活定制，企业级）

步骤1：安装基础依赖

# 更新系统包
sudo yum update -y  # Alibaba Cloud Linux
# 或
sudo apt update -y  # Ubuntu
# 安装基础工具
sudo yum install -y git curl wget python3 python3-pip  # Alibaba Cloud Linux
# 或
sudo apt install -y git curl wget python3 python3-pip  # Ubuntu
# 创建软链接
sudo ln -sf /usr/bin/python3 /usr/bin/python
sudo ln -sf /usr/bin/pip3 /usr/bin/pip

步骤2：一键安装Hermes Agent

# 执行官方一键安装脚本
curl -fsSL https://get.hermes.chat | bash
# 验证安装
hermes --version

安装成功后，终端显示「Hermes Agent installed successfully」。

五、Hermes Agent配置百炼Token Plan（核心步骤）

5.1 命令行一键配置（最推荐）

1. 执行以下命令，依次配置模型提供商、Base URL、API Key、默认模型：

   # 配置模型提供商为自定义
   hermes config set model.provider custom
   # 配置Token Plan专属Base URL（OpenAI兼容）
   hermes config set model.base_url https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
   # 配置API模式为openai_messages
   hermes config set model.api_mode openai_messages
   # 配置Token Plan专属API Key（替换为你的sk-sp密钥）
   hermes config set model.api_key sk-sp-xxxxxxxxxxxxxxxxxxxxxxxx
   # 设置默认模型为qwen3.7-max
   hermes config set model.default qwen3.7-max
   # 配置服务端口为18789
   hermes config set gateway.port 18789
   
   
   

2. 配置文件自动写入~/.hermes/config.yaml，可执行以下命令查看配置信息：

   hermes config get
   
   
   

5.2 手动编辑配置文件（高级定制）

1. 执行以下命令，打开Hermes Agent主配置文件：

   vim ~/.hermes/config.yaml
   
   
   

2. 写入以下配置内容（替换API Key为你的Token Plan密钥）：

   model:
   default: qwen3.7-max
   provider: custom
   base_url: https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
   api_mode: openai_messages
   api_key: sk-sp-xxxxxxxxxxxxxxxxxxxxxxxx
   temperature: 0.2
   max_tokens: 65536
   gateway:
   port: 18789
   host: 0.0.0.0
   
   
   

3. 保存文件（按Esc，输入:wq），退出编辑器。

六、端口放行与服务启动（关键步骤）

6.1 ECS安全组放行端口

1. 登录阿里云ECS控制台，进入目标ECS实例详情页。
2. 点击「安全组」→「配置规则」→「添加安全组规则」。
3. 放行18789端口（Hermes Agent默认端口），协议选择TCP，源地址选择0.0.0.0/0（允许所有IP访问）。
4. 点击「确定」保存规则，端口放行立即生效。

6.2 启动Hermes Agent服务

1. 执行以下命令，启动Hermes Agent网关服务：

   # 启动网关服务
   hermes gateway start
   # 查看服务状态
   hermes gateway status
   
   
   

2. 状态显示「running」即启动成功。
3. 访问http://ECS公网IP:18789进入WebUI管理界面，即可开始使用AI智能体功能。

七、部署后验证与常见问题（2026年避坑指南）

7.1 功能全面验证

1. 模型调用验证：在WebUI发送不同类型指令（文本生成、代码编写、问答），检查返回结果是否正常，无超时、报错现象。
2. Token消耗验证：登录百炼控制台，查看Token Plan Credits消耗记录，确认调用正常抵扣，无额外费用产生。
3. 稳定性验证：连续运行24小时，检查服务是否稳定，无自动断开、崩溃情况。
4. 外网访问验证：通过本地设备访问http://ECS公网IP:18789，确保WebUI可正常打开。

7.2 常见问题与解决方案

（1）Hermes Agent启动失败

• 原因：内存不足（低于4GB）、依赖未安装、端口被占用。
• 解决：升级ECS实例配置至4核8GB，重新执行一键安装命令，修改默认端口（如18790）。

（2）模型调用失败/无响应

• 原因：API Key错误、Base URL配置错误、地域不匹配、网络异常。
• 解决：核对Token Plan专属API Key（sk-sp开头），确认Base URL为https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1，确保ECS地域与API Key地域一致，检查网络连接。

（3）WebUI无法访问

• 原因：安全组未放行18789端口、防火墙拦截、公网IP异常。
• 解决：在ECS控制台放行18789端口，关闭ECS内部防火墙，重新获取公网IP。

（4）Token消耗异常

• 原因：默认模型选择过大、maxTokens设置过高、重复调用。
• 解决：将默认模型改为qwen-turbo，maxTokens设置为4096，优化调用逻辑避免重复请求。

八、2026年部署优化与进阶配置

8.1 性能优化

• 模型选择策略：日常轻量任务（文档处理、问答）使用qwen-turbo（性价比高），复杂任务（代码生成、长文本创作）使用qwen3.7-max。
• 资源限制：通过hermes config set命令限制单用户并发数、单次调用最大Token数，避免资源浪费。
• 缓存配置：开启Hermes Agent结果缓存，重复请求直接返回缓存内容，减少Token消耗。

8.2 安全配置

• 访问鉴权：启用Hermes Agent Token鉴权，生成管理员访问Token，禁止公网无鉴权访问。
• 数据加密：开启HTTPS传输加密，敏感信息（API Key、Token）加密存储，防止泄露。
• 权限管理：企业部署时划分管理员、普通用户权限，限制敏感操作（如配置修改、服务重启）。

8.3 运维管理

• 日志监控：配置日志收集工具，监控Hermes Agent运行状态、调用日志与错误信息，及时排查问题。
• 自动重启：设置ECS实例与Hermes Agent自动重启策略，服务异常时自动恢复，确保7×24小时在线。
• 版本更新：定期执行hermes update命令，更新至最新版本，获取最新功能与安全补丁。

九、总结

2026年阿里云ECS云服务器部署Hermes Agent并配置百炼Token Plan的流程已实现高度简化，新手可通过OOS扩展程序一键安装，10分钟内上线专属AI智能体，企业用户可通过命令行灵活定制部署方案。核心步骤包括账号认证、Token Plan订阅、API Key获取、ECS实例创建、Hermes Agent安装配置、端口放行与验证优化。

部署过程中需重点关注ECS内存要求（≥4GB）、API Key格式（sk-sp开头）、Base URL正确性与端口放行，避免常见错误。完成部署后，通过性能优化、安全配置与运维管理，可大幅提升AI智能体的稳定性、安全性与性价比，满足个人、团队与企业的不同场景需求，实现AI能力的高效落地与规模化应用。