从零搭建AI Agent：阿里云ECS云服务器上OpenClaw/Hermes Agent部署实战完整指南

一、部署前准备与ECS选型

在正式开始部署OpenClaw和Hermes Agent之前，先把基础环境搭好。ECS实例选型其实没有太多玄学，核心就是算力、网络和存储要到位。推荐配置如下：

• 实例规格
  ：建议选4核4GB起步（比如ecs.g7a.large）。如果用的是共享型实例（ecs.t6/s6），最好升到4核8GB，否则多服务并发跑起来容易卡顿。

• 操作系统
  ：Linux下推荐Alibaba Cloud Linux 3或Ubuntu 22.04 LTS；Windows也支持，选Windows Server 2019/2022就行。注意一定要分配公网IPv4地址。

• 存储与带宽
  ：系统盘至少40GB，带宽不低于2Mbps。AI Agent的数据传输和外部访问都需要带宽支撑，别太抠。

• 安全组配置
  ：入方向要放行22端口（SSH远程连接）、18789端口（OpenClaw Web控制台）、18800端口（Skills运行端口）。测试阶段来源可以设为0.0.0.0/0，稳定运行后建议改为指定IP白名单。

图片位置参考：

（二）前置依赖与账号准备

1. 阿里云账号
   ：先完成实名认证，开通ECS和百炼大模型服务，拿到百炼API Key——这是后面调AI模型的关键。

2. 本地工具
   ：装好SSH客户端（比如FinalShell、Xshell），用来远程连ECS；浏览器用来访问Web控制台。

3. 环境依赖
   ：ECS上需要预装Node.js 22.x以上、Git、npm。国内环境建议配好npm镜像加速（https://registry.npmmirror.com），不然下载依赖慢到怀疑人生。

如果你是完全零基础，别慌。下面是一套喂饭级的步骤流程：

第一步：

，配置参考如下：

• 镜像：选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——按次收费，比按tokens计费更划算。每天还有两场抢购活动。

• 购买后，在控制台生成API Key。注意：复制并保存好你的API Key，后面要用。
• 回到轻量应用服务器控制台，单击服务器卡片中的实例ID，进入服务器概览页。
• 在服务器概览页面单击应用详情页签，进入服务器详情页面。
• 端口放通：在OpenClaw使用步骤区域中，单击端口放通下的执行命令，可开放获取OpenClaw服务运行端口的防火墙。
• 这里系统会列出我们第一步中创建的阿里云百炼Coding Plan的API Key，直接选择就行。
• 获取访问地址：单击访问Web UI面板下的执行命令，获取OpenClaw WebUI的地址。

二、OpenClaw在ECS的部署与配置

（一）一键脚本安装（新手首选）

1. 远程连接ECS
   ：通过SSH工具登录，用户名root，输入实例密码或密钥对验证。

2. 执行安装脚本
   ：

   # 国内镜像加速安装
   curl -fsSL https://openclaw.ai/install.sh | bash
   

   脚本会自动检测系统、安装Node.js与依赖、创建虚拟环境、配置环境变量，全程大约5到10分钟。

3. 初始化配置（Onboard）
   ：安装完成后执行openclaw onboard，按向导完成配置：
   • 工作区路径：默认即可（存储配置与会话）。
   • 模型提供商：选择阿里云百炼，粘贴已获取的API Key。
   • 网关端口：默认18789，不用改。
   • 守护进程：输入Y，开启后台运行与开机自启。

（二）手动配置与验证

1. 编辑配置文件
   ：

   cd /opt/openclaw
   vim config/config.json
   # 找到aliyun_bailian_api_key字段，粘贴API Key，保存退出
   

2. 验证安装
   ：

   openclaw --version  # 查看版本
   openclaw status     # 检查服务状态
   

3. 访问Web控制台
   ：浏览器输入http://ECS公网IP:18789，进入OpenClaw界面，测试AI对话与代码生成功能。

（三）进程托管与后台运行

使用pm2实现服务后台常驻、异常重启与开机自启：

# 安装pm2
npm install -g pm2
# 启动OpenClaw
cd /opt/openclaw
pm2 start npm --name openclaw -- run start
# 配置开机自启
pm2 startup
pm2 sa ve

三、Hermes Agent在ECS的部署与配置

（一）一键脚本安装（推荐）

