保姆级教程：阿里云轻量服务器一键部署Hermes Agent，完整配置百炼Coding/Token Plan指南

在AI开发与智能体应用快速普及的当下，Hermes Agent凭借其自进化能力、跨会话记忆与高效代码生成特性，成为个人开发者与小型团队打造专属AI助手的优选。而阿里云轻量服务器以低成本、易操作、高稳定性的优势，成为部署Hermes Agent的理想载体。同时，阿里云百炼平台的Coding Plan与Token Plan，为Hermes Agent提供了灵活、高性价比的大模型调用方案。本教程将从服务器购买、Hermes Agent一键部署，到百炼Coding/Token Plan订阅、API Key配置，再到最终验证与优化，全程保姆级指导，让你零基础也能快速完成部署，打造专属AI智能体。

一、部署前准备：账号与资源配置

1.1 阿里云账号注册与充值

首先，你需要拥有一个阿里云账号。若尚未注册，可访问阿里云官网，通过手机号、邮箱或支付宝扫码完成注册。注册成功后，为确保云资源与百炼服务正常使用，需为账号充值。轻量服务器与百炼服务均支持按量付费，建议账户余额不低于100元，避免因余额不足导致服务中断。充值可通过支付宝、微信等方式完成，操作便捷。

零基础部署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 的地址。
  
  

  1.2 轻量服务器选型与购买

  阿里云轻量应用服务器（SAS）专为轻量级应用设计，具备一键部署、管理简单、成本低廉的特点，非常适合部署Hermes Agent。选型时需注意以下几点：
• 实例配置：Hermes Agent运行至少需要2GiB内存，建议选择2核4GiB及以上配置，确保运行流畅。个人开发者可选择2核4GiB，小型团队可选择4核8GiB，平衡性能与成本。
• 地域选择：优先选择离你所在地最近的地域（如华东1、华北2），降低网络延迟。若需对外提供服务，内地地域需完成备案，海外地域（如新加坡）无需备案，可根据需求选择。
• 镜像选择：在购买页面的“应用镜像”中，直接选择Hermes Agent官方镜像，无需手动配置环境与依赖，实现一键部署。
• 购买时长：可选择包月、包季或包年，包年价格更优惠，适合长期使用。

购买流程：登录阿里云控制台，进入“轻量应用服务器”页面，点击“立即购买”。在配置页面选择上述参数，确认订单并完成支付。支付成功后，系统将自动开始部署，通常3-5分钟即可完成。

1.3 百炼平台服务开通

阿里云百炼（Model Studio）是一站式大模型服务平台，提供Coding Plan与Token Plan两种订阅方案，支持Hermes Agent调用各类大模型。首次使用需开通服务：登录阿里云控制台，搜索“百炼”进入平台，阅读并同意服务协议，点击“同意并开通”即可完成开通。

二、阿里云轻量服务器一键部署Hermes Agent

2.1 服务器部署完成验证

购买完成后，返回轻量应用服务器控制台，在实例列表中找到刚购买的服务器。状态显示“运行中”即部署成功。点击实例ID进入服务器概览页面，可查看IP地址、运行状态等信息。

2.2 一键安装Hermes Agent

阿里云轻量服务器的Hermes Agent镜像已预装所有依赖，无需手动执行安装命令，仅需完成初始化配置：

1. 在服务器概览页面，点击“应用详情”页签，找到“配置Hermes”模块。
2. 点击“初始化配置百炼API Key”，进入配置向导。此步骤将绑定百炼API Key，实现Hermes Agent与大模型的连接。
3. 选择百炼地域（需与后续订阅的Coding/Token Plan地域一致，如华北2），在下拉框中可选择已订阅的Coding Plan API Key，或手动输入按量计费API Key。
4. 点击“下一步”完成配置，系统将自动写入API Key并启动Hermes Agent服务。

2.3 命令行验证安装

为确保Hermes Agent安装成功，可通过远程连接执行命令验证：

1. 在服务器概览页面，点击“远程连接”，选择“Workbench一键连接”，输入服务器密码登录。
2. 执行以下命令查看Hermes Agent版本：

   hermes --version
   

   若返回版本号（如0.14.0及以上），则安装成功。
3. 执行以下命令启动Hermes Agent对话：

   hermes
   

   成功启动后，即可在命令行与Hermes Agent交互，测试基础功能。

2.4 WebUI访问与端口配置

Hermes Agent提供WebUI界面，方便可视化管理与配置。默认端口为18789，需在轻量服务器防火墙中放通该端口：

1. 在服务器概览页面，点击“防火墙”，添加规则：协议“TCP”，端口“18789”，来源“0.0.0.0/0”，保存规则。
2. 返回“应用详情”页签，点击“访问WebUI面板”下的“安全代理访问”，获取WebUI地址。
3. 在浏览器中打开该地址，可查看Hermes Agent版本、日志、配置信息，0.14.0及以上版本支持WebUI对话功能。

三、阿里云百炼Coding Plan与Token Plan订阅与配置

3.1 Coding Plan与Token Plan核心区别

百炼平台的Coding Plan与Token Plan针对不同用户场景设计，核心区别如下：

• Coding Plan：专为个人开发者设计，聚焦交互式编程场景，支持Qwen Code、Claude Code等代码模型，按请求次数计费，提供固定月度额度，适合个人日常编码辅助。
• Token Plan：面向团队/企业用户，支持多模态任务（文本、图像生成），兼容Qoder、OpenClaw等多种AI工具，按Credits计量计费，提供多档位坐席套餐，支持团队共享额度。

3.2 Coding Plan订阅与API Key获取

3.2.1 订阅Coding Plan

