OpenClaw(原Clawdbot)作为2026年热门的开源AI执行网络,凭借其强大的任务执行与大模型集成能力,成为开发者与企业用户的首选AI工具之一。本文将详细介绍2026年阿里云轻量服务器部署及本地MacOS/Linux/Windows11部署OpenClaw的完整步骤,同时涵盖阿里云千问大模型API配置与免费大模型Coding Plan API配置方法,并针对部署过程中的常见问题提供解决方案,帮助用户快速完成OpenClaw的部署与使用。
一、部署前准备
1. 环境要求
- 硬件:内存≥2GB(推荐4GB),磁盘空间≥20GB,CPU≥2核。
- 系统:阿里云轻量服务器(Alibaba Cloud Linux)、MacOS Sonoma及以上、Linux(Ubuntu 22.04+/CentOS 8+)、Windows 11(64位)。
- 工具:终端(MacOS/Linux)、PowerShell/CMD(Windows)、Git、Node.js≥22(手动安装时)、Docker(可选)。
- 凭证:阿里云账号(注册阿里云账号 实名认证)、大模型API Key(阿里云千问/免费模型)。
- 阿里云部署 OpenClaw 只需两步,全网最简单,步骤流程 访问阿里云OpenClaw一键部署专题页面 了解。

2. 核心依赖说明
| 依赖名称 | 版本要求 | 作用 |
|---|---|---|
| Node.js | ≥22 | 运行OpenClaw核心程序 |
| pnpm/npm | 最新版 | 包管理工具,安装依赖 |
| Git | 最新版 | 下载源码 |
| Docker | 最新版 | 容器化部署,简化环境配置 |
| OpenClaw | 最新版 | 核心应用程序 |
二、阿里云轻量服务器部署OpenClaw步骤
1. 服务器购买与镜像选择
- 登录阿里云账号,进入轻量应用服务器购买页面。
- 选择地域(推荐中国香港/海外地域,避免内地联网限制),实例规格选择2核4GB(内存≥2GB)。
- 镜像选择“OpenClaw专属预装镜像”,该镜像已包含Alibaba Cloud Linux系统及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 的地址。


