在AI智能体开发与应用的浪潮中,Hermes Agent凭借其自进化能力与多端适配特性,成为开发者构建个性化AI助手的优选工具。而阿里云计算巢提供的一键式部署能力,搭配百炼平台的Coding Plan与Token Plan,可实现从环境搭建到模型服务对接的全流程自动化,大幅降低AI智能体的部署门槛与运维成本。本文将从准备工作、计算巢部署、百炼计划配置、服务验证与优化等环节,详细拆解Hermes Agent的完整部署与配置流程,帮助开发者快速搭建稳定、高效的AI智能体服务。
一、部署前准备工作
1.1 账号与权限准备
首先需完成阿里云账号注册与实名认证,这是使用计算巢与百炼服务的基础前提。登录阿里云控制台后,进入百炼大模型服务平台,阅读并同意服务协议,完成百炼服务开通。同时,确保账号具备计算巢服务的使用权限,若为子账号操作,需由主账号授予计算巢管理权限与百炼API调用权限,避免部署过程中出现权限不足问题。
1.2 资源与环境规划
计算巢部署Hermes Agent会自动创建ECS实例,建议提前规划部署地域(优先选择华东1、华北2等主流地域,保障网络稳定性)、实例规格(入门级推荐ecs.c6.large(2vCPU/4GiB),满足基础运行需求;企业级场景可选择ecs.g7.2xlarge及以上规格)。同时,需预留账户余额(按量付费模式下余额不低于100元),避免因欠费导致部署中断。
1.3 百炼计划开通与API Key获取
百炼的Coding Plan与Token Plan是Hermes Agent调用大模型服务的核心支撑,两者适用场景与计费模式不同,需提前开通并获取专属凭证:
- Token Plan:适用于多模型灵活切换、全模态AI服务场景,按Token消耗计费,支持Qwen系列、DeepSeek等数十种模型,提供OpenAI兼容接口,适配Hermes Agent的自定义模型配置。开通后在Token Plan控制台的我的订阅页面生成API Key(以
sk-sp-开头)与Base URL(OpenAI兼容地址:https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1)。 - Coding Plan:专为代码开发场景设计,按模型调用次数计费,支持Qwen Code等编程专用模型,每5小时提供固定调用额度,适合开发者日常代码辅助、智能编程需求。开通后在Coding Plan控制台获取专属API Key与Base URL,格式与Token Plan类似但不可混用。
关键提醒:API Key仅在生成时完整显示一次,需立即复制并妥善保存,避免泄露;若不慎丢失,需重新生成,原密钥将立即失效。
零基础部署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
计算巢是阿里云推出的一站式服务部署与管理平台,支持一键部署各类开源软件与AI工具,Hermes Agent已上架计算巢服务目录,无需手动配置环境、安装依赖,全程可视化操作,5-10分钟即可完成部署。
2.1 进入计算巢部署页面
登录阿里云控制台,搜索并进入计算巢服务,在左侧导航栏选择服务目录,通过搜索框输入“Hermes Agent”,找到对应的服务卡片(社区版/企业版),点击正式创建进入部署配置页面。也可直接通过Hermes Agent官方部署链接跳转,快速进入配置界面。
2.2 配置服务实例参数
在部署配置页面,需完成以下核心参数设置,其余参数保持默认即可:
- 基本信息:自定义服务实例名称(如“hermes-agent-prod”),选择部署地域(与百炼计划开通地域保持一致,减少网络延迟)。
- 资源配置:选择ECS实例规格(前文规划的规格),设置实例登录密码(长度8-30位,包含大小写字母、数字与特殊符号),付费类型默认选择按量付费,支持随时释放资源、灵活控制成本。
- 应用配置:勾选预配置百炼Token Plan(若需同时配置Coding Plan,可后续手动调整),粘贴提前获取的Token Plan API Key与Base URL;若需直接配置Coding Plan,可选择对应选项并填入Coding Plan凭证。
- 网络配置:勾选开启公网访问,计算巢将自动配置安全组规则,放行Hermes Agent所需端口(如8080、9090),无需手动设置。
2.3 提交部署并等待完成
参数配置完成后,点击下一步:确认订单,核对配置信息与费用预估,勾选服务协议,点击立即创建。此时计算巢进入自动化部署流程:自动创建ECS实例、挂载系统盘、拉取Hermes Agent镜像、安装Python依赖、配置环境变量、启动服务,全程无需人工干预。
在计算巢服务实例列表中,可查看部署状态,初始状态为“部署中”,等待5-10分钟后,状态变为“运行中”,即表示部署完成。此时可复制ECS实例的公网IP,用于后续访问Hermes Agent WebUI与远程连接。
2.4 远程连接ECS实例
部署完成后,需通过远程连接进入ECS实例,验证Hermes Agent安装状态并进行后续配置。操作步骤如下:
- 在计算巢服务实例详情页,切换至资源页签,找到对应的ECS实例,点击远程连接。
- 选择Workbench免密登录,若弹出“服务关联角色”提示,点击确定创建角色;若登录失败,点击一键加白,完成安全组白名单配置后重新登录。
- 登录成功后,进入Linux终端控制台,默认用户为root,可直接执行Hermes Agent相关命令。
三、Hermes Agent配置百炼Coding Plan与Token Plan
计算巢部署时已预配置基础的Token Plan信息,但为实现Coding Plan与Token Plan的灵活切换、精细化配置,需通过命令行或配置文件完成双计划的完整对接,确保Hermes Agent可正常调用百炼模型服务。
3.1 命令行配置(推荐新手)
命令行配置方式简单快捷,无需修改文件,适合快速完成双计划对接。依次执行以下命令,分别配置Token Plan与Coding Plan:
3.1.1 配置Token Plan
# 切换至root用户(确保权限充足)
sudo su root
# 配置模型提供商为自定义(对接百炼服务)
hermes config set model.provider custom
# 配置Token Plan OpenAI兼容Base URL
hermes config set model.base_url https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
# 配置Token Plan专属API Key(替换为你的实际密钥)
hermes config set model.api_key sk-sp-xxxxxxxxxxxxxxxxxxxxxxxx
# 设置Token Plan默认模型(如qwen3.7-max)
hermes config set model.default qwen3.7-max
# 验证Token Plan配置
hermes config get model
3.1.2 配置Coding Plan
# 新增Coding Plan配置项(命名为coding-plan)
hermes config set model.providers.coding-plan.provider custom
# 配置Coding Plan Base URL
hermes config set model.providers.coding-plan.base_url https://coding-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
# 配置Coding Plan专属API Key(替换为你的实际密钥)
hermes config set model.providers.coding-plan.api_key sk-cp-xxxxxxxxxxxxxxxxxxxxxxxx
# 设置Coding Plan默认模型(如qwen3.6-flash)
hermes config set model.providers.coding-plan.default qwen3.6-flash
# 保存配置并生效
hermes config save
3.2 配置文件修改(适合精细化配置)
若需长期保存配置或进行复杂参数调整,可直接修改Hermes Agent的配置文件,路径为~/.hermes/config.yaml。执行以下命令编辑文件:
# 编辑配置文件
vi ~/.hermes/config.yaml
在文件中添加或修改以下内容,分别配置Token Plan与Coding Plan:
model:
# 默认使用Token Plan
default: qwen3.7-max
provider: custom
base_url: https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
api_key: sk-sp-xxxxxxxxxxxxxxxxxxxxxxxx
# 多提供商配置(Coding Plan)
providers:
coding-plan:
provider: custom
base_url: https://coding-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
api_key: sk-cp-xxxxxxxxxxxxxxxxxxxxxxxx
default: qwen3.6-flash
编辑完成后,按Esc键,输入:wq保存并退出,执行以下命令使配置生效:
# 重启Hermes Agent服务
hermes restart
3.3 配置验证与模型切换
配置完成后,需验证双计划是否正常生效,并掌握模型切换方法:
- 验证配置:执行
hermes config get model命令,查看输出结果中是否包含Token Plan与Coding Plan的完整配置信息,若信息正确则表示配置成功。 - 模型切换:在Hermes Agent交互界面中,使用
/model命令查看所有可用模型;使用/model set qwen3.7-max切换至Token Plan模型,使用/model set coding-plan:qwen3.6-flash切换至Coding Plan模型,实现双计划灵活调用。
四、Hermes Agent服务验证与使用
完成部署与配置后,需通过WebUI、命令行、多端网关等方式验证Hermes Agent的服务可用性,确保可正常调用百炼Coding Plan与Token Plan的模型服务。
4.1 WebUI访问验证
- 在浏览器中输入
http://ECS公网IP:8080(默认端口为8080),进入Hermes Agent WebUI界面。 - 使用部署时设置的实例密码登录,进入对话界面,输入测试问题(如“帮我写一个Python冒泡排序代码”),选择对应模型(Token Plan或Coding Plan),点击发送。
- 若能快速返回正确结果,且无报错信息,则表示WebUI访问与模型调用正常。
4.2 命令行交互验证
- 在ECS远程终端中,直接执行
hermes命令,进入Hermes Agent TUI交互界面。 - 输入测试指令,如“解释一下百炼Token Plan与Coding Plan的区别”,系统将调用默认模型(Token Plan)返回结果。
- 执行
/model set coding-plan:qwen3.6-flash切换至Coding Plan,再次输入测试指令,验证Coding Plan调用是否正常。 - 常用命令:
/help查看所有可用命令,/history查看对话历史,/clear清空对话记录。
4.3 多端网关启用(可选)
Hermes Agent支持接入Telegram、Discord、飞书等消息平台,实现多端AI交互。以启用Telegram网关为例,执行以下命令:
# 安装Telegram网关依赖
pip install python-telegram-bot
# 启动Telegram网关(替换为你的Telegram Bot Token)
hermes gateway start telegram --token 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
启动成功后,在Telegram中搜索对应的Bot账号,即可与Hermes Agent对话,调用百炼模型服务。
五、常见问题与优化建议
5.1 常见问题排查
- 部署失败:若计算巢部署状态长时间为“部署中”或“失败”,检查账户余额是否充足、实例规格是否可用、地域是否支持;可删除失败实例,重新提交部署。
- 模型调用失败:若返回“API Key无效”“Base URL错误”,核对百炼计划的API Key与Base URL是否正确,Token Plan与Coding Plan密钥不可混用;若返回“网络超时”,检查ECS安全组是否放行对应端口,或更换部署地域。
- 服务无法启动:执行
hermes logs查看日志,定位依赖安装失败、配置文件错误等问题;重新执行hermes install修复依赖,或删除配置文件后重新配置。
5.2 性能与成本优化
- 实例规格优化:根据使用场景调整ECS规格,日常开发测试可使用入门级规格,高并发场景升级至计算优化型实例;开启计算巢弹性伸缩功能,根据负载自动调整实例数量。
- 百炼计划选择:代码开发场景优先使用Coding Plan,按调用次数计费更划算;多模型、全模态服务场景使用Token Plan,灵活切换模型且无调用频次限制。
- 资源释放:测试完成后及时停止或释放ECS实例,避免产生不必要的按量付费费用;百炼计划可根据使用需求暂停或调整套餐,降低成本。
六、总结
阿里云计算巢搭配百炼Coding Plan与Token Plan,为Hermes Agent的部署与应用提供了一站式解决方案。通过计算巢的一键式部署,开发者无需关注底层环境搭建,快速完成Hermes Agent的服务上线;通过百炼双计划的灵活配置,实现代码开发与通用AI服务的模型调用需求,兼顾成本与性能。
本文从准备工作、部署流程、配置细节、服务验证到问题排查,全面拆解了Hermes Agent的完整部署与配置流程,无论是个人开发者还是企业团队,均可按照步骤快速搭建属于自己的AI智能体服务。后续可进一步探索Hermes Agent的自进化能力、自定义工具集成等高级功能,结合百炼平台的丰富模型,打造更强大、更个性化的AI应用。