1. 执行国内镜像安装脚本
   ：

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

   脚本自动安装Python、Node.js、ripgrep等依赖，克隆仓库、配置全局hermes命令。

2. 刷新环境变量
   ：

   source ~/.bashrc  # bash用户
   # 或 source ~/.zshrc  # zsh用户
   

3. 验证安装
   ：执行hermes --version，输出版本信息即成功。

（二）模型与API配置

1. 运行配置向导
   ：

   hermes setup
   

   按提示选择模型提供商（阿里云百炼），输入API Key，配置模型版本（如qwen-max）。

2. 手动配置（可选）
   ：

   # 配置模型
   hermes model set provider aliyun-bailian
   hermes model set api-key "你的百炼API Key"
   hermes model set model qwen-max
   

（三）Docker部署（生产环境）

1. 安装Docker
   ：

   sudo apt install docker.io -y
   sudo systemctl start docker
   sudo systemctl enable docker
   sudo usermod -aG docker $USER  # 免sudo执行，需重新登录
   

2. 拉取镜像并启动
   ：

   mkdir -p ~/.hermes/docker-config
   docker run -d 
   -v ~/.hermes/docker-config:/root/.hermes 
   -p 8080:8080 
   nousresearch/hermes-agent:latest
   

3. 验证容器运行
   ：docker ps查看容器状态，访问http://ECS公网IP:8080测试服务。

（四）进程托管

和OpenClaw一样，用pm2来托管Hermes Agent：

cd ~/.hermes
pm2 start npm --name hermes -- run start
pm2 sa ve

四、双Agent协同配置与功能验证

（一）配置互通与技能集成

1. OpenClaw集成Hermes
   ：在OpenClaw Web控制台的「技能」模块，添加Hermes Agent作为外部技能，配置API地址（http://localhost:8080）与认证信息。

2. Hermes调用OpenClaw
   ：编辑Hermes配置文件，添加OpenClaw网关地址，实现双向调用，扩展AI能力边界。

（二）功能测试

1. OpenClaw测试
   ：在Web控制台输入代码生成需求（比如“用Python写一个冒泡排序算法”），验证代码补全、生成与调试功能。

2. Hermes Agent测试
   ：终端执行hermes，进入对话模式，测试任务拆解、代码生成、工具调用（如文件操作、网络请求）。

3. 协同测试
   ：通过OpenClaw触发Hermes执行复杂任务（如“分析项目代码并生成优化报告”），验证跨Agent协作效果。

五、常见问题与避坑指南

（一）安装问题

1. 依赖安装失败
   ：国内网络环境下，优先使用国内镜像脚本；若npm安装报错，执行npm config set registry https://registry.npmmirror.com切换镜像。

2. 端口占用
   ：如果18789/8080端口被占用，修改配置文件中的端口参数，同时更新安全组规则。

3. 权限不足
   ：Linux下执行命令需加sudo，或切换至root用户操作。

（二）配置问题

1. API Key无效
   ：检查百炼API Key是否正确、是否过期，确保账号有足够调用配额。

2. 服务无法启动
   ：查看pm2日志（pm2 logs openclaw/pm2 logs hermes），定位配置错误或依赖缺失问题。

3. Web控制台无法访问
   ：确认ECS安全组已放行对应端口，公网IP正确，服务正常运行。

（三）性能与稳定性

1. 内存不足
   ：升级ECS实例规格至4核8GB及以上，关闭不必要的后台进程。

2. 服务频繁重启
   ：配置pm2内存阈值（pm2 set pm2:max_memory_restart 4G），避免内存溢出导致重启。

3. 网络延迟
   ：选择靠近业务区域的ECS地域，提升API调用与访问速度。

六、总结

阿里云ECS为OpenClaw与Hermes Agent提供了稳定、弹性的运行环境。通过一键脚本和Docker两种部署方式，可以快速完成AI Agent的搭建与配置。从ECS选型、安全组设置，到双Agent的安装、模型配置与协同调试，全程覆盖了从0到1的实操流程，兼顾了新手友好性和生产环境稳定性。

OpenClaw侧重Web端代码生成与可视化管理，Hermes Agent则擅长终端任务执行与工具集成。两者协同，可以覆盖编码、调试、自动化等全场景AI开发需求。掌握了这套部署方法，开发者就能快速搭建专属AI Agent集群，大幅提升开发效率，真正把AI技术在软件开发中的价值释放出来。