零基础阿里云计算巢部署OpenClaw保姆级教程（含本地搭建+千问/Coding Plan配置+问题排查）-阿里云开发者社区

一、前言

OpenClaw（曾用名Clawdbot、Moltbot）是一款轻量化、可扩展的AI助手框架，支持多模型接入、多渠道交互与云端/本地混合部署，能快速搭建个人或团队专属AI服务。2026年，阿里云计算巢提供OpenClaw官方预装镜像，实现零基础、零技术分钟级一键部署，彻底告别复杂环境配置。本文基于最新实践，提供阿里云计算巢部署、本地MacOS/Linux/Windows11全平台搭建、阿里云千问大模型与免费Coding Plan API配置的完整流程，同时整理新手高频踩坑点与系统性避坑方案，全程无复杂操作，新手可直接按步骤完成从部署到使用的全流程。阿里云部署 OpenClaw 只需两步，全网最简单，步骤流程访问阿里云OpenClaw一键部署专题页面 了解。
OpenClaw部署教程图1.png

二、2026阿里云计算巢部署OpenClaw（零基础零技术，5分钟完成）

（一）计算巢实例创建（零代码，核心步骤）

登录阿里云控制台，访问阿里云计算巢OpenClaw社区版部署页面，进入计算巢服务控制台。
在计算巢服务列表中，搜索OpenClaw（原Clawdbot） 官方应用，点击立即创建，进入部署配置页面。
基础信息配置（新手推荐，无需修改默认值）：
- 服务实例名称：自定义（如Claw01，以英文字母开头，可包含数字、短划线）。
- 地域选择：中国香港、新加坡或美国（弗吉尼亚）（内地地域访问大模型API受限，必避坑）。
- 实例规格：2核4GiB内存、40GB ESSD系统盘（最低2GiB内存，低于此配置易启动失败）。
- 镜像选择：应用镜像→OpenClaw 2026稳定版（预装Node.js 22、所有依赖组件与运行环境）。
- 网络配置：保持默认，系统自动分配公网IP与专有网络。
- 登录密码：设置包含字母、数字、特殊符号的密码（务必牢记）。
确认配置无误后，点击立即购买，完成支付，等待实例状态变为运行中（约3-5分钟）。

（二）端口放行（关键必做，否则无法访问）

进入计算巢实例应用详情页面，找到端口放通选项。
点击一键放通，选择TCP协议，端口填写18789（OpenClaw默认端口），策略选择允许，保存生效。
若一键放通失败，手动添加防火墙规则：进入实例详情→防火墙→添加规则，协议选TCP，端口18789，来源0.0.0.0/0。

命令行验证（可选，新手可跳过）：

firewall-cmd --add-port=18789/tcp --permanent
firewall-cmd --reload

（三）远程连接与服务初始化（一键操作）

返回实例详情页，点击远程连接→Workbench远程连接，输入设置的root密码登录服务器。

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

# 初始化OpenClaw配置，选择QuickStart模式
openclaw onboard
# 安装并启动网关服务，设置开机自启
openclaw gateway install
openclaw gateway start

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

（四）生成访问Token并登录控制台

执行命令生成管理员Token（登录必需）：
```
openclaw token generate --admin
```

复制生成的Token，浏览器输入访问地址：

http://你的服务器公网IP:18789/?token=你的Token

进入OpenClaw Web控制台，发送测试指令（如“你好”），验证功能正常。

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

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

前置依赖：安装Xcode命令行工具与Homebrew

xcode-select --install
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

一键部署（国内加速版，避免网络问题）：

curl -fsSL https://open-claw.org.cn/install-cn.sh | bash

初始化并启动服务：

openclaw onboard --install-daemon
openclaw gateway start

访问控制台：http://localhost:18789。

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

安装系统依赖与Node.js 22：

sudo apt update && sudo apt upgrade -y
sudo apt install -y git ffmpeg
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash
sudo apt install -y nodejs

全局安装OpenClaw（国内镜像加速）：

npm config set registry https://registry.npmmirror.com
npm install -g openclaw@latest

初始化、放行端口并启动服务：

openclaw onboard --install-daemon
sudo ufw allow 18789/tcp
sudo ufw reload
openclaw gateway start

访问：http://localhost:18789。

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

