零基础小白专属！阿里云ECS服务器云端搭建Hermes Agent+百炼Token Plan密钥配置保姆级手册

在AI智能体飞速迭代的当下，Hermes Agent作为一款主打自主进化、高灵活适配、多任务自动化的轻量化智能体框架，凭借开源免费、低资源消耗、多模型兼容、可自主迭代优化的核心优势，成为个人开发者、中小型团队搭建自动化智能服务、智能问答系统、批量任务处理工具的首选方案。相较于传统本地部署模式，依托ECS云服务器完成Hermes Agent云端部署，能够彻底解决本地设备性能不足、网络不稳定、断电停机、无法远程访问等痛点，实现7×24小时全天候稳定运行，同时支持自定义功能拓展、多并发任务处理、远程可视化管理，适配学习测试、项目开发、企业轻量化智能服务落地等多种场景。

Hermes Agent本身不自带大模型能力，想要解锁其智能问答、自主推理、任务拆解、自动化执行等核心功能，必须完成百炼Token Plan密钥配置，通过合规接口接入百炼大模型算力，才能实现完整的AI交互与智能任务处理能力。为帮助零基础用户零门槛完成部署配置，本文结合2026年最新适配规则，整理一套全程可直接复制实操、无卡点、全覆盖的保姆级教程，包含服务器环境初始化、依赖安装、源码部署、端口放行、百炼Token绑定、服务常驻设置、功能测试、故障优化全流程，所有代码命令均可直接复用，新手也能一次性部署成功。

零基础部署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密钥获取流程，为后续部署筑牢基础。

1.1 ECS服务器硬件与系统选型

Hermes Agent对运行环境兼容性极强，但搭配百炼大模型接口调用时，会产生一定的网络与算力消耗，过低的配置会导致服务卡顿、接口超时、智能体响应延迟、程序闪退等问题。结合实测部署经验，整理适配配置标准：

• 内存：最低2GB，日常测试使用可满足基础需求，高频并发、多任务运行场景推荐4GB及以上，保障智能体自主迭代、模型调用稳定；
• 操作系统：优先Ubuntu 20.04/22.04 LTS 64位系统，完美适配Hermes Agent所有部署命令、依赖库与百炼接口协议，兼容性最优；
• 网络带宽：基础3M固定带宽即可满足日常使用，高频数据交互、全网检索场景建议5M及以上带宽；
• 服务器权限：提前开启root远程登录权限，关闭系统自带防火墙拦截限制，方便后续SSH远程连接与批量命令执行。

1.2 百炼Token Plan密钥获取（核心凭证）

百炼Token Plan是Hermes Agent对接大模型算力的唯一合规凭证，分为个人基础版与团队进阶版，基础版适合个人学习测试，额度适中、性价比高；团队版拥有更高的接口调用频次、更大的并发额度与更长的服务时长，适合商用项目、长期运维使用。密钥获取流程统一且规范，具体操作如下：

1. 登录百炼大模型服务控制台，进入核心的密钥管理专属页面；
2. 点击新建创建API-Key，自定义密钥备注名称，选择绑定Token Plan服务套餐；
3. 系统自动生成sk-sp-专属前缀密钥，务必立即复制保存，该密钥仅创建弹窗展示一次，关闭页面或刷新后无法二次查看；
4. 核对密钥权限，确保开启模型调用、接口访问、数据传输、智能推理权限，避免后续模型调用失败、权限报错。
   同时记录百炼Token Plan专属接口地址，后续配置必须用到：https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1。

二、ECS服务器环境初始化实操

通过SSH远程工具连接服务器，全程采用复制粘贴命令的方式完成环境搭建，无需手动复杂配置，零基础可轻松上手。

2.1 远程连接ECS服务器

打开终端、Xshell、FinalShell等远程工具，执行以下连接命令，将参数替换为个人服务器公网IP：

ssh root@服务器公网IP

输入服务器root登录密码，验证通过后即可进入服务器终端界面，完成远程会话建立。

2.2 系统更新与基础依赖安装

Hermes Agent运行依赖Python运行环境、代码编译工具、版本控制工具及网络拓展组件，需先批量安装全套基础依赖，逐条执行以下命令：

