2026 年 Hermes Agent 在阿里雲計算巢部署及百煉 API Key 配置指南

简介： 整体来说，在阿里云计算巢部署Hermes Agent，兼顾低门槛和高扩展性，一键模板适合快速验证智能体能力，手动部署适合深度定制、二次开发。搭配百炼Token Plan、Coding Plan套餐调用Qwen系列大模型，用来搭建自动化运维工具、代码调试助手、批量文档处理机器人都十分合适。按照这套喂饭级流程完成部署和密钥配置，做好目录权限隔离、账单告警，就能稳定使用这款自进化开源AI智能体。

Hermes Agent是一款主打自进化能力的开源AI智能体，支持文件读写、Shell命令执行、网页浏览、定时任务调度、长期会话记忆，能够持续迭代任务思路，非常适合用来搭建自动化运维助手、代码开发Agent、文档批量处理工具。依托阿里云计算巢部署，不用手动处理复杂的服务器初始化、安全组、网络转发，支持模板一键拉起服务，也支持手动在计算巢实例中源码安装，搭配百炼Token Plan或者Coding Plan套餐调用Qwen系列大模型，稳定性和性价比都很突出。本文为喂饭级完整流程，把前置准备、两种部署方式、百炼API Key配置、网关启停、任务测试、常见报错全部整理清楚，附带可直接复制的命令，零基础新手也能跟着完成整套部署。

部署之前，我们先准备两项核心资源。第一是百炼平台的API Key，登录百炼控制台，进入API密钥管理页面创建密钥，密钥只会展示一次，一定要复制保存。这里要区分普通按量计费密钥、Token Plan密钥、Coding Plan密钥，三者的接入地址不一样，不要混用；同时密钥和服务部署地域必须保持一致，跨地域调用会直接鉴权失败。第二是计算巢账号权限，账号需要完成实名认证，测试场景推荐按量付费，闲置的时候及时释放实例，避免持续扣费。硬件配置最低建议1核2G，仅简单对话测试够用；如果需要高频执行Shell、长上下文任务、浏览器自动化，推荐2核4G及以上规格。

零基础部署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对话页面。

方案一：计算巢模板一键部署，适合新手快速上手。进入计算巢控制台，在服务市场搜索Hermes Agent社区模板，选定就近部署地域，填写实例名称，设置实例登录密码。在参数配置栏，直接填入百炼DASHSCOPE_API_KEY，自定义网关访问令牌用来保护Web后台，防止外部人员随意访问。确认参数、勾选协议后提交订单，等待2-4分钟，计算巢会自动完成实例创建、环境依赖安装、Hermes Agent初始化、网关拉起。部署完成后，在实例详情页获取Web访问地址，地址自带鉴权令牌，浏览器打开即可进入控制面板，面板包含对话、任务管理、工具开关、设置模块，打开对话面板就可以下发任务。

方案二：手动部署，适合想要自定义参数、二次开发、调整插件逻辑的用户。先在计算巢创建一台空ECS实例，拿到公网IP，使用SSH连接服务器：

ssh root@实例公网IP

登录服务器后先更新系统软件源，安装curl、git等基础工具，Hermes Agent安装脚本会自动处理Python、Node等运行环境，不需要手动提前安装复杂版本。

yum install -y curl git wget

执行官方一键安装脚本，自动下载Hermes Agent主体程序、配置运行环境：

curl -fsSL [https://hermes-agent.nousresearch.com/install.sh](https://hermes-agent.nousresearch.com/install.sh) | bash

安装完成后，终端会自动写入环境变量，如果新开终端识别不到hermes命令，执行下面命令加载环境：

export PATH="$HOME/.local/bin:$PATH"

接下来进入核心的百炼API Key配置环节，一共有三种配置方式，按需选择。第一种交互式向导配置，新手友好，跟着指引选择模型服务商、填入密钥：

hermes setup

第二种通过环境变量注入密钥，安全性更高，不会明文保存在命令历史中：

export DASHSCOPE_API_KEY="你的百炼APIKEY"
export DASHSCOPE_BASE_URL="[https://dashscope.aliyuncs.com/compatible-mode/v1](https://dashscope.aliyuncs.com/compatible-mode/v1)"

第三种直接写入配置文件，配置文件默认路径~/.hermes/.env，使用vim编辑：

vim ~/.hermes/.env

在文件内写入密钥与接入地址，保存退出。也可以使用hermes config命令直接设置参数：

hermes config set model.provider alibaba
hermes config set model.api_key "你的百炼APIKEY"
hermes config set model.default qwen3.7-max

配置完成后，我们可以使用诊断命令自动检测环境、密钥连通性，自动修复大部分异常：

hermes doctor --fix

诊断无报错之后，就可以启动网关服务，网关是WebUI和Agent交互的核心服务，默认监听端口为38760。

# 启动网关
hermes gateway start
# 查看网关运行状态
hermes gateway status
# 停止网关
hermes gateway stop
# 重启网关，修改配置后必须重启生效
hermes gateway restart

网关正常运行后，打开浏览器访问http://服务器公网IP:38760，输入提前设置的网关访问令牌，进入Web控制面板。也可以直接在终端启动交互式对话，不用打开Web页面：

hermes chat --provider alibaba --model qwen3.7-max

Hermes Agent拥有执行Shell脚本、读写服务器文件的能力，权限风险需要重点注意。不要让Agent直接操作系统根目录，建议单独创建隔离工作目录，限制Agent操作范围：

mkdir -p /opt/hermes-workspace

在WebUI设置面板，把工作目录指定到这个路径，避免AI误删系统文件。同时它支持Cron定时任务，我们可以直接在对话面板下发定时巡检、日志整理的任务，也可以搭配Python脚本实现业务联动。

部署和使用过程中，高频问题比较多，这里整理排查思路。第一，API Key鉴权失败，优先检查密钥是否复制完整、有没有多余空格，核对接入地址是否匹配套餐类型，登录百炼控制台查看密钥是否启用、套餐额度是否耗尽。第二，Web页面打不开，模板部署一般自动放行端口，手动部署需要在安全组放行38760端口，防火墙也需要同步开放。第三，网关启动失败，优先执行hermes doctor诊断，大部分是环境缺失、密钥格式错误导致。第四，模型调用报错，检查选中的模型是否支持当前套餐，部分模型仅Coding Plan可以调用。

如果后续不再使用Hermes Agent，为了避免服务器持续产生计费，优先停止网关进程：

hermes gateway stop

确认数据备份完成后，可使用阿里云CLI命令释放计算巢实例，释放后磁盘内所有数据会被清除，无法找回：

aliyun ecs DeleteInstance --InstanceId i-xxxxxx --Force true

Hermes Agent还支持扩展工具集，开启浏览器自动化、Git代码管理、文件检索等能力，在WebUI的工具管理面板按需开启，开启后重启网关即可生效。它的自进化特性体现在会话记忆，会自动保存历史任务的执行经验，同类任务多次执行之后，输出方案会越来越贴合你的使用习惯。

整体来说，在阿里云计算巢部署Hermes Agent，兼顾低门槛和高扩展性，一键模板适合快速验证智能体能力，手动部署适合深度定制、二次开发。搭配百炼Token Plan、Coding Plan套餐调用Qwen系列大模型，用来搭建自动化运维工具、代码调试助手、批量文档处理机器人都十分合适。按照这套喂饭级流程完成部署和密钥配置，做好目录权限隔离、账单告警，就能稳定使用这款自进化开源AI智能体。