以管理员身份打开PowerShell，开启WSL2：
```
wsl --install
wsl --set-default-version 2
```
安装完成后重启电脑，安装Docker Desktop并勾选使用WSL2而非Hyper-V。

在WSL2 Ubuntu环境中执行部署命令：

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

访问：http://localhost:18789。

零基础部署 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对话页面。

阿里云百炼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配置（阿里云千问+免费Coding Plan）

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

获取API Key：访问登录阿里云百炼大模型服务平台→密钥管理→创建API Key，复制sk-开头的密钥。
记录对应地域Base URL：
- 中国香港/新加坡：https://dashscope-intl.aliyuncs.com/compatible-mode/v1
- 美国（弗吉尼亚）：https://dashscope-us.aliyuncs.com/compatible-mode/v1

命令行配置OpenClaw：

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

添加以下配置（替换为你的API Key与Base URL）：

"models": {
     
  "default": "bailian/qwen3.5-plus",
  "providers": {
     
    "bailian": {
     
      "baseUrl": "你的Base URL",
      "apiKey": "你的千问API Key",
      "api": "openai-completions",
      "models": [
        {
     "id": "qwen3.5-plus", "name": "Qwen3.5-Plus", "maxTokens": 16384},
        {
     "id": "qwen3-max", "name": "Qwen3-Max", "maxTokens": 65536}
      ]
    }
  }
}

保存退出（Ctrl+O→回车→Ctrl+X），重启服务生效：
```
openclaw gateway restart
```
验证配置：
```
openclaw model test
```
显示连接成功即为配置完成。

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

获取免费API Key：登录阿里云百炼→Coding Plan→开通免费套餐→API管理→创建API Key（格式sk-sp-xxx）。
记录Base URL：https://coding.dashscope.aliyuncs.com/v1（固定）。
配置OpenClaw：
```
cd ~/.openclaw
nano openclaw.json
```

添加以下配置（替换为你的API Key）：

"models": {
     
  "default": "coding-plan/coding-free",
  "providers": {
     
    "coding-plan": {
     
      "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
      "apiKey": "你的Coding Plan API Key",
      "api": "openai-completions",
      "models": [{
     "id": "coding-free", "name": "Coding Plan Free", "maxTokens": 4096}]
    }
  }
}

重启并验证：

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
# 生成管理员Token
openclaw token generate --admin
# 系统自检与修复
openclaw doctor
# 安装技能
openclaw skill install 技能名
# 卸载技能
openclaw skill remove 技能名

六、新手零基础阿里云部署OpenClaw避坑指南（90%踩坑点提前规避）

（一）部署阶段核心避坑

地域选择错误，大模型调用失败
- 现象：部署成功，但Web控制台无法访问、模型回复超时或失败。
- 原因：内地地域服务器访问阿里云百炼API存在网络限制，无法正常通信。
- 避坑：必须选择中国香港、新加坡或美国（弗吉尼亚）地域，绝对避免内地地域。
未放通18789端口，无法访问控制台
- 现象：输入访问地址后，提示“无法连接”“连接超时”。
- 原因：阿里云防火墙未放行18789端口，服务器拦截访问请求。
- 避坑：严格执行端口放通步骤；若已放通仍无法访问，执行命令永久开放端口：
```
firewall-cmd --add-port=18789/tcp --permanent && firewall-cmd --reload
```
  重启浏览器重试。
服务器内存不足，服务启动失败
- 现象：执行openclaw gateway start后，服务立即崩溃，日志显示内存溢出。
- 原因：OpenClaw最低要求2GiB内存，低于此配置无法正常运行。
- 避坑：实例规格选择2核4GiB内存起步，测试环境至少2GiB，生产环境建议4核8GiB。
Node.js版本过低，初始化失败
- 现象：执行openclaw onboard时，提示“Node.js版本不兼容”。
- 原因：OpenClaw 2026版要求Node.js ≥22，系统默认版本过低。
- 避坑：使用官方一键脚本自动安装对应版本，或手动安装Node.js 22：
```
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash && sudo apt install -y nodejs
```
密码错误，远程连接失败
- 现象：Workbench连接时提示“认证失败”。
- 原因：密码输入错误、包含特殊符号未正确输入，或复制时带有空格。
- 避坑：手动输入密码（避免复制空格），或在阿里云控制台重置密码后重试。

