OpenClaw怎么部署？阿里云+MacOS/Linux/Windows11本地搭建+配置百炼大模型API图文教程-阿里云开发者社区

一、前言

OpenClaw（曾用名Clawdbot）是一款轻量化、可扩展的AI助手框架，支持多模型接入、多渠道交互与本地/云端混合部署，能快速搭建个人或团队专属AI服务。2026年，阿里云轻量服务器提供OpenClaw官方预装镜像，实现分钟级一键部署，大幅降低新手入门门槛。本文基于最新实践，提供阿里云轻量服务器零代码部署、本地MacOS/Linux/Windows11全平台搭建、阿里云千问大模型与免费Coding Plan API配置的完整流程，同时整理高频问题与避坑方案，全程无复杂操作，新手可直接按步骤完成部署。

二、2026阿里云轻量服务器分钟级部署OpenClaw（新手首选）

零基础部署 OpenClaw 喂饭级步骤流程

第一步：点击打开访问阿里云OpenClaw一键部署专题页面。

第二步：打开选择阿里云轻量应用服务器，配置参考如下：

镜像：OpenClaw(Moltbot)镜像（已经购买服务器的用户可以重置系统重新选择镜像）
实例：内存必须2GiB及以上。
地域：默认美国（弗吉尼亚），目前中国内地域（除香港）的轻量应用服务器，联网搜索功能受限。
时长：根据自己的需求及预算选择。

轻量应用服务器OpenClaw镜像.png

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

阿里云百炼密钥管理图.png

前往轻量应用服务器控制台，找到安装好OpenClaw的实例，进入「应用详情」放行18789端口、配置百炼API-Key、执行命令，生成访问OpenClaw的Token。
阿里云百炼密钥管理图2.png

端口放通：需要放通对应端口的防火墙，单击一键放通即可。
配置百炼API-Key，单击一键配置，输入百炼的API-Key。单击执行命令，写入API-Key。
配置OpenClaw：单击执行命令，生成访问OpenClaw的Token。
访问控制页面：单击打开网站页面可进入OpenClaw对话页面。

（一）实例创建（零代码，5分钟完成）

登录阿里云控制台，进入轻量应用服务器，点击创建实例。
核心配置（新手推荐）：
- 镜像类型：选择应用镜像→OpenClaw（原Clawdbot）2026稳定版（预装Node.js 22、Docker与核心程序）。
- 地域：优先选美国（弗吉尼亚）（支持全功能，无国内网络限制），国内用户可选中国香港。
- 实例规格：2核4GB、5Mbps带宽、40GB高效云盘（最低2GB内存，低于此配置易启动失败）。
- 登录方式：设置root密码（务必牢记），购买时长测试选1个月，长期用选1年。
确认订单并支付，等待实例状态变为运行中（约5-10分钟）。

阿里云百炼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 的地址。

（二）端口放行（关键步骤，避免无法访问）

进入实例概览→防火墙→添加规则。
放行端口：22（SSH）、18789（OpenClaw默认端口），协议选TCP，来源选0.0.0.0/0。
新手可直接点击一键放行，完成后返回实例页面。

（三）初始化与启动服务（一键操作）

点击实例远程连接→Workbench远程连接，输入root密码登录服务器。

执行初始化命令（全程无需修改，直接复制）：

# 初始化OpenClaw配置，按提示选择QuickStart模式
openclaw onboard
# 启动服务并设置开机自启
openclaw gateway install
openclaw gateway start

验证服务状态：
```
openclaw gateway status
```
显示running即为启动成功。

（四）访问OpenClaw控制台

浏览器输入：http://你的服务器公网IP:18789，进入Web控制台即可开始使用。

三、本地全平台部署OpenClaw（MacOS/Linux/Windows11）

（一）Windows11本地部署（WSL2环境，推荐）

前置环境配置（管理员PowerShell）：
```
# 开启WSL2与虚拟机平台
wsl --install
wsl --set-default-version 2
# 验证WSL2状态
wsl --status
```
安装完成后重启电脑，下载并安装Docker Desktop，勾选使用WSL2而非Hyper-V。

部署OpenClaw：

# 拉取最新镜像
docker pull openclaw/openclaw:2026.3.14
# 创建持久化目录
mkdir -p $HOME/OpenClaw/{
     config,workspace,skills,logs}
# 启动容器（开机自启）
docker run -d --name openclaw --restart always -p 18789:18789 -v $HOME/OpenClaw/config:/app/config -v $HOME/OpenClaw/workspace:/app/workspace -v $HOME/OpenClaw/skills:/app/skills -v $HOME/OpenClaw/logs:/app/logs openclaw/openclaw:2026.3.14

访问：http://localhost:18789。

（二）MacOS本地部署（流程最简）

安装Homebrew与依赖：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install node@22 docker
open /Applications/Docker.app

