在AI智能体与代码助手工具快速普及的当下,OpenClaw凭借多模型兼容、WebUI交互、代码执行、跨平台集成等核心能力,成为个人开发者与团队构建AI工作流的优选工具。阿里云ECS云服务器凭借稳定算力、弹性扩展与完善生态,为OpenClaw提供了理想的部署环境,而阿里云百炼平台的Coding Plan与Token Plan订阅服务,则为OpenClaw提供了高性价比、稳定可靠的大模型调用能力。本文将以保姆级步骤,详细讲解如何在阿里云ECS云服务器上一键部署OpenClaw,并完整配置百炼Coding Plan与Token Plan,帮助开发者零门槛快速上手,实现AI智能体的高效落地。
一、部署前准备:环境与账号配置
在开始部署前,需完成基础准备工作,确保部署流程顺畅,避免因环境缺失或配置错误导致失败。
- 阿里云账号与权限准备
- 注册并完成阿里云账号实名认证,确保账号处于正常可用状态,无欠费、冻结等问题。
- 若使用RAM子账号部署,需由主账号授予ECS管理权限、云助手权限、百炼平台访问权限,避免权限不足导致操作失败。
- 登录阿里云控制台,进入ECS实例管理页面,确认目标地域(如华北2、华东1)的ECS资源可用,优先选择国内地域以保障网络稳定性。
- ECS实例选型与配置
OpenClaw对服务器配置有基础要求,为保障运行流畅,推荐以下配置:
- 最低配置:1核2G内存,40G ESSD云盘,3M带宽,适合个人测试、轻量使用场景。
- 推荐配置:2核4G内存,80G ESSD云盘,5M带宽,适合日常开发、代码生成、智能体交互场景。
- 高配配置:4核8G内存,100G ESSD云盘,8M带宽,适合团队协作、多智能体并行、复杂代码执行场景。
- 系统选择:优先选择Alibaba Cloud Linux 3/4、Ubuntu 20.04/22.04、CentOS Stream 8/9等主流Linux系统,阿里云官方镜像默认预装云助手服务,无需额外安装,为一键部署提供基础支持。
- 百炼平台订阅准备
根据使用需求,提前订阅百炼Coding Plan或Token Plan,二者核心区别如下:
- Coding Plan:面向个人开发者,固定月费订阅,提供文本生成模型月度请求额度,适配交互式编程工具,价格亲民,适合个人开发、代码辅助场景。
- Token Plan:面向团队/企业用户,按Credits统一计费,支持多模态模型(文本、图像),兼容主流AI工具与智能体,提供团队管理、数据隔离等企业级功能,适合团队协作、多场景AI应用开发。
- 订阅入口:登录阿里云百炼控制台,进入「订阅管理」,选择对应计划完成订阅,获取专属API Key与Base URL。
二、阿里云ECS一键部署OpenClaw(三种方案)
零基础部署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 的地址。


