一、部署前核心准备(新手必看,避坑第一步)
2026年,阿里云计算巢是部署OpenClaw(Clawdbot)最适合新手的方案,官方已完成环境封装、依赖预装与安全配置,全程可视化操作,无需代码基础即可完成。部署前需完成3项核心准备,避免后续踩坑。
(一)账号与权限准备
- 阿里云账号:注册阿里云账号并完成个人/企业实名认证,未实名无法创建计算巢实例与获取大模型API密钥。新用户可享计算巢短期试用与百炼大模型免费额度,满足初期测试需求。
- 子账号权限(企业用户):主账号需为子账号分配计算巢实例创建、配置管理、资源访问权限,否则无法操作部署流程。
- 核心凭证:提前访问登录阿里云百炼大模型服务平台 获取阿里云百炼API-Key(OpenClaw调用大模型的核心授权),无此密钥OpenClaw无法响应任何指令。
(二)资源与地域选择(避坑关键)
- 实例规格:新手推荐2核4GB内存+40GB ESSD云盘,这是OpenClaw稳定运行的最低配置。内存低于2GB会导致服务启动失败、频繁崩溃;存储40GB可满足程序、日志与基础技能存储需求。
- 地域选择:优先选中国香港、新加坡、美国弗吉尼亚,无需ICP备案,联网搜索功能不受限。国内内地地域(除香港)需备案,且联网搜索功能受限,不推荐新手选择。
- 网络配置:必须启用公网IP(自动分配IPv4),否则无法访问OpenClaw控制台;带宽选200Mbps及以上,保障模型调用与界面访问流畅。
(三)工具与信息备份
- 准备记事本,保存阿里云账号密码、百炼API-Key、服务器公网IP、OpenClaw管理员Token,避免信息丢失。
- 关闭本地防火墙与VPN,确保能正常访问阿里云控制台与OpenClaw服务。
二、阿里云计算巢部署OpenClaw(零代码,10分钟完成)
(一)进入部署页面(1分钟)
- 登录阿里云控制台,访问阿里云计算巢OpenClaw社区版部署页面,进入「计算巢服务」控制台。
- 左侧导航栏点击服务目录,搜索框输入OpenClaw或Clawdbot,找到OpenClaw社区版(原Clawdbot)官方认证模板(认准官方标识,避免第三方模板安全隐患)。
- 点击模板卡片立即部署,阅读服务协议并勾选同意,进入配置页面。

(二)基础配置(3分钟,零修改默认即可)
- 地域与可用区:选择中国香港/新加坡/美国弗吉尼亚,可用区默认即可。
- 实例规格:选择2核4GB内存,系统盘40GB ESSD云盘,无需修改。
- 网络设置:勾选自动分配公网IP,安全组选择OpenClaw专属安全组(已默认放行18789、22端口,无需手动配置)。
- 登录设置:设置root登录密码(复杂度:大小写+数字+特殊符号),保存备用。
(三)应用配置(核心步骤,必改1处)
- 阿里云百炼API-Key:粘贴提前获取的API-Key(格式:sk-xxxx),严禁复制空格/换行,否则模型对接失败。
- 主模型选择:默认alibaba-cloud/qwen3-max-2026(通义千问最新版,适配所有功能,无需修改)。
- 日志级别:默认info(新手友好,可查看基础运行日志)。
- 管理员Token:选择自动生成(安全性更高),部署完成后复制保存。
(四)确认部署与等待(2分钟)
- 核对所有配置无误,点击确认部署,完成支付(新用户试用免费)。
- 等待3-5分钟,计算巢自动完成实例创建、环境配置、OpenClaw安装与服务启动。
- 实例状态变为已部署/运行中,复制公网IP与管理员Token,部署完成。
(五)验证部署(2分钟,确保成功)
- 浏览器访问:
http://服务器公网IP:18789?token=你的管理员Token。 - 进入OpenClaw控制台,发送测试指令:
你好,介绍一下自己。 - 正常回复则部署成功;无响应则按下文避坑指南排查。
零基础部署 OpenClaw 喂饭级步骤流程
第一步:点击打开访问阿里云OpenClaw一键部署专题页面。