1. 登录百炼控制台，进入“Coding Plan”页面，点击“立即订阅”。
2. 选择套餐档位（基础版、进阶版）与订阅周期（包月/包季/包年），确认订单并支付。
3. 主账号可直接订阅，RAM子账号需由主账号在百炼权限管理页面授予管理员权限后，方可订阅。

3.2.2 获取Coding Plan专属API Key

1. 订阅成功后，返回Coding Plan页面，找到“API Key管理”模块。
2. 点击“创建API Key”，归属业务空间选择“默认”，权限选择“全部”，点击“确定”。
3. 系统生成以sk-sp-开头的API Key，仅显示一次，请立即复制并保存到安全位置（如本地记事本）。
4. 记录Coding Plan的Base URL：OpenAI兼容协议为https://coding.dashscope.aliyuncs.com/v1，Anthropic兼容协议为https://coding.dashscope.aliyuncs.com/apps/anthropic。

3.3 Token Plan订阅与API Key获取

3.3.1 订阅Token Plan团队版

1. 进入百炼“Token Plan团队版”页面，点击“立即订阅”。
2. 选择坐席档位：标准坐席（198元/席/月，25,000 Credits/月）、高级坐席（698元/席/月，100,000 Credits/月）、尊享坐席（1398元/席/月，250,000 Credits/月），可根据团队人数与使用强度选择。
3. 选择订阅周期，支持共享用量包（5000元/个，625,000 Credits/个），超出套餐额度时可抵扣。
4. RAM用户需由主账号在RAM控制台授予AliyunTokenPlanFullAccess与AliyunBSSReadOnlyAccess策略，并在百炼账号管理页面分配订阅权限。

3.3.2 获取Token Plan专属API Key

1. 订阅成功后，进入Token Plan“成员管理”页面，创建成员账号并分配席位。
2. 为成员生成API Key，格式为sk-tp-开头，同样仅显示一次，需妥善保存。
3. Token Plan的Base URL为https://dashscope.aliyuncs.com/compatible-mode/v1（华北2地域）。

3.4 Hermes Agent中配置百炼API Key

3.4.1 命令行配置

通过远程连接登录服务器，执行以下命令配置Coding Plan API Key：

# 配置Coding Plan API Key与Base URL
hermes config set provider aliyun-coding
hermes config set api_key sk-sp-xxxxxxxxxxxxxxxxxxxxxxxx
hermes config set base_url https://coding.dashscope.aliyuncs.com/v1

若配置Token Plan，命令如下：

# 配置Token Plan API Key与Base URL
hermes config set provider aliyun-token
hermes config set api_key sk-tp-xxxxxxxxxxxxxxxxxxxxxxxx
hermes config set base_url https://dashscope.aliyuncs.com/compatible-mode/v1

配置完成后，重启Hermes Agent服务：

hermes restart

3.4.2 WebUI可视化配置

1. 打开Hermes Agent WebUI，进入“设置”页面。
2. 在“模型提供商”中选择“阿里云百炼”，分别填入Coding/Token Plan的API Key与Base URL。
3. 点击“保存配置”，系统自动生效，无需重启服务。

四、功能验证与优化：让Hermes Agent高效运行

4.1 基础功能测试

配置完成后，测试Hermes Agent的核心功能：

1. 代码生成测试：在命令行或WebUI中输入“生成一个Python快速排序算法”，验证是否返回正确代码。
2. 跨会话记忆测试：先告知Hermes Agent“我的代码风格偏好简洁、注释清晰”，再生成新代码，验证是否遵循偏好。
3. 模型切换测试：修改配置为Token Plan，测试多模态功能（如“生成一张AI编程场景的图片描述”）。

4.2 性能优化配置

为提升Hermes Agent运行效率，可进行以下优化：

1. 内存优化：编辑Hermes Agent配置文件~/.hermes/config.yaml，调整max_memory参数为服务器内存的70%（如4GiB内存设置为2867MiB）。
2. 并发控制：在配置文件中设置max_concurrent参数，个人用户建议设置为2，团队用户可根据服务器配置调整为4-8。
3. 日志清理：定期清理日志文件，避免占用磁盘空间：

   # 清理7天前的日志
   find ~/.hermes/logs -mtime +7 -delete
   

4.3 常见问题排查

4.3.1 API Key配置失败

• 问题：配置API Key后，Hermes Agent提示“鉴权失败”。
• 解决：检查API Key是否复制完整、无空格；确认Coding/Token Plan已订阅且未过期；确保地域与Base URL匹配；检查账号余额是否充足。

4.3.2 WebUI无法访问

• 问题：浏览器打开WebUI地址显示“无法连接”。
• 解决：确认轻量服务器防火墙已放通18789端口；检查服务器是否正常运行；重启Hermes Agent服务。

4.3.3 模型调用失败

• 问题：Hermes Agent无法调用大模型，提示“额度不足”。
• 解决：Coding Plan检查月度请求额度是否耗尽；Token Plan检查Credits余额，可购买共享用量包补充；确认未违规使用（如自动化脚本调用），避免API Key封禁。

五、总结与后续拓展

通过本教程，你已完成阿里云轻量服务器Hermes Agent的一键部署，并成功配置百炼Coding Plan与Token Plan，实现了专属AI智能体的搭建。Hermes Agent的自进化能力将持续优化交互体验，而百炼平台的灵活计费方案，让你以低成本享受高效大模型服务。

后续可进一步拓展功能：配置消息渠道（如微信、Slack）实现多端交互；集成OpenClaw等工具提升代码开发效率；结合阿里云其他服务（如对象存储OSS）实现数据持久化。随着AI技术的发展，Hermes Agent与阿里云生态的结合，将为个人开发者与团队带来更强大的AI生产力。