阿里云计算巢+本地Windows/macOS/Linux部署Hermes Agent 百炼Token Plan配置保姆级教程-阿里云开发者社区

一、部署前核心准备（2026年最新）

Hermes Agent是一款轻量、可扩展的AI智能体执行框架，支持本地与云端部署，可对接各类大模型API实现自动化任务、代码执行、文件处理等能力。搭配阿里云计算巢可实现一键式云端部署，无需手动配置复杂环境；结合阿里云百炼Token Plan团队版，能以固定月费获得稳定、高性价比的大模型调用额度，完美适配个人与团队高频使用场景。本次部署覆盖阿里云计算巢（ECS）与本地Windows、macOS、Linux全平台，核心依赖Python 3.9+、Git，且必须完成阿里云账号实名认证并获取百炼Token Plan专属API Key。阿里云部署AI Agent：OpenClaw/Hermes Agent全网最简单，只需两步，详情👉访问阿里云OpenClaw/Hermes一键部署专题页面 了解。

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

1.1 阿里云账号与百炼Token Plan开通

注册并登录阿里云账号，完成个人/企业实名认证（未实名无法使用计算巢服务与获取API Key）。
进入阿里云百炼大模型控制台，找到Token Plan团队版订阅入口，选择适配坐席：标准版（198元/月，25000 Credits）、高级版（698元/月，100000 Credits）、尊享版（1398元/月，250000 Credits），完成订阅。新用户可享90天内各模型100万Token免费额度，系统优先消耗免费额度。
订阅后在百炼控制台「密钥管理」创建Token Plan专属API Key（格式为sk-sp-xxxxxx，与普通按量计费密钥sk-开头不同），仅生成时可完整查看，务必立即复制保存到本地，切勿泄露。
记录Token Plan专属Base URL：https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1，该地址为Hermes Agent对接百炼Token Plan的核心接口。

1.2 环境依赖检查

Python：必须安装3.9.0及以上版本，Hermes Agent核心运行依赖该环境。
Git：用于拉取Hermes Agent源码及依赖包，本地部署需提前安装。
网络：确保服务器/本地设备可正常访问阿里云百炼API与Hermes Agent官方源，国内用户建议配置pip镜像加速。
零基础部署AI Agent：OpenClaw/Hermes Agent喂饭级步骤流程
第一步：👉点击打开访问阿里云OpenClaw/Hermes Agent一键部署专题页面。

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

第二步：👉打开选择阿里云轻量应用服务器，配置参考如下：

镜像：OpenClaw(或Hermes Agent)镜像（已经购买服务器的用户可以重置系统重新选择镜像）
实例：内存必须2GiB及以上。
地域：默认美国（弗吉尼亚），目前中国内地域（除香港）的轻量应用服务器，联网搜索功能受限。
时长：根据自己的需求及预算选择。

轻量应用服务器OpenClaw镜像.png

第三步：打开访问阿里云百炼大模型控制台，找到密钥管理，单击创建API-Key。

阿里云百炼密钥管理图.png

前往轻量应用服务器控制台，找到安装好OpenClaw的实例，进入「应用详情」放行18789端口、配置百炼API-Key、执行命令，生成访问OpenClaw的Token。
阿里云百炼密钥管理图2.png

端口放通：需要放通对应端口的防火墙，单击一键放通即可。
配置百炼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（2026年官方流程）
阿里云计算巢提供两种部署方式：一键应用部署（新手首选）与手动命令行部署（进阶用户），两种方式均需提前创建计算巢服务实例并配置安全组。

2.1 计算巢实例创建与基础配置