# 更新系统软件源与已有软件包
apt update && apt upgrade -y

# 安装Python运行环境、pip工具、Git、编译核心依赖
apt install python3 python3-pip python3-dev git build-essential -y

# 安装网络加密、接口传输必备拓展组件
apt install libssl-dev libffi-dev -y

命令执行完毕后，验证环境是否安装成功，执行版本查看命令：

python3 --version
pip3 --version
git --version

终端正常输出版本号即代表环境配置成功，无报错可进入下一步操作。

2.3 配置国内pip镜像源

系统默认官方pip镜像下载速度慢、超时率高，极易出现依赖安装失败问题，更换国内镜像源可大幅提升下载效率与稳定性，执行以下命令配置：

# 配置国内高速pip镜像源
pip3 config set global.index-url https://mirrors.aliyun.com/pypi/simple/
pip3 config set global.trusted-host mirrors.aliyun.com

三、Hermes Agent源码部署与项目初始化

环境搭建完成后，通过Git拉取官方开源源码，创建专属运行目录，安装项目依赖，完成程序基础部署。

3.1 创建运行目录并拉取源码

为保证程序文件规整、方便后续运维管理，单独创建Hermes Agent运行文件夹，执行以下命令：

# 创建专属运行目录
mkdir -p /usr/local/hermes-agent

# 进入项目工作目录
cd /usr/local/hermes-agent

# 拉取官方最新开源源码
git clone https://github.com/HermesAgent/Hermes-Agent.git

# 进入源码根目录
cd Hermes-Agent

3.2 安装项目专属依赖库

项目内置依赖清单文件，一键批量安装所有运行所需组件，命令如下：

pip3 install -r requirements.txt

等待全部依赖安装完成，无红色报错、无版本冲突即为成功，黄色警告可直接忽略，不影响程序正常运行。

3.3 放行服务器运行端口

Hermes Agent默认运行端口为18790，需要同时放行服务器防火墙与安全组端口，否则外网无法访问Web管理界面，执行防火墙放行命令：

# 放行18790端口TCP协议访问权限
ufw allow 18790/tcp

# 重载防火墙规则，使配置立即生效
ufw reload

同时进入ECS安全组配置界面，新增入站规则：端口18790、协议TCP、授权地址0.0.0.0/0，保存配置，开放全网访问权限。

四、百炼Token Plan精细化配置（核心步骤）

本章节为整套教程的核心，通过命令行精准配置模型参数，绑定百炼Token密钥，让Hermes Agent成功对接大模型算力，解锁全部智能功能。

4.1 初始化项目配置文件

复制官方默认配置模板，生成可自定义修改的专属配置文件，避免修改原始源码文件：

cp config/default_config.yaml config/custom_config.yaml

4.2 命令行一键配置百炼Token参数

采用官方推荐命令行配置方式，稳定性更强、适配度更高，逐条执行以下命令，替换为个人专属密钥：

# 设置模型提供商为自定义模式，适配百炼Token Plan接口
hermes config set model.provider custom

# 配置百炼Token Plan专属接口地址
hermes config set model.base_url https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1

# 配置模型接口适配模式
hermes config set model.api_mode anthropic_messages

# 填入个人百炼Token Plan专属API密钥
hermes config set model.api_key sk-sp-xxxxxx

# 设置接口超时时间，保障高并发稳定性
hermes config set model.timeout 45

所有命令执行完成后，可通过查看配置命令校验参数是否写入成功：

hermes config list

终端完整展示上述配置参数，无缺失、无错误即代表密钥配置完成。

4.3 手动配置文件兜底方案

若命令行配置出现异常，可通过修改配置文件手动写入参数，执行编辑命令：

vim config/custom_config.yaml

进入编辑模式后，写入完整百炼模型配置参数：

model:
  provider: custom
  base_url: https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
  api_mode: anthropic_messages
  api_key: sk-sp-xxxxxx
  timeout: 45

编辑完成后按ESC，输入:wq回车保存退出。

五、配置后台常驻服务与开机自启

为解决关闭终端程序即停止运行的问题，配置系统守护进程，实现Hermes Agent后台常驻、开机自启、异常自动重启，保障长期稳定运行。

