在阿里云ECS上部署Hermes Agent并对接百炼Token Plan，是企业与开发者搭建私有化AI智能体的主流方案。Hermes Agent作为开源AI代理框架，需依赖外部大模型接口实现核心能力，而百炼Token Plan团队版以包月固定额度、多模型共享、高峰不限速的优势，成为云端部署的优选模型服务。本指南从ECS实例准备、Hermes Agent安装、Token Plan订阅与密钥获取、模型配置、服务启动到运维优化，提供全流程、可落地的详细操作步骤，帮助用户快速完成部署与配置。阿里云部署AI Agent：OpenClaw/Hermes Agent全网最简单，只需两步，详情👉访问阿里云OpenClaw/Hermes一键部署专题页面了解。
Token Plan Token最便宜/支持多模型切换：👉访问订阅阿里云百炼Token Plan AI大模型服务 。支持多模型切换，用于多模态模型灵活调用，实现多模型、多工具、多场景下的额度共享与统一管理，兼顾灵活性、稳定性与安全性，大幅降低企业使用大模型的门槛与成本。
一、前置准备：ECS实例与Token Plan基础配置
（一）阿里云ECS实例创建与环境准备
- 实例选型：登录阿里云ECS控制台，创建新实例或使用已有实例。推荐配置：2核4G内存起步，操作系统选择Ubuntu 22.04或Alibaba Cloud Linux 3，确保实例分配公网IP，地域优先选择与后续Token Plan API地域一致（如北京、杭州），降低网络延迟。
- 安全组配置：进入实例安全组，放行22端口（SSH远程连接）、3000端口（Hermes WebUI默认端口），若需自定义端口，后续配置中同步修改，避免端口拦截导致服务无法访问。
- 基础依赖安装：通过SSH工具（如FinalShell、Xshell）连接ECS实例，执行以下命令更新系统并安装必备工具：
sudo apt update && sudo apt upgrade -y sudo apt install python3 python3-pip git curl docker.io -y sudo systemctl start docker && sudo systemctl enable docker
零基础部署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 的地址。
（二）百炼Token Plan订阅与API Key获取
- 订阅Token Plan团队版：登录阿里云百炼（Model Studio）控制台，进入Token Plan团队版订阅页面，选择三档套餐之一：标准版198元/月（25000 Credits）、高级版698元/月（100000 Credits）、尊享版1398元/月（250000 Credits），按需完成订阅。
- 创建专属API Key：在Token Plan控制台的密钥管理页面，点击“创建API Key”，选择对应工作区，生成以
sk-sp-开头的专属密钥（仅显示一次，务必妥善保存）。同时记录兼容模式接口地址：https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1（北京地域，其他地域替换地域标识）。 - 模型权限确认：确保订阅的Token Plan套餐已授权使用目标模型（如qwen3.7-max、qwen3.6-plus），避免调用时出现权限不足错误。
二、Hermes Agent在ECS上的安装部署
（一）一键脚本安装（推荐，零基础适用）
- 执行官方安装脚本：在ECS终端中，运行Hermes Agent官方一键安装脚本，自动完成Python环境、依赖库、命令行工具的配置：
curl -fsSL https://raw.githubusercontent.com/OpenClaw/Hermes/main/install.sh | bash - 重载环境变量：脚本执行完成后，重载终端环境使命令生效：
source ~/.bashrc # 若使用zsh，替换为source ~/.zshrc - 验证安装：输入以下命令，若返回版本号则安装成功：
hermes --version
（二）Docker容器部署（进阶，环境隔离）
- 拉取官方镜像：使用Docker拉取Hermes Agent最新镜像（含WebUI）：
docker pull openclaw/hermes-agent:latest - 创建容器并启动：运行容器，映射端口并挂载配置目录：
docker run -d \ --name hermes-agent \ -p 3000:3000 \ -v ~/.hermes:/root/.hermes \ openclaw/hermes-agent:latest - 验证容器状态：查看容器运行状态，确保无异常：
docker ps | grep hermes-agent
三、Token Plan模型配置（核心步骤）
（一）交互式命令配置（快速上手）
- 启动配置向导：在ECS终端执行以下命令，进入模型配置交互模式：
hermes model - 按提示配置参数：
- 选择模型服务商：
custom（自定义） - 输入Base URL：粘贴Token Plan兼容接口地址
- 输入API Key：粘贴
sk-sp-开头的专属密钥 - 选择默认模型：如
qwen3.7-max或qwen3.6-plus - 确认配置并保存
（二）手动修改配置文件（精准自定义）
- 编辑配置文件：使用文本编辑器打开Hermes配置文件：
nano ~/.hermes/config.yaml - 写入Token Plan核心配置：在文件中添加或修改以下内容，替换为实际密钥与模型：
model: provider: custom base_url: https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 api_key: sk-sp-xxxxxxxxxxxxxxxxxxxxxxxx default: qwen3.7-max temperature: 0.7 request_timeout: 60 - 保存退出：按
Ctrl+O保存，Ctrl+X退出编辑器。
（三）Docker容器配置（适配容器部署）
- 创建.env配置文件：在ECS本地创建.env文件，写入Token Plan参数：
nano ~/.hermes/.envMODEL_BASE_URL=https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 MODEL_API_KEY=sk-sp-xxxxxxxxxxxxxxxxxxxxxxxx DEFAULT_MODEL=qwen3.7-max - 重启容器加载配置：
docker restart hermes-agent
四、服务启动与验证
（一）命令行启动（交互模式）
- 直接启动Hermes Agent：在终端输入命令，进入交互对话模式：
hermes - 测试模型调用：输入测试指令（如“你好，介绍一下自己”），若返回正常回复，说明Token Plan配置成功。
（二）后台守护启动（生产环境）
- 使用nohup后台运行：关闭终端后服务持续运行：
nohup hermes gateway & # 启动网关，支持多端接入 - 使用tmux（推荐，可重连）：创建会话并启动服务，支持断开后重连：
tmux new -s hermes hermes gateway # 退出会话：Ctrl+b d；重连：tmux attach -t hermes - 查看运行日志：排查异常时，查看日志文件：
tail -f ~/.hermes/logs/hermes.log
（三）WebUI访问验证
- 访问Web界面：在浏览器中输入
http://ECS公网IP:3000，进入Hermes WebUI控制台，查看模型配置状态、运行日志与调用统计。 - 配置检查：在WebUI中确认模型服务商、Base URL、API Key与默认模型均正确显示。
五、运维优化与常见问题排查
（一）开机自启配置
- 创建systemd服务文件：
sudo nano /etc/systemd/system/hermes.service - 写入服务配置：
```ini
[Unit]
Description=Hermes Agent Service
After=network.target
[Service]
User=root
ExecStart=/usr/local/bin/hermes gateway
Restart=always
[Install]
WantedBy=multi-user.target
3. **启用并启动服务**：
```bash
sudo systemctl daemon-reload
sudo systemctl enable hermes
sudo systemctl start hermes
（二）成本与性能优化
- 模型选型：简单任务使用qwen3.6-plus（低成本），复杂任务使用qwen3.7-max（高性能），平衡成本与效果。
- 缓存复用：开启Hermes上下文缓存，重复请求降低Token消耗，减少Credits使用。
- 用量监控：在百炼Token Plan控制台实时查看Credits消耗，设置额度提醒，避免超额费用。
（三）常见问题与解决方案
- 模型调用失败：检查API Key是否正确、未过期；确认Base URL地域与ECS实例地域一致；验证Token Plan套餐未到期、模型权限正常。
- 端口无法访问：检查ECS安全组是否放行3000端口；确认防火墙未拦截；重启Hermes服务或容器。
- 依赖安装失败：更新系统源后重新安装依赖；使用Docker部署避免环境冲突。
- Credits消耗过快：优化Prompt减少冗余内容；关闭非必要的模型功能；选择更匹配的模型规格。
六、总结
阿里云ECS部署Hermes Agent并配置Token Plan，是搭建私有化、可定制AI智能体的高效方案。通过ECS提供稳定算力，Hermes Agent实现代理逻辑与交互能力，Token Plan团队版提供高性价比的模型服务，三者结合可满足个人开发者、小型团队到企业级的AI应用需求。本指南覆盖从实例准备、安装部署、核心配置到运维优化的全流程，用户只需按步骤操作，即可快速完成部署并实现模型调用。后续可根据业务需求，扩展Hermes Agent的技能插件、对接内部系统，打造专属的AI智能体服务。
