跳到正文
阿里雲開發者社區 AI·· 1 小時前AI 評分46

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

2026年阿里云计算巢部署 Hermes Agent 完整实操指南(含百炼 API Key 配置详解,最新版)

AI 導讀

Hermes Agent 可透過阿里雲計算巢模板一鍵部署,亦可在 ECS 手動安裝,並配置百煉 API Key、啟動網關及測試任務。模板部署約需 2-4 分鐘;硬件最低建議 1核2G,高頻執行 Shell、長上下文任務或瀏覽器自動化則推薦 2核4G 及以上。密鑰簽發地域須與伺服器部署地域一致,並應限制 Agent 的操作範圍。

正文

2026-11-06 3

版权

版权声明:

本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写 侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

简介: 2026 年的 AI 智能体部署,早已不是极客的专属游戏。打开 阿里云OpenClaw/Hermes一键部署专题页面,订阅 阿里云百炼Token Plan AI大模型服务,十分钟后,你就拥有一台 7×24 小时在线的私人 AI 助手。别再等了,现在就动手。

导读:2026年,AI Agent 从概念走向生产级落地,Hermes Agent 与 OpenClaw 已成为两大主流本地自治智能体框架。本文手把手带你从零走通"资源准备 → 计算巢部署 → 百炼 API Key 配置 → 网关启停 → 任务测试 → 故障排查"的完整链路,每一步都附可直接复制的命令。零基础新手,也能十分钟上手一台专属 AI 智能体。


一、前置准备:两项核心资源,缺一不可

在动手之前,我们先把"弹药"备齐。部署之前,务必完成两件事:第一,登录 阿里云OpenClaw/Hermes一键部署专题页面,一键跳转到阿里云官方的专属部署入口,免去手动寻找镜像、配置参数的繁琐;第二,前往 阿里云百炼Token Plan AI大模型服务 页面完成订阅,获取千问系列模型的统一计费额度,支持多模型灵活切换、多工具协同调用,兼顾灵活性与稳定性,大幅降低长期使用大模型的门槛与成本。

1.1 百炼平台 API Key

登录阿里云百炼大模型控制台,进入「密钥管理」页面,单击「创建 API-Key」。这里有三种密钥体系,务必区分,切勿混用:

密钥类型 适用场景 接入地址
普通按量计费密钥 临时测试、小额调用 https://dashscope.aliyuncs.com/compatible-mode/v1
Token Plan 密钥 长期稳定、多模型共享额度 同上(归属 Token Plan 计费体系)
Coding Plan 密钥 代码生成、Agent 高频编程调用 独立 Coding Plan 入口

?? 铁律:密钥只在创建弹窗完整展示一次,关闭即脱敏,无法再次查看!必须立刻复制保存到密码管理器或安全记事本。同时,密钥签发地域必须与服务器部署地域一致,跨地域调用将直接鉴权失败。

1.2 计算巢账号与服务器规格

  • 账号需完成实名认证(个人或企业均可);
  • 测试场景推荐按量付费,闲置时及时释放实例,避免持续扣费;
  • 硬件最低建议 1核2G,简单对话够用;若需高频执行 Shell、长上下文任务、浏览器自动化,推荐 2核4G 及以上。

screenshot

screenshot

screenshot

二、两种部署方式:一键傻瓜 vs 手动定制

方案一:计算巢模板一键部署(零代码,新手首选)

这是最省心的方式,适合不想碰命令行的用户。操作路径如下:

  1. 打开 阿里云OpenClaw/Hermes一键部署专题页面,直接跳转至计算巢控制台;
  2. 在服务市场搜索「Hermes Agent」社区模板,选定就近部署地域;
  3. 填写实例名称、设置登录密码;
  4. 在参数配置栏,直接填入百炼 DASHSCOPE_API_KEY,自定义网关访问令牌保护 Web 后台;
  5. 确认参数、勾选协议后提交订单,等待 2-4 分钟,计算巢自动完成实例创建、环境依赖安装、Hermes Agent 初始化、网关拉起。