第二步:打开选择阿里云轻量应用服务器,配置参考如下:
- 镜像:OpenClaw(Moltbot)镜像(已经购买服务器的用户可以重置系统重新选择镜像)
- 实例:内存必须2GiB及以上。
- 地域:默认美国(弗吉尼亚),目前中国内地域(除香港)的轻量应用服务器,联网搜索功能受限。
- 时长:根据自己的需求及预算选择。



第三步:打开访问阿里云百炼大模型控制台,找到密钥管理,单击创建API-Key。

前往轻量应用服务器控制台,找到安装好OpenClaw的实例,进入「应用详情」放行18789端口、配置百炼API-Key、执行命令,生成访问OpenClaw的Token。
- 端口放通:需要放通对应端口的防火墙,单击一键放通即可。
- 配置百炼API-Key,单击一键配置,输入百炼的API-Key。单击执行命令,写入API-Key。
- 配置OpenClaw:单击执行命令,生成访问OpenClaw的Token。
- 访问控制页面:单击打开网站页面可进入OpenClaw对话页面。
阿里云百炼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 的地址。


三、阿里云千问大模型API配置(命令行+Web双模式)
OpenClaw核心功能依赖大模型,配置千问API是激活AI能力的关键,支持Web可视化与命令行两种方式。
(一)获取千问API-Key(Web端)
- 访问登录阿里云百炼大模型服务平台。
- 左侧导航栏进入密钥管理,点击创建API-Key。
- 输入密钥名称(如OpenClaw-Key),点击确认,复制生成的API-Key(sk-xxxx)。
(二)Web端配置(新手首选)
- 登录OpenClaw控制台,进入设置→大模型配置→阿里云百炼。
- 粘贴API-Key,点击测试连接,提示连接成功则配置完成。
- 选择默认模型qwen3.5-plus,保存设置。
(三)命令行配置(开发者推荐)
远程连接阿里云服务器(SSH),执行以下命令:
# 1. 切换国内npm镜像,加速操作
npm config set registry https://registry.npmmirror.com/
# 2. 配置千问API-Key
openclaw config set providers.dashscope-api.apikey "sk-你的千问API-Key"
# 3. 配置API接口地址(国内)
openclaw config set providers.dashscope-api.baseurl "https://dashscope.aliyuncs.com/compatible-mode/v1"
# 4. 设置默认模型
openclaw config set models.default "dashscope-api/qwen3.5-plus"
# 5. 重启服务生效
openclaw gateway restart
# 6. 验证配置(正常回复则成功)
openclaw chat "帮我写一个Python Hello World脚本"
四、Coding Plan免费大模型API配置(零成本入门)
预算有限可选择Coding Plan免费模型,每月有免费调用额度,适合新手测试。
(一)获取Coding Plan API-Key
- 登录阿里云百炼平台,进入Coding Plan专区→我的订阅。
- 领取免费月度额度,点击生成API-Key(格式:sk-sp-xxxx)。
- 复制API-Key,保存备用。
(二)命令行配置Coding Plan
# 1. 配置Coding Plan API-Key
openclaw config set providers.coding-plan.apikey "sk-sp-你的Coding Plan API-Key"
# 2. 配置API地址
openclaw config set providers.coding-plan.baseurl "https://coding.dashscope.aliyuncs.com/v1"
# 3. 设置默认模型
openclaw config set models.default "coding-plan/qwen3-coding"
# 4. 关闭思考模式(Coding Plan必需)
openclaw config set providers.coding-plan.reasoning false
# 5. 重启服务并验证
openclaw gateway restart
openclaw chat "解释什么是OpenClaw"
五、本地MacOS/Linux/Windows11部署OpenClaw(备用方案)
(一)Windows11部署(PowerShell管理员执行)
# 1. 解锁执行策略
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
# 2. 一键安装OpenClaw(国内镜像)
iwr -useb https://openclaw.ai/install.ps1 | iex --registry=https://registry.npmmirror.com
# 3. 初始化配置
openclaw onboard --flow quickstart
# 4. 启动服务
openclaw gateway start
# 5. 生成管理员Token
openclaw token generate --admin
访问http://localhost:18789?token=生成的Token验证。
(二)MacOS部署(终端执行)
# 1. 安装Homebrew(如有跳过)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 2. 安装Node.js 22+
brew install node@22
# 3. 安装OpenClaw
npm install -g openclaw@latest
# 4. 初始化与启动
openclaw onboard --flow quickstart
nohup openclaw gateway start &
# 5. 生成Token
openclaw token generate --admin
(三)Linux(Ubuntu)部署
# 1. 安装依赖
sudo apt update && sudo apt install -y curl git nodejs npm
# 2. 安装OpenClaw
sudo npm install -g openclaw@latest --registry=https://registry.npmmirror.com
# 3. 启动服务并设置开机自启
openclaw gateway start
sudo systemctl enable openclaw
# 4. 生成Token
openclaw token generate --admin
六、新手必看:部署+配置全场景避坑指南
(一)部署类问题(90%新手踩坑点)
- 问题:部署后无法访问OpenClaw控制台(连接超时/拒绝访问)
- 避坑方案:检查公网IP是否启用;确认安全组放行18789端口(计算巢默认已放,无需手动);重启OpenClaw服务:
openclaw gateway restart;更换浏览器/清除缓存。
- 避坑方案:检查公网IP是否启用;确认安全组放行18789端口(计算巢默认已放,无需手动);重启OpenClaw服务:
- 问题:实例状态一直“部署中”,超过10分钟未完成
- 避坑方案:地域选择错误(选国内未备案地域);实例规格过低(内存<2GB);账号欠费/权限不足;删除实例重新部署,选择中国香港/新加坡。
- 问题:服务启动后自动停止(日志提示内存不足)
- 避坑方案:升级实例至2核4GB以上;关闭服务器占用内存的程序;Linux/Mac配置虚拟内存:
sudo fallocate -l 4G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile
- 避坑方案:升级实例至2核4GB以上;关闭服务器占用内存的程序;Linux/Mac配置虚拟内存:
(二)大模型配置类问题
- 问题:千问API调用失败,提示“API-Key无效”
- 避坑方案:核对API-Key无空格/换行;在百炼平台重新生成密钥;检查账号实名认证状态;确认无欠费记录。
- 问题:Coding Plan提示“超出免费额度”
- 避坑方案:等待下月额度刷新;切换至千问付费模型;降低
maxTokens至1024,减少消耗。
- 避坑方案:等待下月额度刷新;切换至千问付费模型;降低
- 问题:AI回复为空/无响应
- 避坑方案:检查大模型配置是否正确;重启OpenClaw服务;验证网络可访问大模型API地址;更新OpenClaw至最新版:
npm update -g openclaw。
- 避坑方案:检查大模型配置是否正确;重启OpenClaw服务;验证网络可访问大模型API地址;更新OpenClaw至最新版:
(三)功能使用类问题
- 问题:联网搜索功能无法使用
- 避坑方案:地域选择中国香港/新加坡/美国弗吉尼亚;国内地域需备案;安装Tavily Web Search技能:
npx clawhub@latest install tavily-web-search。
- 避坑方案:地域选择中国香港/新加坡/美国弗吉尼亚;国内地域需备案;安装Tavily Web Search技能:
- 问题:无法安装Skills,提示“网络超时”
- 避坑方案:切换国内npm镜像:
npm config set registry https://registry.npmmirror.com/;重新执行安装命令;检查网络连接。
- 避坑方案:切换国内npm镜像:
- 问题:技能安装后无法调用
- 避坑方案:启用所有技能:
openclaw skills enable --all;重启服务:openclaw gateway restart;检查技能依赖是否安装(如Agent Browser未装,数据采集技能无法运行)。
- 避坑方案:启用所有技能:
七、总结与进阶建议
2026年阿里云计算巢部署OpenClaw,真正实现零基础、零代码、10分钟快速上线,官方封装解决了环境配置、依赖安装、安全组设置等复杂问题,新手按步骤操作即可一次成功。搭配阿里云千问或Coding Plan大模型,可快速激活AI助手的自然语言理解、任务执行、技能扩展等核心能力。
进阶使用建议
- 技能扩展:安装核心技能(Skill-Vetter、Agent Browser、Tavily Web Search),解锁自动化、实时搜索能力。
- 多端管理:通过JVS Claw客户端统一管理阿里云与本地OpenClaw实例。
- 性能优化:长期使用升级实例至4核8GB,提升多任务并发能力;定期清理日志与缓存,释放存储空间。
本文所有代码命令可直接复制执行,避坑指南覆盖新手90%常见问题,帮助你快速上手OpenClaw,打造专属AI智能体。