零基础上手！阿里云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套餐

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

2.2 创建专属API Key

进入百炼控制台「API密钥管理」页面，点击「创建API Key」。
选择「Token Plan专属API Key」（格式为sk-sp-xxxxxx），归属业务空间选择默认，权限选择全部。
生成后立即复制保存，关闭弹窗后无法再次查看，严禁泄露给第三方。
记录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实例

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

3.2 登录ECS实例

打开远程连接工具，输入ECS公网IP、端口22、账号root与密码，点击连接。
首次登录需修改初始密码，设置新密码后进入ECS终端。
（可选）关闭ECS自动休眠功能，确保Hermes Agent 7×24小时运行。
零基础部署AI Agent：OpenClaw/Hermes Agent喂饭级步骤流程
第一步：👉点击打开访问阿里云OpenClaw/Hermes Agent一键部署专题页面。

👉访问订阅阿里云百炼Token Plan AI大模型服务 。支持多模型切换，用于多模态模型灵活调用，实现多模型、多工具、多场景下的额度共享与统一管理，兼顾灵活性、稳定性与安全性，大幅降低企业使用大模型的门槛与成本。

第二步：👉打开选择阿里云轻量应用服务器，配置参考如下：

镜像：OpenClaw(或Hermes Agent)镜像（已经购买服务器的用户可以重置系统重新选择镜像）
实例：内存必须2GiB及以上。
地域：默认美国（弗吉尼亚），目前中国内地域（除香港）的轻量应用服务器，联网搜索功能受限。
时长：根据自己的需求及预算选择。

轻量应用服务器OpenClaw镜像.png

第三步：打开访问阿里云百炼大模型控制台，找到密钥管理，单击创建API-Key。

阿里云百炼密钥管理图.png

前往轻量应用服务器控制台，找到安装好OpenClaw的实例，进入「应用详情」放行18789端口、配置百炼API-Key、执行命令，生成访问OpenClaw的Token。
阿里云百炼密钥管理图2.png

端口放通：需要放通对应端口的防火墙，单击一键放通即可。
配置百炼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扩展程序页面

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

步骤2：安装Hermes Agent

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

步骤3：验证安装

通过SSH登录ECS实例，执行以下命令验证版本：
```
hermes --version
```
正常显示版本号（如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 命令行一键配置（最推荐）

执行以下命令，依次配置模型提供商、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

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

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

执行以下命令，打开Hermes Agent主配置文件：
```
vim ~/.hermes/config.yaml
```

写入以下配置内容（替换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

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

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

6.1 ECS安全组放行端口

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

6.2 启动Hermes Agent服务

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

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

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

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

7.1 功能全面验证

模型调用验证：在WebUI发送不同类型指令（文本生成、代码编写、问答），检查返回结果是否正常，无超时、报错现象。
Token消耗验证：登录百炼控制台，查看Token Plan Credits消耗记录，确认调用正常抵扣，无额外费用产生。
稳定性验证：连续运行24小时，检查服务是否稳定，无自动断开、崩溃情况。
外网访问验证：通过本地设备访问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能力的高效落地与规模化应用。

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

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