阿里云部署Hermes Agent保姆级教程：百炼Token Plan配置+零失败步骤流程

一、前言

2026年，AI智能体（Agent）已成为企业与个人提升效率的核心工具，Hermes Agent凭借轻量化、自进化、低Token消耗的优势，成为阿里云生态中最受欢迎的开源AI智能体框架之一。它能深度对接阿里云百炼大模型，实现代码生成、文件操作、终端执行、多平台交互等全场景能力，无需复杂开发即可拥有专属AI助手。

但新手部署Hermes Agent常面临三大痛点：服务器环境配置复杂、阿里云百炼Token Plan开通流程不清晰、API配置参数易出错导致服务无法启动。本文基于2026年最新阿里云生态与Hermes Agent稳定版，从部署前准备、阿里云轻量服务器一键部署、百炼Token Plan开通、API密钥配置、服务验证、常见问题排查六大维度，提供保姆级新手教程，全程零代码、零踩坑，15分钟即可完成部署并正常使用。阿里云部署 OpenClaw/Hermes Agent全网最简单，只需两步，详情👉访问阿里云OpenClaw/Hermes一键部署专题页面 了解。









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

二、部署前核心准备（新手必做，3分钟完成）

1. 阿里云账号与实名认证

Hermes Agent部署依赖阿里云服务器与百炼大模型服务，未完成实名认证的账号无法购买服务器、开通百炼服务及创建API密钥。

• 注册阿里云账号并完成个人/企业实名认证，确保账号无欠费、状态正常。
• 开通按量付费权限（非必须，但可避免服务器创建后因权限问题无法使用）。

2. 服务器配置要求（最低标准，低于必崩）

Hermes Agent对服务器资源有基础要求，新手推荐选择阿里云轻量应用服务器，性价比最高、部署最便捷：

• 最低配置：2核2G内存、40GiB ESSD系统盘（1G内存会导致服务频繁崩溃，无法稳定运行）。
• 推荐配置：2核4G内存，适合多任务并行、复杂Skill调用场景。
• 地域选择：优先选中国香港、新加坡等海外地域（免备案，网络兼容性更好，避免内地地域部分功能受限）。

3. 核心概念提前了解（避免配置混乱）

• Hermes Agent：AI智能体框架，负责任务调度、Skill管理、交互逻辑，本身无AI能力，需对接大模型。
• 阿里云百炼：阿里云一站式大模型开发与应用平台，整合通义千问系列及第三方模型，提供API调用、微调、智能体构建等全链路能力。
• Token Plan：百炼面向企业团队推出的订阅制服务，按坐席计费，含固定Credits额度，适合高频、稳定的大模型调用，成本可控。
• API Key：Hermes Agent对接百炼的核心凭证，包含Access Key ID与Access Key Secret，用于身份验证与调用授权。

三、阿里云轻量服务器一键部署Hermes Agent（核心步骤，10分钟搞定）

阿里云轻量应用服务器提供Hermes Agent官方应用镜像，预装所有运行环境（Python 3、Git、Docker等），新手无需手动配置依赖，一键即可完成部署。

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

步骤1：创建轻量应用服务器实例

1. 登录阿里云控制台，进入「轻量应用服务器」页面，点击「创建实例」。
2. 镜像选择：应用镜像 → 搜索「Hermes Agent 2026稳定版」（官方优化版，无环境问题）。
3. 实例规格：选择2核2G（最低）或2核4G（推荐），系统盘默认40GiB即可。
4. 地域：选择中国香港/新加坡（免备案，网络更稳定）。
5. 登录设置：设置root密码（包含大小写、数字、特殊符号，如Hermes@2026），务必牢记。
6. 购买时长：新手推荐月付（灵活试错），长期使用选年付（性价比更高）。
7. 提交订单并支付，等待1-3分钟，实例状态变为「运行中」，复制公网IP（后续访问必备）。

步骤2：放通核心端口（必做，否则无法访问）