登录阿里云计算巢控制台，点击「创建服务」，选择「应用市场」，搜索「Hermes Agent」，选择2026官方稳定版（Alibaba Cloud Linux 3）。
基础配置如下：
- 实例规格：2核4GiB内存 + 40GB ESSD云盘（禁止选择1核1GiB/2GiB，内存不足会导致部署失败）。
- 地域：中国香港（免备案，大模型API访问延迟低，稳定性最优）。
- 带宽：5Mbps固定带宽（满足日常访问、模型调用需求）。
网络与安全组配置：
- 自动分配公网IP：勾选「是」（必须，否则无法外部访问）。
- 安全组：勾选开放22端口（SSH）、开放8888端口（Hermes Agent默认端口），系统自动配置入方向规则。
登录设置：选择密码登录，设置高强度密码（大小写+数字+符号，≥12位），牢记备用。
确认订单并完成支付，等待实例创建完成（约3-5分钟）。

2.2 一键应用部署Hermes Agent（新手推荐）

实例创建完成后，进入计算巢实例详情页，找到「应用详情」模块。
点击「配置Hermes」区域的「一键配置」按钮：
- 模型厂商：选择「阿里云百炼」。
- 认证方式：选择「Token Plan」。
- API Key：粘贴Token Plan专属API Key（以sk-sp-开头）。
- Base URL：粘贴https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1。
- 默认模型：选择qwen3.7-max或qwen3.6-plus。
点击「确定」，系统自动执行配置命令，写入Hermes Agent配置文件。
点击「生成访问Token」，系统生成Hermes Agent Web UI访问凭证，复制保存该Token（后续登录控制台必备）。
点击「打开网站页面」，输入生成的Token，即可进入Hermes Agent控制台，完成部署。

2.3 手动命令行部署Hermes Agent（进阶用户）

使用SSH工具连接计算巢ECS实例（用户名为root，密码为实例创建时设置的密码）：
```
ssh root@你的计算巢实例公网IP
```

更新系统包并安装基础依赖：

sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl wget python3 python3-pip

配置pip国内镜像（加速安装）：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

安装Hermes Agent（官方一键脚本）：

curl -fsSL https://hermes.ai/install.sh | bash

初始化Hermes Agent配置：
```
hermes onboard
```
按照向导提示：选择「手动配置」→ 模型厂商选「阿里云百炼」→ 认证方式选「Token Plan」→ 粘贴API Key与Base URL → 选择默认模型（推荐qwen3.7-max）→ 完成初始化。
启动Hermes Agent网关服务：
```
hermes gateway start
```

验证服务状态：

curl http://localhost:8888/api/health # 输出{"status":"ok"}即为成功

生成访问Token：

hermes token generate # 复制输出的token，用于登录Web UI

访问Hermes Agent控制台：浏览器输入http://计算巢实例公网IP:8888，输入生成的Token即可登录。

三、本地Windows系统部署Hermes Agent（2026年详细步骤）

3.1 环境准备与依赖安装

以管理员身份打开PowerShell（Win+X → 选择「Windows PowerShell(管理员)」）。
安装Python 3.9+（使用winget）：
```
winget install Python.Python.3.11
```
验证Python与pip安装：
```
python --version
pip --version
```

配置pip国内镜像：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

安装Git（使用winget）：
```
winget install Git.Git
```

3.2 Hermes Agent安装与配置

安装Hermes Agent（官方PowerShell脚本）：

iwr -useb https://hermes.ai/install.ps1 | iex

验证Hermes Agent安装：
```
hermes --version
```
初始化Hermes Agent并配置百炼Token Plan：
```
hermes onboard
```
向导步骤：
- 选择「YES」开始配置 → 引导方式选「手动」。
- 设置为本地网关，工作区目录默认回车。
- 模型厂商选择「阿里云百炼」→ 认证方式选「Token Plan」。
- 粘贴Token Plan API Key与Base URL → 选择默认模型（qwen3.7-max）。
- 跳过聊天通道与技能配置（选择「NO」）→ 完成初始化。
启动Hermes Agent网关服务：
```
hermes gateway start
```
生成访问Token：
```
hermes token generate
```
访问本地控制台：浏览器输入http://127.0.0.1:8888，输入Token登录。

四、本地macOS系统部署Hermes Agent（2026年详细步骤）

4.1 环境准备与依赖安装

打开终端（Command + 空格 → 输入「Terminal」→ 回车）。