5.1 创建系统服务文件

执行命令创建专属服务配置文件：

vim /etc/systemd/system/hermes-agent.service

粘贴以下完整服务配置代码：

[Unit]
Description=Hermes Agent AI Autonomous Service
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/usr/local/hermes-agent/Hermes-Agent
ExecStart=/usr/bin/python3 main.py
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

5.2 启动服务并设置自启

依次执行以下命令，刷新系统服务、开启自启、启动程序：

# 刷新系统服务配置
systemctl daemon-reload

# 设置开机自动启动
systemctl enable hermes-agent

# 启动Hermes Agent服务
systemctl start hermes-agent

5.3 校验服务运行状态

通过状态查看命令确认程序是否正常运行：

systemctl status hermes-agent

终端显示active (running)绿色运行状态，无报错日志，代表服务启动成功。

六、Web界面访问与功能完整性测试

6.1 登录可视化管理后台

打开任意浏览器，输入访问地址：http://服务器公网IP:18790，即可进入Hermes Agent可视化Web管理后台，界面正常加载、无空白报错即代表部署成功。

6.2 百炼模型接口功能测试

1. 在后台界面进入「模型配置」页面，核对已加载的百炼接口地址与Token密钥信息；
2. 进入智能交互测试面板，输入测试指令，例如“介绍Hermes Agent智能体的核心功能与使用场景”；
3. 提交指令后，若智能体可快速响应、自主拆解问题、生成完整回答，无接口超时、密钥报错、模型调用失败提示，说明Token Plan配置完全生效，大模型算力对接成功。

6.3 生成专属访问安全Token

为提升后台访问安全性，防止恶意访问、非法篡改配置，执行命令生成专属访问凭证：

python3 token_create.py

系统自动生成加密安全Token，妥善保存，后续可通过该Token绑定访问权限，加固服务安全防护。

七、常见故障排查与长期运行优化

7.1 服务启动失败排查方案

1. 端口占用报错：执行lsof -i:18790查看占用进程，通过kill -9 进程ID终止冲突进程，重启服务即可；
2. 依赖缺失报错：重新执行pip3 install -r requirements.txt补全缺失依赖，修复版本冲突问题；
3. 密钥报错：检查密钥前缀是否为sk-sp-，确认无空格、字符缺失、格式错误，核对Token Plan套餐权限是否正常生效。

7.2 模型调用异常优化

1. 接口超时：适当调高配置文件中timeout数值，调整为50-60秒，适配复杂任务推理场景；
2. 响应缓慢：清理服务器冗余进程，执行top命令查看资源占用，关闭无用后台程序，释放算力资源；
3. 调用失败：登录百炼控制台查看Token额度，确认无额度耗尽、服务暂停等情况。

7.3 长期运维优化技巧

1. 日志清理：定期执行rm -rf /usr/local/hermes-agent/Hermes-Agent/logs/*清理缓存日志，释放服务器存储空间；
2. 版本更新：进入项目目录执行git pull拉取官方最新更新，迭代新增功能、修复已知漏洞；
3. 状态监控：通过systemctl status hermes-agent实时监控服务运行状态，及时排查异常。

八、部署总结

本文完整还原了ECS云服务器部署Hermes Agent智能体的全流程实操步骤，从服务器环境初始化、源码拉取、依赖安装、端口放行，到百炼Token Plan密钥配置、系统常驻服务搭建、Web功能测试、故障优化，每一步均经过实测验证，适配2026年最新的框架版本与接口协议。

相较于本地部署，云端ECS部署模式彻底规避了设备性能、网络、断电等各类问题，搭配百炼Token Plan稳定的大模型算力支持，能够充分发挥Hermes Agent自主进化、自动任务处理、智能推理交互的核心优势。整套部署流程无需深厚的开发功底，所有操作标准化、代码可直接复刻，新手也能快速完成搭建。部署完成后的智能体可广泛应用于日常智能问答、批量自动化任务处理、个人项目开发、企业轻量化AI服务搭建等场景，7×24小时稳定运行，运维简单、拓展性极强，是目前低成本搭建自主进化AI智能体的最优方案之一。