Hermes Agent作为一款开源自进化AI智能体框架，凭借学习闭环、跨会话记忆、多端接入与长程自治能力，成为开发者与企业搭建专属智能助手的优选方案。阿里云计算巢提供Hermes Agent一键部署服务，无需手动配置复杂环境，即可快速搭建稳定运行的服务实例；搭配阿里云百炼Coding Plan与Token Plan，可无缝对接通义千问系列大模型，为Hermes Agent注入强大的AI核心能力。本文将从部署前准备、计算巢一键部署、百炼双Plan配置、功能验证与避坑指南五大维度，提供完整实战教程，帮助零基础用户快速完成Hermes Agent部署与大模型对接，解锁AI智能体全场景能力。

一、部署前置准备：资源与环境清单（必看）

在开始部署前，需完成以下准备工作，确保部署流程顺畅无中断：

（一）账号与权限准备

1. 注册并完成阿里云账号实名认证，确保账号无欠费，具备计算巢服务与轻量应用服务器购买权限。
2. 开通阿里云百炼（Model Studio）服务，用于后续获取Coding Plan与Token Plan的API密钥。
3. （可选）若需对接飞书、微信、Telegram等IM工具，提前准备对应平台的开发者账号与机器人权限。

（二）服务器资源配置

计算巢部署Hermes Agent推荐配置如下，可根据实际需求调整：

• 实例规格：2核4GB内存及以上（最低要求2GB内存，否则核心服务无法启动）。
• 操作系统：Alibaba Cloud Linux 3、Ubuntu 22.04/24.04、Debian 12等Linux系统（阿里云预装镜像已适配，无需手动配置）。
• 网络环境：实例需开通公网IP，确保能访问阿里云百炼大模型API，国内地域网络通畅即可。
• 付费类型：支持按量付费与包年包月，新手推荐按量付费，灵活控制成本。

（三）工具与信息准备

1. 本地电脑安装SSH工具（如FinalShell、Xshell），或直接使用阿里云Web终端，用于远程登录服务器执行命令。
2. 准备文本编辑器，用于保存API密钥、公网IP等敏感信息，避免丢失。
3. 提前规划Hermes Agent服务实例名称、地域（如华东1、华北2），便于后续快速选择。

   零基础部署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（最快方案）

  计算巢提供Hermes Agent社区版一键部署服务，全程可视化操作，无需手动安装依赖与配置环境，是新手首选部署方式。以下为详细步骤：

  步骤1：进入计算巢Hermes Agent部署页面

  登录阿里云控制台，搜索并进入「计算巢服务」，在服务市场搜索「Hermes Agent社区版」，或直接访问官方部署链接，进入部署配置页面。

步骤2：配置部署参数（核心步骤）

在部署配置页面，依次填写以下参数，确保信息准确：

1. 服务实例信息：填写自定义的服务实例名称（如Hermes-AI-Agent），选择部署地域（推荐就近地域，降低延迟）。
2. 资源配置：选择实例规格（推荐2核4GB），设置实例登录密码（需牢记，用于后续SSH登录），选择付费类型（按量付费/包年包月）。
3. 服务配置：此步骤可暂时留空，待部署完成后再配置百炼API密钥，避免部署过程中因密钥错误导致失败。
4. 确认询价：页面下方会显示配置对应的费用明细，确认无误后点击「下一步：确认订单」。

步骤3：提交订单并等待部署完成

1. 阅读并同意服务协议，点击「立即创建」，提交部署订单。
2. 系统自动开始创建实例与部署Hermes Agent，整个过程约3-5分钟，可在「服务实例」页面查看部署进度。
3. 当实例状态显示为「已部署」，且「立即使用」区域显示服务地址链接时，代表部署成功。

步骤4：获取实例公网IP与验证部署

1. 进入服务实例详情页，在「实例信息」中复制公网IP，保存至本地文本编辑器。
2. 打开浏览器，输入访问地址：http://你的计算巢公网IP:8080（默认端口8080），若正常加载Hermes Agent登录界面，则部署成功。

步骤5：初始化Hermes Agent（命令行操作）

部署完成后，需通过命令行完成Hermes Agent初始化，生成管理员Token，用于登录Web控制台。以下为详细命令（直接复制执行）：

# 1. SSH登录计算巢实例（替换为你的公网IP与密码）
ssh root@你的计算巢公网IP

# 2. 切换至root用户
sudo su root

# 3. 进入Hermes Agent安装目录
cd /opt/hermes-agent

# 4. 安装依赖（若缺失）
npm install

# 5. 一键初始化Hermes Agent（非交互式，自动配置基础环境）
hermes init --non-interactive --accept-risk --enable-skill-market

# 6. 后台启动Hermes Agent服务
hermes start --daemon

# 7. 生成管理员Token（复制保存，用于登录Web控制台）
hermes token generate --admin --allow-ip 0.0.0.0/0

执行完成后，会生成一串以hermes_开头的管理员Token，务必复制保存，后续登录Web控制台需使用。

三、阿里云百炼Coding Plan与Token Plan配置实战

Hermes Agent的核心AI能力依赖阿里云百炼大模型，Coding Plan与Token Plan是两种主流计费方案，分别适用于代码开发与通用场景。以下为两种方案的开通、API密钥获取与Hermes Agent对接全流程。

（一）方案一：Coding Plan配置（代码开发首选）

Coding Plan为固定月费订阅，按模型调用次数计量，内置Qwen3.7-Plus、Qwen3.5-Plus等8个模型，适合代码生成、项目开发等高频调用场景。

步骤1：开通Coding Plan