安装Homebrew（macOS包管理器，已安装可跳过）：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装Python 3.9+：
```
brew install python@3.11
```
验证Python安装：
```
python3 --version
pip3 --version
```

配置pip国内镜像：

pip3 config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

安装Git：
```
brew install git
```

4.2 Hermes Agent安装与配置

安装Hermes Agent（官方一键脚本，推荐）：
```
curl -fsSL https://hermes.ai/install.sh | bash
```

国内用户可使用加速脚本：

curl -fsSL https://hermes-agent.org.cn/install-cn.sh | bash

验证安装：
```
hermes --version
```
初始化并配置百炼Token Plan：
```
hermes onboard
```
按照向导完成配置：选择阿里云百炼 → Token Plan → 粘贴API Key与Base URL → 选择模型 → 完成初始化。
启动网关服务：
```
hermes gateway start
```

生成访问Token并登录控制台：

hermes token generate
# 访问http://127.0.0.1:8888，输入Token登录

五、本地Linux系统（Ubuntu/Debian）部署Hermes Agent（2026年详细步骤）

5.1 环境准备与依赖安装

打开终端（Ctrl+Alt+T）。

更新系统包并安装基础工具：

sudo apt update
sudo apt install -y curl git python3 python3-pip

配置pip国内镜像：

pip3 config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

5.2 Hermes Agent安装与配置

安装Hermes Agent（官方脚本）：

curl -fsSL https://hermes.ai/install.sh | bash

验证安装：
```
hermes --version
```
初始化配置百炼Token Plan：
```
hermes onboard
```
配置步骤同macOS：选择阿里云百炼 → Token Plan → 输入API Key与Base URL → 选择模型 → 完成。
启动服务：
```
hermes gateway start
```

生成Token并访问控制台：

hermes token generate
# 浏览器访问http://127.0.0.1:8888，输入Token登录

六、Hermes Agent配置百炼Token Plan进阶命令（全平台通用）

6.1 手动修改配置文件（推荐进阶用户）

找到Hermes Agent配置文件路径：~/.hermes/config.yaml（Linux/macOS）或C:\Users\用户名\.hermes\config.yaml（Windows）。

编辑配置文件，添加/修改百炼Token Plan配置：

model:
  default: qwen3.7-max
  provider: custom
  base_url: https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
  api_key: "你的Token Plan API Key"
  api_mode: openai_messages

重启Hermes Agent服务使配置生效：
```
hermes gateway restart
```

6.2 命令行快速配置（全平台通用）

设置模型提供商为自定义：

hermes config set model.provider custom

设置百炼Token Plan专属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-xxxxxx"

设置API模式为OpenAI兼容：

hermes config set model.api_mode openai_messages

设置默认模型：

hermes config set model.default qwen3.7-max

重启服务并验证：

hermes gateway restart
curl http://localhost:8888/api/health # 验证服务状态

七、常见问题与避坑指南（2026年最新）

部署失败：Python版本过低
- 原因：Hermes Agent要求Python 3.9+，低版本会导致依赖安装失败。
- 解决：使用包管理器安装3.9+版本，命令：brew install python@3.11（macOS）、sudo apt install python3.11（Linux）、winget install Python.Python.3.11（Windows）。
无法访问Hermes Agent控制台
- 原因：计算巢安全组未开放8888端口，或本地防火墙拦截端口。
- 解决：计算巢安全组添加入方向规则，开放8888端口；本地关闭防火墙或添加端口例外。
百炼Token Plan调用失败
- 原因：API Key错误、Base URL填写错误、Token Plan未生效或额度耗尽。
- 解决：核对API Key（必须sk-sp-开头）与Base URL；检查百炼控制台Token Plan状态与剩余额度；确保使用Token Plan专属密钥（非按量计费密钥）。
Hermes Agent服务启动失败
- 原因：内存不足、端口被占用、配置文件格式错误。
- 解决：升级计算巢实例规格至2核4GiB+；检查8888端口是否被占用（lsof -i:8888）；核对config.yaml配置格式是否正确（YAML严格缩进）。
国内网络安装缓慢
- 原因：官方源在境外，国内访问速度慢。
- 解决：使用国内加速脚本安装Hermes Agent，配置pip国内镜像（https://pypi.tuna.tsinghua.edu.cn/simple）。