（二）模型配置阶段避坑

API Key错误/混用，模型连接失败
- 现象：执行openclaw model test时，提示“认证失败”“API Key无效”。
- 原因：千问API Key（sk-xxx）与Coding Plan API Key（sk-sp-xxx）混用，或Key输入错误、带有空格。
- 避坑：核对API Key类型与内容，删除多余空格，重新配置后重启服务。
Base URL不匹配，调用超时
- 现象：模型连接测试成功，但实际调用时超时或无响应。
- 原因：Base URL与地域不匹配，或使用错误的协议地址。
- 避坑：严格按照地域选择对应Base URL，千问与Coding Plan的Base URL不可混用。
配置文件格式错误，服务无法启动
- 现象：修改openclaw.json后，服务启动失败，日志提示JSON解析错误。
- 原因：配置文件中缺少逗号、引号不匹配或语法错误。
- 避坑：使用nano编辑器修改，保存前检查语法；或通过Web UI（openclaw dashboard）可视化配置，避免手动编辑错误。

（三）使用阶段常见问题与解决

控制台访问缓慢/卡顿
- 解决：升级服务器带宽至5Mbps以上，或选择就近地域实例；关闭不必要的技能，减少资源占用。
模型回复乱码/格式错误
- 解决：检查配置文件中maxTokens与temperature设置是否合理；切换默认模型，重启服务；执行openclaw doctor修复配置。
技能安装失败
- 解决：切换国内npm源（npm config set registry https://registry.npmmirror.com）；用管理员权限执行命令；删除缓存（rm -rf ~/.openclaw/cache）后重试。
服务自动停止
- 解决：检查服务器内存与CPU占用，升级配置；执行openclaw gateway install重新安装服务，确保开机自启；查看日志（openclaw logs）定位具体错误。

七、总结

2026年OpenClaw部署已实现极大简化，阿里云计算巢通过官方镜像实现零基础、零技术分钟级一键上线，彻底解决新手环境配置难题。本地MacOS/Linux/Windows11也可通过标准化一键脚本快速搭建，搭配阿里云千问的稳定生产能力与Coding Plan的免费额度，新手无需复杂技术背景即可完成从部署到使用的全流程。

本文覆盖计算巢实例创建、端口放行、服务初始化、模型API配置、全平台运维命令与系统性避坑方案，所有步骤均经过实测验证，可直接复制执行。完成部署后，OpenClaw可作为个人AI助手、团队协作中枢或企业内部AI服务，支持文本交互、任务执行、多模型调度等核心功能，兼顾隐私安全、功能完整性与使用成本，是2026年轻量化AI部署的最优实践方案。

零基础阿里云计算巢部署OpenClaw保姆级教程（含本地搭建+千问/Coding Plan配置+问题排查）

一、前言

二、2026阿里云计算巢部署OpenClaw（零基础零技术，5分钟完成）

（一）计算巢实例创建（零代码，核心步骤）

（二）端口放行（关键必做，否则无法访问）

（三）远程连接与服务初始化（一键操作）

（四）生成访问Token并登录控制台

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

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

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

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

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

阿里云百炼Coding Plan API-Key 获取、配置保姆级教程：

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

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

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

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

六、新手零基础阿里云部署OpenClaw避坑指南（90%踩坑点提前规避）

（一）部署阶段核心避坑

（二）模型配置阶段避坑

（三）使用阶段常见问题与解决

七、总结

热门文章

最新文章

相关电子书

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

零基础阿里云计算巢部署OpenClaw保姆级教程（含本地搭建+千问/Coding Plan配置+问题排查）

一、前言

二、2026阿里云计算巢部署OpenClaw（零基础零技术，5分钟完成）

（一）计算巢实例创建（零代码，核心步骤）

（二）端口放行（关键必做，否则无法访问）

（三）远程连接与服务初始化（一键操作）

（四）生成访问Token并登录控制台

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

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

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

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

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

阿里云百炼Coding Plan API-Key 获取、配置保姆级教程：

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

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

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

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

六、新手零基础阿里云部署OpenClaw避坑指南（90%踩坑点提前规避）

（一）部署阶段核心避坑

（二）模型配置阶段避坑

（三）使用阶段常见问题与解决

七、总结

热门文章

最新文章

相关电子书