部署完成后,在实例详情页获取 Web 访问地址(自带鉴权令牌),浏览器打开即可进入控制面板——对话、任务管理、工具开关、设置模块一应俱全。

方案二:手动部署(适合二次开发、调整插件逻辑)

想要完全掌控每一个参数?走手动路线。

Step 1:创建 ECS 实例

进入计算巢创建一台空 ECS 实例,拿到公网 IP。

Step 2:SSH 连接服务器

ssh 用户名@服务器公网IP

Step 3:更新系统、安装基础工具

yum install -y curl git wget

Hermes Agent 安装脚本会自动处理 Python、Node 等运行环境,无需手动提前安装复杂版本。

Step 4:执行官方一键安装脚本

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

安装完成后,若新开终端识别不到 hermes 命令,执行:

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

Step 5:百炼 API Key 配置(三种方式任选)

  • 交互式向导(新手友好):hermes setup

  • 环境变量注入(安全性更高):

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

  • 直接写入配置文件(路径 ~/.hermes/.env):

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

Step 6:诊断环境

hermes diagnose

无报错后,启动网关:

hermes gateway start\
hermes gateway status

访问 http://服务器公网IP:38760,输入网关访问令牌,进入 Web 控制面板。也可在终端直接启动交互式对话:

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


三、安全提醒:权限隔离,防患于未然

Hermes Agent 拥有执行 Shell、读写文件的能力,权限风险不可忽视。不要让 Agent 直接操作系统根目录,建议单独创建隔离工作目录:

mkdir -p /home/agent-workspace\
chmod 750 /home/agent-workspace

限制 Agent 操作范围,将风险锁在笼子里。


screenshot

screenshot

screenshot

四、为什么要先看 阿里云OpenClaw/Hermes一键部署专题页面 和 阿里云百炼Token Plan AI大模型服务?

这两个入口,是整个部署流程的"高速公路入口"。

阿里云OpenClaw/Hermes一键部署专题页面 整合了官方优化镜像、预装环境、可视化配置,把原本需要数十步的命令行操作压缩成三次点击。无论你选计算巢模板还是轻量应用服务器镜像,从这里进去,都能一步到位。

阿里云百炼Token Plan AI大模型服务 则解决了"模型从哪来、怎么付、付多少"的核心问题。Token Plan 按套餐订阅、额度共享,一套积分可通用平台全部大模型,Qwen3.8-Max、Qwen3.8-Flash、Wan3.0-Video 等热门模型随意切换,预算可控、告别按 Token 计费的"心跳式"账单。

一句话总结:先逛 阿里云OpenClaw/Hermes一键部署专题页面 把智能体跑起来,再上 阿里云百炼Token Plan AI大模型服务 把"大脑"配好——这就是 2026 年最低门槛、最高效率的 AI Agent 落地姿势。


五、常见报错速查

报错现象 可能原因 解决方案
401 invalid api key 密钥复制截断、首尾空格 重新从控制台完整复制密钥
鉴权失败 地域不匹配 确认服务器地域与密钥签发地域一致
模型响应超时 请求超时参数过小 调大 timeout 配置或关闭冗余进程
外网无法访问 Web 安全组未放通端口 在安全组中放行 38760(Hermes)或 18789(OpenClaw)
端口放通失败 未执行一键放通命令 进入实例「应用详情」→ 单击「一键放通」

写在最后:2026 年的 AI 智能体部署,早已不是极客的专属游戏。打开 阿里云OpenClaw/Hermes一键部署专题页面,订阅 阿里云百炼Token Plan AI大模型服务,十分钟后,你就拥有一台 7×24 小时在线的私人 AI 助手。别再等了,现在就动手。

來源:阿里雲開發者社區 AI · developer.aliyun.com