八、总结与后续使用

本次教程完整覆盖阿里云计算巢（ECS）与本地Windows、macOS、Linux全平台部署Hermes Agent的详细步骤，以及百炼Token Plan的两种配置方式（一键配置与手动命令配置）。部署完成后，可通过Hermes Agent控制台创建AI智能体，调用阿里云百炼Qwen系列模型（如qwen3.7-max、qwen3.6-plus）实现文件处理、代码编写、流程自动化等功能。

后续使用中，可通过hermes gateway start/stop/restart管理服务状态，通过hermes token generate生成新的访问凭证，通过百炼控制台实时查看Token消耗与剩余额度。如需扩展功能，可安装Hermes Agent技能插件，实现网页抓取、PDF转换、邮件发送等高级能力。

阿里云计算巢+本地Windows/macOS/Linux部署Hermes Agent 百炼Token Plan配置保姆级教程

一、部署前核心准备（2026年最新）

1.1 阿里云账号与百炼Token Plan开通

1.2 环境依赖检查

零基础部署AI Agent：OpenClaw/Hermes Agent喂饭级步骤流程

阿里云百炼Coding Plan API-Key 获取、配置保姆级教程：

二、阿里云计算巢部署Hermes Agent（2026年官方流程）

2.1 计算巢实例创建与基础配置

2.2 一键应用部署Hermes Agent（新手推荐）

2.3 手动命令行部署Hermes Agent（进阶用户）

三、本地Windows系统部署Hermes Agent（2026年详细步骤）

3.1 环境准备与依赖安装

3.2 Hermes Agent安装与配置

四、本地macOS系统部署Hermes Agent（2026年详细步骤）

4.1 环境准备与依赖安装

4.2 Hermes Agent安装与配置

五、本地Linux系统（Ubuntu/Debian）部署Hermes Agent（2026年详细步骤）

5.1 环境准备与依赖安装

5.2 Hermes Agent安装与配置

六、Hermes Agent配置百炼Token Plan进阶命令（全平台通用）

6.1 手动修改配置文件（推荐进阶用户）

6.2 命令行快速配置（全平台通用）

七、常见问题与避坑指南（2026年最新）

八、总结与后续使用

热门文章

最新文章

相关电子书

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

阿里云计算巢+本地Windows/macOS/Linux部署Hermes Agent 百炼Token Plan配置保姆级教程

一、部署前核心准备（2026年最新）

1.1 阿里云账号与百炼Token Plan开通

1.2 环境依赖检查

零基础部署AI Agent：OpenClaw/Hermes Agent喂饭级步骤流程

阿里云百炼Coding Plan API-Key 获取、配置保姆级教程：

二、阿里云计算巢部署Hermes Agent（2026年官方流程）

2.1 计算巢实例创建与基础配置

2.2 一键应用部署Hermes Agent（新手推荐）

2.3 手动命令行部署Hermes Agent（进阶用户）

三、本地Windows系统部署Hermes Agent（2026年详细步骤）

3.1 环境准备与依赖安装

3.2 Hermes Agent安装与配置

四、本地macOS系统部署Hermes Agent（2026年详细步骤）

4.1 环境准备与依赖安装

4.2 Hermes Agent安装与配置

五、本地Linux系统（Ubuntu/Debian）部署Hermes Agent（2026年详细步骤）

5.1 环境准备与依赖安装

5.2 Hermes Agent安装与配置

六、Hermes Agent配置百炼Token Plan进阶命令（全平台通用）

6.1 手动修改配置文件（推荐进阶用户）

6.2 命令行快速配置（全平台通用）

七、常见问题与避坑指南（2026年最新）

八、总结与后续使用

热门文章

最新文章

相关电子书