OpenClaw作为一款现代化AI智能体框架,凭借GUI+CLI双操作、长程自治与多模态交互能力,成为开发者与企业搭建专属AI助手的优选工具。阿里云计算巢提供OpenClaw一键部署方案,无需手动配置复杂环境,即可快速搭建稳定运行的服务实例;搭配阿里云百炼Coding Plan与Token Plan,可无缝对接通义千问系列大模型,为OpenClaw注入强大的AI核心能力。本文将从部署前准备、计算巢一键部署、百炼双Plan配置、功能验证与避坑指南四大维度,提供完整实战教程,帮助零基础用户快速完成OpenClaw部署与大模型对接,解锁AI智能体全场景能力。
一、部署前置准备:资源与环境清单(必看)
在开始部署前,需完成以下准备工作,确保部署流程顺畅无中断:
(一)账号与权限准备
- 注册并完成阿里云账号实名认证,确保账号无欠费,具备计算巢服务与轻量应用服务器购买权限。
- 开通阿里云百炼(Model Studio)服务,用于后续获取Coding Plan与Token Plan的API密钥。
- (可选)若需对接钉钉、飞书等IM工具,提前准备对应平台的开发者账号与机器人权限。
(二)服务器资源配置
计算巢部署OpenClaw推荐配置如下,可根据实际需求调整:
- 实例规格:2核4GB内存及以上(最低要求2GB内存,否则核心服务无法启动)。
- 操作系统:Alibaba Cloud Linux 3、Ubuntu 22.04/24.04、Debian 12等Linux系统(阿里云预装镜像已适配,无需手动配置)。
- 网络环境:实例需开通公网IP,确保能访问阿里云百炼大模型API,国内地域网络通畅即可。
- 付费类型:支持按量付费与包年包月,新手推荐按量付费,灵活控制成本。
(三)工具与信息准备
- 本地电脑安装SSH工具(如FinalShell、Xshell),或直接使用阿里云Web终端,用于远程登录服务器执行命令。
- 准备文本编辑器,用于保存API密钥、公网IP等敏感信息,避免丢失。
- 提前规划OpenClaw服务实例名称、地域(如华东1、华北2),便于后续快速选择。
零基础部署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(最快方案)
计算巢提供OpenClaw社区版一键部署服务,全程可视化操作,无需手动安装依赖与配置环境,是新手首选部署方式。以下为详细步骤:步骤1:进入计算巢OpenClaw部署页面
登录阿里云控制台,搜索并进入「计算巢服务」,在服务市场搜索「OpenClaw社区版」,或直接访问官方部署链接,进入部署配置页面。
步骤2:配置部署参数(核心步骤)
在部署配置页面,依次填写以下参数,确保信息准确:
- 服务实例信息:填写自定义的服务实例名称(如OpenClaw-AI-Agent),选择部署地域(推荐就近地域,降低延迟)。
- 资源配置:选择实例规格(推荐2核4GB),设置实例登录密码(需牢记,用于后续SSH登录),选择付费类型(按量付费/包年包月)。
- 服务配置:此步骤可暂时留空,待部署完成后再配置百炼API密钥,避免部署过程中因密钥错误导致失败。
- 确认询价:页面下方会显示配置对应的费用明细,确认无误后点击「下一步:确认订单」。
步骤3:提交订单并等待部署完成
- 阅读并同意服务协议,点击「立即创建」,提交部署订单。
- 系统自动开始创建实例与部署OpenClaw,整个过程约5-10分钟,可在「服务实例」页面查看部署进度。
- 当实例状态显示为「已部署」,且「立即使用」区域显示ClawdbotAddresses服务地址链接时,代表部署成功。
步骤4:获取实例公网IP与验证部署
- 进入服务实例详情页,在「实例信息」中复制公网IP,保存至本地文本编辑器。
- 打开浏览器,输入访问地址:
http://你的计算巢公网IP:18789(默认端口18789),若正常加载OpenClaw登录界面,则部署成功。
步骤5:初始化OpenClaw(命令行操作)
部署完成后,需通过命令行完成OpenClaw初始化,生成管理员Token,用于登录Web控制台。以下为详细命令(直接复制执行):
# 1. SSH登录计算巢实例(替换为你的公网IP与密码)
ssh root@你的计算巢公网IP
# 2. 进入OpenClaw安装目录
cd /opt/openclaw
# 3. 切换国内npm镜像,加速依赖下载
npm config set registry https://registry.npmmirror.com/
# 4. 一键初始化OpenClaw(非交互式,自动配置基础环境)
openclaw init --non-interactive --accept-risk --enable-skill-market
# 5. 安装ClawHub客户端(Skill扩展必备)
npm install -g clawhub-cli
# 6. 后台启动OpenClaw网关服务
openclaw gateway start --daemon
# 7. 生成管理员Token(复制保存,用于登录Web控制台)
openclaw token generate --admin --allow-ip 0.0.0.0/0
执行完成后,会生成一串以claw_开头的管理员Token,务必复制保存,后续登录Web控制台需使用。
三、阿里云百炼Coding Plan与Token Plan配置实战
OpenClaw的核心AI能力依赖阿里云百炼大模型,Coding Plan与Token Plan是两种主流计费方案,分别适用于代码开发与通用场景。以下为两种方案的开通、API密钥获取与OpenClaw对接全流程。
(一)方案一:Coding Plan配置(代码开发首选)
Coding Plan为固定月费订阅,按模型调用次数计量,内置Qwen3.7-Plus、Qwen3.5-Plus等8个模型,适合代码生成、项目开发等高频调用场景。
步骤1:开通Coding Plan
- 登录阿里云百炼控制台,进入「Coding Plan」页面,选择Pro高级版(200元/月,每月至高90,000次请求),完成订阅支付。
- 订阅成功后,进入「我的订阅」页面,点击「生成API Key」,复制以
sk-开头的API密钥(仅显示一次,妥善保存)。 - 记录Coding Plan专属Base URL:
https://coding.dashscope.aliyuncs.com/v1。
步骤2:OpenClaw对接Coding Plan
- SSH登录计算巢实例,进入OpenClaw配置目录:
cd /opt/openclaw/config - 编辑百炼配置文件(若不存在则创建):
vim bailian.json - 写入以下配置内容,替换
YOUR_CODING_API_KEY为你的Coding Plan API密钥:{ "provider": "bailian-coding-plan", "api_key": "YOUR_CODING_API_KEY", "base_url": "https://coding.dashscope.aliyuncs.com/v1", "model": "qwen3.7-plus", "temperature": 0.7, "max_tokens": 4096 } - 保存并退出编辑器(
:wq),重启OpenClaw网关服务使配置生效:openclaw gateway restart
(二)方案二:Token Plan配置(通用场景首选)
Token Plan按Token消耗抵扣Credits,分为个人版与团队版,支持通义千问全系列模型,适合日常问答、内容创作、多模态交互等通用场景。
步骤1:开通Token Plan
- 进入阿里云百炼「Token Plan」页面,选择个人版或团队版套餐,完成订阅支付。
- 订阅成功后,在「我的订阅」页面生成API Key,复制保存,并记录对应Base URL(个人版:
https://token-plan.cn-beijing.maas.aliyuncs.com)。
步骤2:OpenClaw对接Token Plan
- 进入OpenClaw配置目录,编辑Token Plan配置文件:
cd /opt/openclaw/config vim token-plan.json - 写入以下配置,替换
YOUR_TOKEN_API_KEY为你的Token Plan API密钥:{ "provider": "bailian-token-plan", "api_key": "YOUR_TOKEN_API_KEY", "base_url": "https://token-plan.cn-beijing.maas.aliyuncs.com", "model": "qwen3.7-plus", "temperature": 0.7, "max_tokens": 4096, "top_p": 0.9 } - 保存退出,重启OpenClaw网关服务:
openclaw gateway restart
(三)双Plan切换配置(灵活适配场景)
若需在Coding Plan与Token Plan之间切换,无需修改配置文件,直接通过OpenClaw命令行切换模型提供商:
# 切换至Coding Plan
openclaw config set provider bailian-coding-plan
# 切换至Token Plan
openclaw config set provider bailian-token-plan
# 重启网关生效
openclaw gateway restart
四、功能验证与测试:确保配置成功
完成部署与配置后,需通过以下步骤验证OpenClaw与百炼大模型对接是否正常:
(一)Web控制台验证
- 打开浏览器,访问
http://你的计算巢公网IP:18789,使用之前生成的管理员Token登录。 - 进入「Chat」对话窗口,发送测试指令(如“帮我写一个Python快速排序算法”),若模型正常返回结果,代表对接成功。
(二)命令行验证
- SSH登录实例,执行以下命令测试大模型调用:
```bash测试Coding Plan调用
openclaw chat --provider bailian-coding-plan --message "解释什么是AI智能体"
测试Token Plan调用
openclaw chat --provider bailian-token-plan --message "生成一份AI项目开发计划"
2. 若命令行正常返回模型响应,说明配置无误。
### (三)多模态功能测试
OpenClaw支持图像输入,可测试视觉理解能力:
```bash
# 发送图片+文本指令(替换为你的图片URL)
openclaw chat --image "https://example.com/product-screenshot.png" --message "根据这张截图生成HTML代码"
若模型返回对应的代码结果,代表多模态功能正常。
五、常见问题与避坑指南
(一)部署失败常见原因
- 实例规格不足:内存低于2GB会导致OpenClaw核心服务启动失败,务必选择2核4GB及以上配置。
- 网络不通:实例未开通公网IP,或防火墙限制了18789端口,需在安全组中开放18789端口。
- 密码设置错误:实例登录密码不符合复杂度要求,需包含大小写字母、数字与特殊符号。
(二)百炼配置失败解决方法
- API密钥错误:复制API密钥时遗漏字符,或使用了错误Plan的密钥,需重新生成并核对。
- Base URL错误:Coding Plan与Token Plan的Base URL不同,需严格按照教程填写。
- 模型名称错误:需使用百炼支持的模型名称(如qwen3.7-plus、qwen3.5-plus),避免拼写错误。
(三)服务异常重启方法
若OpenClaw服务异常,可通过以下命令重启:
# 计算巢实例内重启服务
/opt/.swas/run-cmd.sh restart
# 或使用OpenClaw命令重启
openclaw gateway restart
六、总结
通过阿里云计算巢一键部署OpenClaw,搭配阿里云百炼Coding Plan与Token Plan,可快速搭建功能完整的AI智能体服务。计算巢的可视化部署大幅降低了环境配置门槛,百炼双Plan则为OpenClaw提供了灵活的AI能力支撑,无论是代码开发、办公自动化还是多模态交互,都能满足不同场景需求。
本教程覆盖从部署前准备到功能验证的全流程,包含详细的命令行操作与配置示例,零基础用户也能轻松上手。完成部署后,可进一步探索OpenClaw的Skill扩展、GUI操作、长程自治等高级功能,结合阿里云百炼的强大模型能力,打造专属的AI智能助手,提升个人与企业的工作效率。