一键部署：

curl -fsSL https://clawd.org.cn/install.sh | bash
openclaw onboard --install-daemon
openclaw gateway start

访问：http://localhost:18789。

（三）Linux（Ubuntu/Debian）本地部署

安装依赖：

sudo apt update && sudo apt upgrade -y
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash
sudo apt install -y nodejs docker.io
sudo systemctl enable docker && sudo systemctl start docker

部署OpenClaw：

sudo npm install -g openclaw@latest --registry=https://registry.npmmirror.com
sudo openclaw onboard --install-daemon
sudo ufw allow 18789/tcp
openclaw gateway start

访问：http://localhost:18789。

四、大模型API配置（阿里云千问+免费Coding Plan）

（一）阿里云千问大模型配置（稳定生产级）

获取API Key：登录阿里云百炼平台→密钥管理→创建API Key，复制sk-开头的密钥，记录Base URL：https://dashscope.aliyuncs.com/compatible-mode/v1。

配置OpenClaw（命令行）：

# 进入配置目录
cd ~/.openclaw
# 编辑配置文件
nano openclaw.json

添加以下内容（替换为你的API Key）：

"models": {
     
  "providers": {
     
    "bailian": {
     
      "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
      "apiKey": "你的千问API Key",
      "models": ["qwen3-max", "qwen3.5-plus"]
    }
  },
  "default": "bailian/qwen3-max"
}

重启服务生效：
```
openclaw gateway restart
```
验证：
```
openclaw model test
```
显示连接成功即为配置完成。

（二）免费Coding Plan API配置（零成本方案）

获取免费API Key：登录阿里云百炼→Coding Plan→免费套餐（新用户90天免费）→密钥管理→创建API Key，复制sk-sp-开头的密钥，Base URL：https://coding.dashscope.aliyuncs.com/v1。

配置OpenClaw：

cd ~/.openclaw
nano openclaw.json

添加以下内容：

"models": {
     
  "providers": {
     
    "coding-plan": {
     
      "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
      "apiKey": "你的Coding Plan API Key",
      "models": ["coding-free"]
    }
  },
  "default": "coding-plan/coding-free"
}

重启并验证：
bash openclaw gateway restart openclaw model test。

五、OpenClaw常用运维命令（全平台通用）

# 启动服务
openclaw gateway start
# 停止服务
openclaw gateway stop
# 重启服务
openclaw gateway restart
# 查看状态
openclaw gateway status
# 查看实时日志
openclaw logs -f
# 模型连接测试
openclaw model test
# 安装技能
openclaw skill install 技能名
# 卸载技能
openclaw skill remove 技能名
# 系统自检
openclaw doctor

六、常见问题与避坑指南（新手必看）

1. 无法访问Web控制台

原因：端口未放行、防火墙拦截、服务未启动。

解决：

# 阿里云：安全组放行18789端口
# 本地：
sudo ufw allow 18789/tcp # Linux/Mac
# Windows：防火墙添加入站规则放行18789
# 验证服务状态
openclaw gateway status

2. 命令找不到（openclaw: command not found）

原因：环境变量未刷新、安装失败。

解决：

# 重启终端
# 重新安装（国内镜像）
npm install -g openclaw@latest --registry=https://registry.npmmirror.com
# 刷新环境变量
source ~/.zshrc # Mac
source ~/.bashrc # Linux

3. 模型连接失败

原因：API Key错误、Base URL不匹配、网络问题。
解决：核对API Key与Base URL，执行openclaw model test定位错误，重启服务。

4. 服务启动后立即崩溃

原因：内存不足（最低2GB）、端口被占用。

解决：升级实例配置至2核4GB，检查端口占用：

lsof -i :18789 # Mac/Linux
netstat -ano | findstr :18789 # Windows
kill -9 进程ID # 终止占用进程

5. 技能安装失败

原因：网络超时、权限不足。
解决：切换国内npm源，用管理员权限执行命令，执行openclaw doctor自动修复。

6. 模型回复异常/乱码

原因：配置文件格式错误、模型选择不当。
解决：检查openclaw.json格式，切换默认模型，重启服务。

七、总结

2026年OpenClaw部署已实现极大简化，阿里云轻量服务器通过官方镜像实现分钟级一键上线，本地MacOS/Linux/Windows11也可通过标准化流程快速搭建，搭配阿里云千问的稳定能力与Coding Plan的免费额度，新手无需复杂技术背景即可完成从部署到使用的全流程。本文覆盖实例创建、端口放行、服务初始化、模型配置、运维命令与问题排查，所有步骤均经过实测验证，可直接复制执行，帮助用户快速拥有专属AI助手，满足日常交互、任务执行与团队协作需求。

OpenClaw怎么部署？阿里云+MacOS/Linux/Windows11本地搭建+配置百炼大模型API图文教程