阿里云提供三种一键部署OpenClaw的方案,分别适配不同使用场景,无需手动配置环境与依赖,大幅降低部署门槛。
方案一:通过云助手公共命令一键部署(推荐,通用ECS实例)
云助手是阿里云官方提供的远程命令执行工具,支持在任意ECS实例上快速执行OpenClaw安装脚本,操作简单、兼容性强。
步骤1:进入云助手页面
- 登录阿里云控制台,搜索并进入「云服务器ECS」控制台。
- 在左侧导航栏,选择「运维与监控 > 云助手」,进入公共命令列表页面。
- 在搜索框输入「OpenClaw」,找到官方公共命令
ACS-ECS-InstallOpenClaw-for-linux.sh,确认命令状态为「可用」。
步骤2:选择ECS实例并执行安装命令
- 点击公共命令卡片上的「执行」按钮,弹出执行配置面板。
- 在「选择实例」区域,勾选需要部署OpenClaw的ECS实例(可多选,批量部署),确保实例处于运行状态,且已安装云助手服务(阿里云官方镜像默认预装)。
- 无需额外配置参数,直接点击「确定」按钮,云助手将自动下发安装任务,后台完成OpenClaw的下载、安装与环境配置。
步骤3:等待部署完成并验证
- 安装过程通常需要3-5分钟,可在云助手「执行记录」页面查看进度,状态显示「成功」即部署完成。
- 通过Workbench或SSH远程连接ECS实例,执行以下命令验证OpenClaw是否安装成功:
# 验证OpenClaw版本 openclaw --version # 启动OpenClaw配置向导 openclaw onboard - 若命令正常执行,显示版本信息并进入配置向导界面,说明部署成功;若提示命令未找到,需检查安装任务是否成功,或重新执行安装步骤。
方案二:通过计算巢一键部署(专属镜像,快速启动)
阿里云计算巢提供OpenClaw专属部署镜像,预置完整运行环境,适合快速创建新实例并部署,无需手动配置ECS基础环境。
步骤1:进入计算巢部署页面
- 登录阿里云控制台,搜索并进入「计算巢」服务页面,找到「OpenClaw社区版」部署入口。
- 点击「立即部署」,进入部署参数配置页面,系统将自动生成ECS实例配置与费用预估。
步骤2:配置部署参数
- 实例配置:选择推荐的2核4G内存、80G ESSD云盘、5M带宽,地域选择华北2(北京)或华东1(杭州)。
- 系统镜像:默认选择OpenClaw专属镜像,已预装Node.js、Git、Docker环境及OpenClaw核心组件。
- 网络配置:选择默认VPC与交换机,开启公网带宽,确保实例可访问公网以调用百炼模型。
- 确认参数无误后,点击「下一步:确认订单」,核对费用后点击「立即创建」,系统将自动创建ECS实例并完成OpenClaw部署。
步骤3:远程连接并验证
- 部署完成后,在计算巢「资源列表」中找到对应ECS实例,点击「远程连接」,选择「Workbench一键连接」登录实例。
- 执行以下命令验证部署状态:
# 切换至root用户 sudo su root # 启动OpenClaw服务 openclaw start # 查看运行状态 systemctl status openclaw - 若服务状态为「active (running)」,且可正常访问WebUI,说明部署成功。
方案三:通过官方脚本手动部署(自定义环境,灵活配置)
若需自定义部署环境或使用非官方镜像,可通过OpenClaw官方脚本手动部署,适合有一定运维经验的开发者。
步骤1:安装依赖环境
- 远程连接ECS实例,执行以下命令安装Node.js、Git等依赖:
# 安装Node.js 22+(OpenClaw依赖) curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt-get install -y nodejs # 验证Node.js版本 node --version # 安装Git sudo apt install -y git # 验证Git版本 git --version
步骤2:执行官方安装脚本
# 国内加速脚本(推荐)
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
# 或官方原版脚本
# curl -fsSL https://openclaw.ai/install.sh | bash
- 脚本执行完成后,将自动启动OpenClaw配置向导,按提示完成基础配置。
步骤3:验证安装
# 验证OpenClaw安装
openclaw --version
# 启动服务
openclaw start
三、阿里云百炼Coding Plan完整配置(个人开发者首选)
Coding Plan是个人开发者调用大模型的高性价比选择,配置完成后,OpenClaw可直接调用Qwen3.5-Plus、Kimi K2.5等代码模型,实现代码生成、调试、解释等功能。
步骤1:订阅Coding Plan并获取API Key
- 登录阿里云百炼控制台,进入「Coding Plan」页面,选择适合的套餐档位(基础版/进阶版),完成订阅支付。
- 订阅成功后,在「我的订阅」页面,找到「API Key管理」,点击「创建API Key」,生成专属API Key(格式为
sk-sp-xxxxx),并复制保存(仅显示一次,需妥善保管)。 - 记录Coding Plan专属Base URL:
https://coding.dashscope.aliyuncs.com/v1
步骤2:通过配置向导配置Coding Plan(推荐)
- 远程连接ECS实例,执行以下命令启动OpenClaw配置向导:
openclaw onboard --install-daemon - 按向导提示完成配置:
- 选择「手动配置」模式;
- 模型厂商选择「阿里云百炼」;
- 认证方式选择「Coding Plan」;
- 粘贴复制的Coding Plan API Key;
- 选择默认模型(如
qwen3.5-plus); - 网关配置选择「remote」,绑定
0.0.0.0:18789; - 完成配置后,向导将自动启动OpenClaw服务。
步骤3:手动配置Coding Plan(进阶)
- 若需手动修改配置,可编辑OpenClaw配置文件:
# 创建配置目录 mkdir -p ~/.openclaw # 编辑配置文件 vim ~/.openclaw/openclaw.json - 在配置文件中添加以下内容,替换为自己的API Key与Base URL:
{ "models": { "providers": [ { "name": "aliyun_coding", "type": "openai", "apiKey": "你的Coding Plan API Key", "baseUrl": "https://coding.dashscope.aliyuncs.com/v1", "models": ["qwen3.5-plus", "kimi-k2.5", "glm-4.7"] } ], "primary": "aliyun_coding/qwen3.5-plus" }, "gateway": { "host": "0.0.0.0", "port": 18789, "auth": { "token": "生成的访问令牌" } }, "tools": { "codeExecutor": true, "webSearch": true } } - 保存并退出配置文件,执行以下命令使配置生效:
# 重启OpenClaw服务 openclaw restart # 验证配置 openclaw config show
步骤4:测试Coding Plan调用
- 启动OpenClaw交互模式,输入代码生成指令测试模型调用:
openclaw chat # 输入测试指令 请生成一个Python快速排序算法,并添加详细注释 - 若OpenClaw正常返回代码结果,说明Coding Plan配置成功,可正常使用。
四、阿里云百炼Token Plan完整配置(团队/企业首选)
Token Plan支持多模态模型调用、团队管理与用量管控,适合团队协作开发AI应用,配置完成后,OpenClaw可调用Qwen3.8-Max、万相等多模态模型,实现文本、图像生成与智能体编排。
步骤1:订阅Token Plan并获取API Key
- 登录阿里云百炼控制台,进入「Token Plan」页面,选择团队版套餐(标准坐席/高级坐席/尊享坐席),完成订阅。
- 进入「成员管理」页面,添加团队成员并分配席位,为成员生成专属API Key(格式为
sk-tp-xxxxx),复制保存API Key与Base URL:https://tp.dashscope.aliyuncs.com/v1 - 若需使用共享用量包,可在「用量管理」页面购买,补充Credits额度。
步骤2:通过配置向导配置Token Plan
- 执行以下命令启动OpenClaw配置向导:
openclaw onboard --install-daemon - 按向导提示完成配置:
- 选择「手动配置」模式;
- 模型厂商选择「阿里云百炼」;
- 认证方式选择「Token Plan」;
- 粘贴复制的Token Plan API Key;
- 选择默认模型(如
qwen3.8-max); - 开启多模态功能与团队协作选项;
- 完成配置后,向导将自动启动OpenClaw服务。
步骤3:手动配置Token Plan(进阶)
- 编辑OpenClaw配置文件:
vim ~/.openclaw/openclaw.json - 修改配置文件内容,替换为Token Plan的API Key与Base URL,配置多模型支持:
{ "models": { "providers": [ { "name": "aliyun_token", "type": "openai", "apiKey": "你的Token Plan API Key", "baseUrl": "https://tp.dashscope.aliyuncs.com/v1", "models": ["qwen3.8-max", "wanxiang-1", "deepseek-v4-flash"] } ], "primary": "aliyun_token/qwen3.8-max" }, "gateway": { "host": "0.0.0.0", "port": 18789, "auth": { "token": "团队访问令牌" } }, "tools": { "codeExecutor": true, "webSearch": true, "imageGen": true }, "team": { "enable": true, "members": ["成员1", "成员2"] } } - 保存配置文件,重启OpenClaw服务使配置生效:
openclaw restart openclaw config show
步骤4:测试Token Plan多模态调用
- 启动OpenClaw,测试文本生成与图像生成功能:
openclaw chat # 测试文本生成 请撰写一份AI智能体项目开发方案,包含需求分析、技术选型、部署流程 # 测试图像生成 生成一张科技风格的AI智能体图标,蓝色为主色调 - 若OpenClaw正常返回文本结果与图像链接,说明Token Plan配置成功,可实现多模态AI能力。
五、常见问题与避坑指南
- OpenClaw安装失败
- 原因:ECS实例未安装云助手服务、网络不通、权限不足、Node.js版本过低。
- 解决:检查实例是否为阿里云官方镜像,手动安装云助手与Node.js:
# 安装云助手(CentOS) yum install -y aliyun-assist # 启动云助手服务 systemctl start aliyun-assist systemctl enable aliyun-assist # 安装Node.js 22+ curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt-get install -y nodejs
- 百炼API Key调用失败
- 原因:API Key错误、Base URL不匹配、地域不一致、用量耗尽。
- 解决:核对API Key与Base URL,确认订阅地域与ECS实例地域一致,在百炼控制台查看Credits/请求额度是否充足。
- OpenClaw运行卡顿
- 原因:服务器配置过低、内存不足、带宽不够。
- 解决:升级ECS实例配置至2核4G以上,增加带宽至5M,清理服务器缓存:
# 清理内存缓存 sync && echo 3 > /proc/sys/vm/drop_caches # 查看资源占用 top
- WebUI无法访问
- 原因:端口未放行、防火墙拦截、服务未启动。
- 解决:在ECS安全组放行18789端口,关闭防火墙,重启OpenClaw服务:
# 放行18789端口(CentOS) firewall-cmd --add-port=18789/tcp --permanent firewall-cmd --reload # 重启OpenClaw服务 openclaw restart
六、总结
阿里云ECS云服务器为OpenClaw提供了稳定、弹性的部署环境,通过云助手、计算巢或官方脚本可实现一键部署,无需手动配置复杂环境,大幅降低上手门槛。而阿里云百炼Coding Plan与Token Plan则为OpenClaw提供了高性价比、多场景的大模型调用能力,个人开发者可选择Coding Plan实现低成本代码辅助,团队/企业用户可选择Token Plan实现多模态AI应用开发与团队协作。
通过本文的保姆级教程,开发者可快速完成OpenClaw在ECS上的部署与百炼订阅计划的配置,充分发挥AI智能体的核心能力,提升开发效率、拓展应用场景。在实际使用中,可根据业务需求灵活调整ECS配置与百炼订阅套餐,结合OpenClaw的多模型兼容与工具集成能力,持续优化AI工作流,实现技术价值的最大化。