1. 登录阿里云百炼控制台，进入「Coding Plan」页面，选择Pro高级版（200元/月，每月至高90,000次请求），完成订阅支付。
2. 订阅成功后，进入「我的订阅」页面，点击「生成API Key」，复制以sk-sp-开头的API密钥（仅显示一次，妥善保存）。
3. 记录Coding Plan专属Base URL：https://coding.dashscope.aliyuncs.com/v1。

步骤2：Hermes Agent对接Coding Plan

1. SSH登录计算巢实例，进入Hermes Agent配置目录：

   cd /opt/hermes-agent/config
   

2. 编辑百炼配置文件（若不存在则创建）：

   vim bailian-coding.json
   

3. 写入以下配置内容，替换YOUR_CODING_API_KEY为你的Coding Plan API密钥：

   {
        
   "provider": "bailian-coding-plan",
   "api_key": "YOUR_CODING_API_KEY",
   "base_url": "https://coding.dashscope.aliyuncs.com/v1",
   "model": "qwen3.7-plus",
   "temperature": 0.7,
   "max_tokens": 4096
   }
   

4. 保存并退出编辑器（:wq），重启Hermes Agent服务使配置生效：

   hermes restart
   

（二）方案二：Token Plan配置（通用场景首选）

Token Plan按Token消耗抵扣Credits，分为个人版与团队版，支持通义千问全系列模型，适合日常问答、内容创作、多模态交互等通用场景。

步骤1：开通Token Plan

1. 进入阿里云百炼「Token Plan」页面，选择个人版或团队版套餐，完成订阅支付。
2. 订阅成功后，在「我的订阅」页面生成API Key，复制保存，并记录对应Base URL（个人版：https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1）。

步骤2：Hermes Agent对接Token Plan

1. 进入Hermes Agent配置目录，编辑Token Plan配置文件：

   cd /opt/hermes-agent/config
   vim bailian-token.json
   

2. 写入以下配置，替换YOUR_TOKEN_API_KEY为你的Token Plan API密钥：

   {
        
   "provider": "bailian-token-plan",
   "api_key": "YOUR_TOKEN_API_KEY",
   "base_url": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
   "model": "qwen3.7-plus",
   "temperature": 0.7,
   "max_tokens": 4096,
   "top_p": 0.9
   }
   

3. 保存退出，重启Hermes Agent服务：

   hermes restart
   

（三）双Plan切换配置（灵活适配场景）

若需在Coding Plan与Token Plan之间切换，无需修改配置文件，直接通过Hermes Agent命令行切换模型提供商：

# 切换至Coding Plan
hermes config set provider bailian-coding-plan

# 切换至Token Plan
hermes config set provider bailian-token-plan

# 重启服务生效
hermes restart

四、功能验证与测试：确保配置成功

完成部署与配置后，需通过以下步骤验证Hermes Agent与百炼大模型对接是否正常：

（一）Web控制台验证

1. 打开浏览器，访问http://你的计算巢公网IP:8080，使用之前生成的管理员Token登录。
2. 进入「Chat」对话窗口，发送测试指令（如“帮我写一个Python快速排序算法”），若模型正常返回结果，代表对接成功。

（二）命令行验证

1. SSH登录实例，执行以下命令测试大模型调用：
   ```bash

   测试Coding Plan调用

   hermes chat --provider bailian-coding-plan --message "解释什么是AI智能体"

测试Token Plan调用

hermes chat --provider bailian-token-plan --message "生成一份AI项目开发计划"

2. 若命令行正常返回模型响应，说明配置无误。

### （三）多模态功能测试
Hermes Agent支持图像输入，可测试视觉理解能力：
```bash
# 发送图片+文本指令（替换为你的图片URL）
hermes chat --image "https://example.com/product-screenshot.png" --message "根据这张截图生成HTML代码"

若模型返回对应的代码结果，代表多模态功能正常。

五、常见问题与避坑指南

（一）部署失败常见原因

1. 实例规格不足：内存低于2GB会导致Hermes Agent核心服务启动失败，务必选择2核4GB及以上配置。
2. 网络不通：实例未开通公网IP，或防火墙限制了8080端口，需在安全组中开放8080端口。
3. 密码设置错误：实例登录密码不符合复杂度要求，需包含大小写字母、数字与特殊符号。

（二）百炼配置失败解决方法

1. API密钥错误：复制API密钥时遗漏字符，或使用了错误Plan的密钥，需重新生成并核对。
2. Base URL错误：Coding Plan与Token Plan的Base URL不同，需严格按照教程填写。
3. 模型名称错误：需使用百炼支持的模型名称（如qwen3.7-plus、qwen3.5-plus），避免拼写错误。

（三）服务异常重启方法

若Hermes Agent服务异常，可通过以下命令重启：

# 计算巢实例内重启服务
/opt/.swas/run-cmd.sh restart

# 或使用Hermes Agent命令重启
hermes restart

六、总结

通过阿里云计算巢一键部署Hermes Agent，搭配阿里云百炼Coding Plan与Token Plan，可快速搭建功能完整的AI智能体服务。计算巢的可视化部署大幅降低了环境配置门槛，百炼双Plan则为Hermes Agent提供了灵活的AI能力支撑，无论是代码开发、办公自动化还是多模态交互，都能满足不同场景需求。

本教程覆盖从部署前准备到功能验证的全流程，包含详细的命令行操作与配置示例，零基础用户也能轻松上手。完成部署后，可进一步探索Hermes Agent的Skill扩展、GUI操作、长程自治等高级功能，结合阿里云百炼的强大模型能力，打造专属的AI智能助手，提升个人与企业的工作效率。