Hermes Agent默认通过18789端口提供Web控制台与服务通信，必须在服务器防火墙与阿里云控制台同时放行。

方法一：控制台一键放行（推荐）

1. 进入轻量服务器实例详情页，切换到「应用详情」。
2. 找到「端口放通」模块，点击「一键放通18789端口」，系统自动配置防火墙规则。

方法二：手动命令放行（适合进阶用户）

1. 点击实例「远程连接」，使用root密码登录服务器。
2. 执行以下命令放行端口并重启防火墙：

   firewall-cmd --permanent --add-port=18789/tcp
   firewall-cmd --reload
   

3. 验证端口放行：firewall-cmd --list-ports，输出包含18789即为成功。

步骤3：服务器基础初始化（可选，提升稳定性）

登录服务器后，执行以下命令更新系统依赖并启动基础服务：

# 更新系统包
apt update && apt upgrade -y
# 启动Docker（Hermes Agent依赖容器运行）
systemctl start docker
systemctl enable docker
# 验证Docker状态
docker --version

四、阿里云百炼Token Plan开通与API Key获取（AI大脑激活）

Hermes Agent的核心AI能力来自阿里云百炼大模型，需开通Token Plan并获取API Key才能正常调用模型。

1. 开通阿里云百炼服务

1. 访问阿里云百炼控制台，使用已实名认证的阿里云账号登录。
2. 首次登录会自动触发服务开通，无需额外操作，新用户可免费领取7000万+ Tokens（每模型100万，90天有效期），足够新手使用1-3个月。

2. Token Plan开通（2026年5月最新套餐与价格）

Token Plan是百炼面向AI智能体、高频调用场景推出的订阅制服务，按坐席计费，含固定Credits额度，成本可控，避免按量付费超支。

套餐档位（2026年5月最新）

• 标准坐席：198元/月，含2.5万Credits，适合个人轻度使用、基础任务处理。
• 高级坐席：698元/月，含10万Credits，适合团队协作、高频复杂任务。
• 尊享坐席：1398元/月，含22万Credits，适合企业级大规模部署、多智能体并行。

  新用户优惠

  首次订阅Token Plan，首月享折扣：标准坐席148元/月、高级坐席558元/月、尊享坐席1118元/月。

  开通流程

1. 在百炼控制台左侧导航栏，找到「Token Plan」入口，点击进入。
2. 选择对应套餐（新手推荐标准坐席），点击「立即购买」，完成支付即可开通。
3. 开通后，系统自动分配Credits额度，可在「用量统计」中查看剩余额度。

3. 获取百炼API Key（核心凭证，仅显示一次）

1. 百炼控制台左侧导航栏，进入「密钥管理」（默认地域华北2（北京），无需修改）。
2. 点击「创建API-Key」，系统自动生成Access Key ID与Access Key Secret。
3. 务必复制保存到记事本，仅创建时显示一次，丢失需重新创建。
4. 安全提醒：API Key切勿泄露，避免第三方盗用导致额度损失；若泄露，立即删除并重新创建。

五、Hermes Agent配置Token Plan与API Key（最后一步，服务激活）

完成服务器部署与API Key获取后，需在Hermes Agent中配置百炼信息，实现AI能力对接。

步骤1：进入Hermes Agent容器编辑配置

1. 远程连接轻量服务器，执行命令进入Hermes Agent容器：

   docker exec -it hermes-agent bash
   

2. 编辑主配置文件config.yaml（核心配置文件，所有模型与服务参数均在此设置）：

   vi ~/.hermes/config.yaml
   

步骤2：配置百炼Token Plan参数（直接复制替换）

在配置文件中找到model模块，替换为以下内容（将你的API Key替换为实际获取的Access Key Secret）：

model:
  provider: custom
  base_url: https://dashscope.aliyuncs.com/compatible-mode/v1
  api_key: "你的Access Key Secret"
  default: qwen3.6-plus
  parameters:
    temperature: 0.2
    max_tokens: 4096
    stream: true
skills:
  auto_load: true
  safe_mode: true