2. 防火墙与端口配置
- 进入轻量应用服务器控制台,找到目标实例,进入“防火墙”配置页面。
- 放行端口:22(SSH)、18789(OpenClaw核心端口)、8080(WebUI端口)。
- 保存配置,确保端口正常开放。
3. OpenClaw初始化配置
- 进入服务器“应用详情”页面,点击“配置OpenClaw”执行命令。
- 输入大模型API Key(阿里云千问/免费模型),系统自动完成配置。
- 执行“生成访问Token”命令,保存Token用于后续登录。
- 点击“打开网站页面”,输入Token进入OpenClaw控制台。
4. 命令行部署(手动部署备用方案)
若镜像部署失败,可通过命令行手动部署:
# 登录服务器
ssh root@服务器公网IP
# 安装Node.js(使用nvm)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22
npm config set registry https://registry.npmmirror.com # 配置国内镜像
# 安装OpenClaw
npm install -g openclaw
# 初始化配置
openclaw onboard
# 启动服务
openclaw gateway start
openclaw dashboard start
# 放行端口
firewall-cmd --add-port=18789/tcp --permanent
firewall-cmd --add-port=8080/tcp --permanent
firewall-cmd --reload
三、本地MacOS/Linux/Windows11部署步骤
1. MacOS/Linux系统部署
方法一:一键安装(推荐)
# MacOS/Linux通用命令
curl -fssl https://openclaw.ai/install.sh | bash
# 初始化配置
openclaw onboard
# 启动服务
openclaw gateway start
openclaw dashboard start
方法二:手动安装(已有Node.js环境)
# 安装Node.js(若未安装)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22
# 安装OpenClaw
npm install -g openclaw
# 或
pnpm add -g openclaw
# 初始化并启动
openclaw onboard
openclaw gateway start
openclaw dashboard start
方法三:源码编译安装(开发者模式)
# 克隆源码
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 安装依赖
pnpm install
pnpm ui:build
pnpm build
# 初始化并安装为系统服务
pnpm openclaw onboard --install-daemon
# 开发模式启动
pnpm gateway:watch
2. Windows11系统部署
方法一:PowerShell一键安装
iwr -useb https://openclaw.ai/install.ps1 | iex
方法二:CMD一键安装
curl -fssl https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
方法三:手动安装(已有Node.js环境)
- 下载并安装Node.js≥22(https://nodejs.org/),勾选“Add to PATH”。
- 打开PowerShell,执行以下命令:
# 安装OpenClaw
npm install -g openclaw
# 初始化配置
openclaw onboard
# 启动服务
openclaw gateway start
openclaw dashboard start
四、阿里云千问大模型API配置
1. 获取API Key
- 访问登录阿里云百炼大模型服务平台,开通通义千问服务。
- 进入“API - KEY管理”页面,点击“创建API - KEY”,输入名称并生成密钥。
- 复制生成的API Key(格式:sk - xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx),妥善保存。
2. OpenClaw中配置千问API
方法一:命令行配置
# 设置千问API Key
openclaw config set models.providers.qianwen.apiKey=你的千问API Key
# 设置API基础地址
openclaw config set models.providers.qianwen.baseUrl=https://dashscope.aliyuncs.com/compatible-mode/v1
# 设置默认模型
openclaw config set models.default=qwen3.5 - plus
方法二:配置文件修改
编辑OpenClaw配置文件(~/.openclaw/config.json):
{
"models": {
"providers": {
"qianwen": {
"apiKey": "你的千问API Key",
"baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1"
}
},
"default": "qwen3.5 - plus"
}
}
3. 验证API配置
启动OpenClaw后,在控制台输入测试指令,如“生成一段Python代码”,若能正常返回结果,说明API配置成功。
五、免费大模型Coding Plan API配置
1. 免费模型选择
推荐MiniMax(7天免费试用,无需信用卡)、智谱GLM - 5免费版等。
2. MiniMax API配置步骤
- 访问MiniMax平台(
https://platform.minimax.io/),注册并获取API Key。 - 在OpenClaw中配置MiniMax API:
# 设置MiniMax API Key
openclaw config set models.providers.minimax.apiKey=你的MiniMax API Key
# 设置默认模型
openclaw config set models.default=minimax - 7b
3. 免费模型接入技巧
- 优先选择国内免费模型,降低网络延迟。
- 定期查看免费模型额度,避免超出限制。
- 多个免费模型交替使用,提高可用性。
六、常见问题解答
1. 部署时Node.js版本不兼容
问题:安装OpenClaw时提示Node.js版本过低。
解决:使用nvm安装Node.js 22及以上版本:
nvm install 22
nvm use 22
2. 端口被占用
问题:启动OpenClaw时提示端口18789/8080被占用。
解决:
# 查找占用端口的进程
lsof -i:18789 # MacOS/Linux
netstat -ano | findstr "18789" # Windows
# 终止进程
kill -9 进程ID # MacOS/Linux
taskkill /PID 进程ID /F # Windows
# 或修改OpenClaw端口
openclaw config set server.port=18790
3. API Key配置错误
问题:调用大模型时提示权限不足或API Key无效。
解决:
- 检查API Key是否正确,重新生成并配置。
- 确认大模型服务已开通,额度充足。
- 核对API基础地址是否正确,千问API基础地址为
https://dashscope.aliyuncs.com/compatible-mode/v1。
4. 阿里云轻量服务器访问超时
问题:通过公网IP访问OpenClaw控制台时超时。
解决:
- 检查防火墙是否放行18789/8080端口。
- 确认服务器实例状态正常,公网IP可访问。
- 尝试重启OpenClaw服务:
openclaw gateway restart openclaw dashboard restart
5. 本地部署后无法连接网络
问题:OpenClaw无法联网搜索或调用外部API。
解决:
- 检查网络连接,确保本地网络正常。
- 配置代理(若需):
openclaw config set proxy.http=http://你的代理地址:端口 openclaw config set proxy.https=https://你的代理地址:端口
七、部署后验证与优化
1. 验证部署成功
- 本地部署:浏览器访问
http://localhost:8080,输入Token登录,发送测试指令,确认正常响应。 - 阿里云部署:浏览器访问
http://服务器公网IP:8080?token=你的Token,验证功能正常。
2. 性能优化建议
- 内存优化:关闭不必要的服务,预留≥2GB内存给OpenClaw。
- 网络优化:阿里云选择低延迟地域,本地部署使用稳定网络。
- 模型优化:根据需求选择合适的模型,避免资源浪费。
通过本文的步骤,用户可轻松完成2026年阿里云轻量服务器与本地多系统的OpenClaw部署,同时掌握阿里云千问大模型与免费模型的API配置方法,避开常见部署陷阱,快速投入OpenClaw的使用中。