agent:
  max_steps: 30
  memory: true

参数说明（新手无需修改，默认即可）

• provider：模型服务商，固定为custom。
• base_url：百炼兼容模式接口地址，固定不变。
• api_key：百炼API Key（Access Key Secret）。
• default：默认调用模型，qwen3.6-plus性价比最高，适合新手。
• temperature：生成随机性，0.2为精准模式，适合任务执行。
• max_tokens：单次最大输出长度，4096满足绝大多数场景。

步骤3：保存配置并重启Hermes Agent服务

1. 按Esc键，输入:wq保存配置文件并退出vi编辑器。
2. 退出容器并重启Hermes Agent服务，使配置生效：

   exit
   docker restart hermes-agent
   

3. 等待1分钟，服务重启完成。

步骤4：生成Hermes Agent访问Token（登录凭证）

1. 再次进入容器，执行命令生成管理员访问Token：

   docker exec -it hermes-agent bash
   hermes token generate --admin
   

2. 系统会生成一串唯一Token（如eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...），复制保存，后续登录Web控制台必备。
3. 退出容器：exit。

六、服务验证与首次使用（确认部署成功）

1. 访问Hermes Agent Web控制台

1. 打开浏览器，输入地址：http://服务器公网IP:18789。
2. 在登录页面粘贴之前生成的管理员Token，点击「登录」。
3. 成功进入控制台，显示Hermes Agent主界面，即为部署成功。

2. 测试AI功能（验证Token Plan调用）

1. 在控制台输入测试指令，如：帮我写一个Python快速排序代码。
2. 等待几秒，Hermes Agent会调用百炼qwen3.6-plus模型生成代码，若正常返回结果，说明Token Plan配置成功、模型调用正常。
3. 可在百炼控制台「用量统计」中查看Credits消耗情况，确认计费正常。

七、新手常见问题与避坑指南（部署必看）

1. 无法访问Web控制台（18789端口拒绝连接）

• 原因：端口未放行、服务器防火墙拦截、服务未启动。
• 解决：
  1. 检查阿里云控制台防火墙是否添加18789端口规则。
  2. 登录服务器执行firewall-cmd --list-ports，确认端口放行。
  3. 重启Hermes Agent服务：docker restart hermes-agent。

2. AI功能无响应，提示模型调用失败

• 原因：API Key错误、Token Plan未开通、额度用尽、网络异常。
• 解决：
  1. 核对config.yaml中api_key是否正确，无空格、无遗漏。
  2. 登录百炼控制台，确认Token Plan已开通、Credits有剩余。
  3. 检查服务器网络，执行ping dashscope.aliyuncs.com，确认可连通。

3. 服务器内存不足，服务频繁崩溃

• 原因：实例配置低于2核2G，或同时运行多个高消耗任务。
• 解决：升级服务器配置至2核4G，关闭不必要的Skill，减少并行任务数。

4. Token Plan额度消耗过快

• 原因：默认模型qwen3.6-plus虽性价比高，但复杂任务消耗较多；或未开启上下文缓存。
• 解决：
  1. 简单任务切换qwen-mini模型，降低消耗。
  2. 在配置文件中开启上下文缓存，重复内容可享10%折扣。
  3. 合理规划任务，避免高频重复调用。

八、总结

2026年，阿里云生态为Hermes Agent部署提供了极致便捷的解决方案，轻量服务器一键部署+百炼Token Plan订阅，让新手无需掌握复杂技术，即可快速拥有专属AI智能体。

本文从部署前准备、服务器创建、Token Plan开通、API配置到服务验证，全程提供可直接复制的命令与参数，覆盖新手所有可能遇到的问题与避坑要点。按照教程操作，15分钟即可完成部署，享受AI智能体带来的效率提升。

部署完成后，可进一步探索Hermes Agent的Skill生态，添加代码生成、信息检索、文件处理等功能，让AI助手更贴合个人需求。同时，合理使用Token Plan额度，结合百炼新用户免费Tokens，可实现低成本、高效率的AI应用。