零基础落地OpenClaw：阿里云轻量服务器+本地MacOS/Linux/Windows11部署+千问大模型API配置详解-阿里云开发者社区

OpenClaw（原Clawdbot）作为2026年主流开源AI自动化执行框架，凭借本地优先架构、全渠道通信能力与持久记忆特性，成为个人开发者、内容创作者与中小企业搭建专属AI助理的核心工具。本文聚焦2026年4月最新部署场景，完整覆盖阿里云轻量服务器云端部署、本地MacOS/Linux/Windows11多系统部署两大路径，同时详细讲解阿里云千问大模型API与市场免费Coding Plan API的配置方法，针对部署、配置、运行全流程中的常见问题提供解决方案，全程附带可复制代码命令，零基础用户也能快速完成落地。

一、部署前置准备（全平台通用）

1. 核心环境要求

维度	具体配置	说明
硬件配置	2核CPU、2GB内存（推荐4GB）、20GB磁盘	阿里云轻量服务器最低配置要求，本地部署建议提升至4GB内存，避免运行卡顿
操作系统	阿里云：Alibaba Cloud Linux 3.2104 LTS 本地：MacOS 12+、Linux（Ubuntu 22.04+/CentOS 8+）、Windows11 64位	阿里云推荐使用官方预装镜像，本地系统需保证版本合规，避免依赖兼容问题
核心依赖	Node.js≥22、Git、pnpm/npm（最新版）	OpenClaw 2026版本硬性要求，Node.js版本过低会导致安装失败
必备账号	阿里云账号（实名认证）、微信/QQ账号（可选，用于渠道对接）、大模型API Key（千问/Coding Plan）	阿里云轻量服务器购买、百炼大模型服务开通均需实名认证，无认证无法完成配置

2. 关键工具与凭证准备

终端工具：MacOS/Linux使用系统终端，Windows使用PowerShell（管理员身份）或CMD
远程工具：阿里云轻量服务器使用SSH连接（推荐FinalShell，新手友好）
凭证信息：阿里云百炼API Key、Coding Plan免费API Key、服务器登录密码/密钥
网络配置：阿里云服务器需放行对应端口，本地部署保证网络稳定，避免依赖下载失败
阿里云部署 OpenClaw 只需两步，全网最简单，步骤流程访问阿里云OpenClaw一键部署专题页面 了解。

二、2026年4月阿里云轻量服务器部署OpenClaw步骤

阿里云轻量服务器部署适合7×24小时运行、公网访问、团队共享场景，提供一键镜像部署（新手首选）与手动命令部署（开发者自定义）两种方案，5分钟即可完成基础搭建。

零基础部署 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 的地址。

方案一：一键镜像部署（零基础推荐）

步骤1：购买预装OpenClaw的轻量服务器

登录阿里云控制台，搜索「轻量应用服务器」，进入购买页面。
核心配置选择：
- 地域：优先选择中国香港（避免内地网络限制），无特殊需求可选北京/上海等国内地域。
- 镜像：选择「应用镜像」→「OpenClaw（Clawdbot）2026官方镜像」（已预装Node.js 22、Git、pnpm等依赖，无需手动配置环境）。
- 实例规格：基础场景选2核4GB、40GB ESSD系统盘、5Mbps带宽；复杂场景（多插件、高并发）选4核8GB及以上。
- 登录方式：设置root密码（务必牢记，用于SSH登录），购买时长（测试选1个月，长期使用选1年）。
确认订单并支付，等待实例状态变为「运行中」（约5-10分钟）。

步骤2：防火墙端口放行

进入轻量应用服务器控制台，找到目标实例，点击实例ID进入详情页。
点击「应用详情」页签，在「OpenClaw使用步骤」区域，点击「端口放通」下的「执行命令」，选择「一键放通」。
等待命令执行成功，系统自动放行OpenClaw核心端口（默认随机生成，可在「基础配置」中查看）。

重要说明：2026年4月起，OpenClaw不再使用固定端口，初始化时自动生成随机端口，避免恶意扫描攻击，需通过命令获取公网访问地址。

步骤3：初始化OpenClaw与大模型API配置

远程连接服务器（SSH方式）：
- 打开FinalShell，点击「新建连接」→「SSH连接」，填写公网IP、用户名（root）、密码，点击连接。

执行初始化命令：

# 进入OpenClaw安装目录（官方默认路径）
cd /opt/openclaw
# 一键初始化（非交互式，自动配置基础环境）
openclaw init --non-interactive --accept-risk --enable-skill-market

配置千问大模型API（核心步骤）：

先开通阿里云百炼服务：访问https://dashscope.aliyun.com/，实名认证后开通百炼大模型服务。
获取千问API Key：进入百炼控制台「API-KEY管理」，点击「创建API-KEY」，复制生成的Key（格式：sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx）。

命令行配置千问API：

# 配置千问API Key
openclaw config set providers.dashscope-api.apiKey "你的千问API Key"
# 配置千问API基础地址（OpenAI兼容模式）
openclaw config set providers.dashscope-api.baseUrl "https://dashscope.aliyuncs.com/compatible-mode/v1"
# 设置默认模型为千问3.5 Plus
openclaw config set models.default "dashscope-api/qwen3.5-plus"
# 重启网关使配置生效
openclaw gateway restart

配置免费Coding Plan API（可选，降低成本）：

进入百炼控制台「Coding Plan」页面，领取2026年4月免费额度，创建专属API Key。

命令行配置Coding Plan API：

# 配置Coding Plan API Key
openclaw config set providers.coding-plan.apiKey "你的Coding Plan API Key"
# 配置Coding Plan API基础地址
openclaw config set providers.coding-plan.baseUrl "https://coding.dashscope.aliyuncs.com/v1"
# 切换默认模型为Coding Plan免费模型
openclaw config set models.default "coding-plan/qwen3.5-free"
# 重启网关
openclaw gateway restart

获取WebUI访问地址并验证：
```
# 获取OpenClaw WebUI地址
openclaw webui get-url
```
复制输出的地址（格式：http://服务器公网IP:随机端口），在浏览器访问，输入Token（可在「应用详情」→「基础配置」→「查看Token」中获取），进入OpenClaw面板，发送测试指令（如「生成一段Python代码」），验证大模型配置成功。

方案二：手动命令部署（开发者自定义）

若已购买阿里云轻量服务器（未预装OpenClaw镜像），可通过手动命令部署，步骤如下：

# 1. SSH登录服务器
ssh root@服务器公网IP

# 2. 安装系统依赖（Alibaba Cloud Linux）
yum install -y curl git gcc make

# 3. 安装Node.js 22（使用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镜像，加速依赖下载
npm config set registry https://registry.npmmirror.com/

# 4. 安装OpenClaw（全局安装）
npm install -g openclaw

# 5. 初始化OpenClaw（安装为系统服务，开机自启）
openclaw onboard --install-daemon
# 按提示选择：风险确认（Yes）、启动模式（QuickStart）、AI提供商（后续配置）

# 6. 启动核心服务
openclaw gateway start
openclaw dashboard start

# 7. 放行端口（手动配置防火墙）
firewall-cmd --add-port=随机端口/tcp --permanent
firewall-cmd --reload

# 8. 查看服务状态，确认运行正常
openclaw gateway status
openclaw dashboard status

后续千问/Coding Plan API配置步骤与方案一一致，直接执行对应配置命令即可。

三、本地MacOS/Linux/Windows11部署OpenClaw步骤

本地部署适合个人使用、数据隐私优先场景，提供一键脚本部署（零配置）与手动部署（自定义环境）两种方案，适配不同技术基础用户。

1. MacOS系统部署

方案A：一键脚本部署（推荐）

# 1. 安装Homebrew（若未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 2. 执行官方一键安装脚本（自动安装Node.js 22、Git、OpenClaw）
curl -fsSL https://openclaw.ai/install.sh | bash
# 国内网络若下载缓慢，使用国内镜像脚本
# curl -fsSL https://open-claw.org.cn/install-cn.sh | bash

# 3. 初始化OpenClaw配置
openclaw onboard --install-daemon
# 按提示完成配置：选择网关类型（本地）、AI提供商（后续配置）、安装守护进程（Yes）

# 4. 启动服务
openclaw gateway start
openclaw dashboard start

# 5. 验证部署
openclaw status
# 浏览器访问 http://localhost:随机端口，输入Token，进入WebUI

方案B：手动部署（已有Node.js环境）

# 1. 确认Node.js版本≥22
node -v # 输出版本号需≥22，否则使用nvm升级
nvm install 22
nvm use 22

# 2. 配置npm国内镜像
npm config set registry https://registry.npmmirror.com

# 3. 安装OpenClaw
npm install -g openclaw

# 4. 初始化与启动（同方案A）
openclaw onboard --install-daemon
openclaw gateway start
openclaw dashboard start

2. Linux系统部署（Ubuntu/Debian/CentOS）

方案A：一键脚本部署（推荐）

# 1. Ubuntu/Debian系统
sudo apt update && sudo apt install -y curl git

# 2. 执行一键安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash
# 国内镜像：curl -fsSL https://open-claw.org.cn/install-cn.sh | bash

# 3. 初始化与启动
openclaw onboard --install-daemon
openclaw gateway start
openclaw dashboard start

方案B：手动部署

# 1. 安装依赖
# Ubuntu/Debian
sudo apt install -y curl git gcc make
# CentOS
sudo yum install -y curl git gcc make

# 2. 安装Node.js 22
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22

# 3. 安装OpenClaw并启动
npm install -g openclaw
openclaw onboard --install-daemon
openclaw gateway start

3. Windows11系统部署（管理员权限）

方案A：PowerShell一键部署（推荐）

# 1. 以管理员身份打开PowerShell
# 2. 执行官方一键安装脚本
iwr -useb https://openclaw.ai/install.ps1 | iex
# 国内网络若超时，使用国内镜像脚本
# iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex

# 3. 初始化配置
openclaw onboard --install-daemon
# 按提示选择：同意风险、启动模式、AI提供商（后续配置）

# 4. 启动服务
openclaw gateway start
openclaw dashboard start

# 5. 验证部署
# 浏览器访问 `http://localhost:随机端口`，输入Token，进入WebUI

方案B：手动部署（已有Node.js环境）

下载安装Node.js≥22（https://nodejs.org/），勾选「Add to PATH」，重启PowerShell。
安装OpenClaw：
```
npm install -g openclaw
```
初始化与启动（同PowerShell一键部署）。

四、千问大模型API与免费Coding Plan API详细配置（全平台通用）

1. 阿里云千问大模型API配置（核心方案）

步骤1：获取千问API Key

访问登录阿里云百炼大模型服务平台，登录阿里云账号（需实名认证）。
进入「API-KEY管理」页面，点击「创建API-KEY」，输入名称（如「OpenClaw千问配置」），点击确定。
系统生成API Key（格式：sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx），点击「复制」，妥善保存（仅显示一次，丢失需重新创建）。
开通对应模型服务：在「模型广场」选择「通义千问3.5 Plus」等模型，开通服务（2026年4月新用户有免费额度，可免费使用）。

步骤2：全平台配置命令

# 1. 配置千问API Key（必选）
openclaw config set providers.dashscope-api.apiKey "你的千问API Key"

# 2. 配置千问API基础地址（固定，无需修改）
openclaw config set providers.dashscope-api.baseUrl "https://dashscope.aliyuncs.com/compatible-mode/v1"

# 3. 设置默认模型（根据需求选择，如qwen-turbo、qwen3.5-plus、qwen-max）
openclaw config set models.default "dashscope-api/qwen3.5-plus"

# 4. 重启网关，使配置生效（所有平台通用）
openclaw gateway restart

步骤3：配置文件手动修改（进阶）

若需通过配置文件调整，编辑~/.openclaw/config.json（MacOS/Linux）或C:\Users\你的用户名\.openclaw\config.json（Windows），添加以下内容：

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

保存后重启网关即可生效。

2. 免费Coding Plan API配置（低成本替代方案）

步骤1：获取Coding Plan免费API Key

访问订阅阿里云百炼Coding Plan页面。
2026年4月活动期间，新用户可领取免费额度（如100万tokens），老用户可领取续费额度。
点击「创建API-KEY」，复制生成的Key（格式：sk-sp-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx）。

步骤2：配置命令

# 1. 配置Coding Plan API Key
openclaw config set providers.coding-plan.apiKey "你的Coding Plan API Key"

# 2. 配置Coding Plan API基础地址
openclaw config set providers.coding-plan.baseUrl "https://coding.dashscope.aliyuncs.com/v1"

# 3. 设置默认模型为免费模型
openclaw config set models.default "coding-plan/qwen3.5-free"

零基础落地OpenClaw：阿里云轻量服务器+本地MacOS/Linux/Windows11部署+千问大模型API配置详解

一、部署前置准备（全平台通用）

1. 核心环境要求

2. 关键工具与凭证准备

二、2026年4月阿里云轻量服务器部署OpenClaw步骤

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

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

方案一：一键镜像部署（零基础推荐）

步骤1：购买预装OpenClaw的轻量服务器

步骤2：防火墙端口放行

步骤3：初始化OpenClaw与大模型API配置

方案二：手动命令部署（开发者自定义）

三、本地MacOS/Linux/Windows11部署OpenClaw步骤

1. MacOS系统部署

方案A：一键脚本部署（推荐）

方案B：手动部署（已有Node.js环境）

2. Linux系统部署（Ubuntu/Debian/CentOS）

方案A：一键脚本部署（推荐）

方案B：手动部署

3. Windows11系统部署（管理员权限）

方案A：PowerShell一键部署（推荐）

方案B：手动部署（已有Node.js环境）

四、千问大模型API与免费Coding Plan API详细配置（全平台通用）

1. 阿里云千问大模型API配置（核心方案）

步骤1：获取千问API Key

步骤2：全平台配置命令

步骤3：配置文件手动修改（进阶）

2. 免费Coding Plan API配置（低成本替代方案）

步骤1：获取Coding Plan免费API Key

步骤2：配置命令

热门文章

最新文章

相关电子书

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

零基础落地OpenClaw：阿里云轻量服务器+本地MacOS/Linux/Windows11部署+千问大模型API配置详解

一、部署前置准备（全平台通用）

1. 核心环境要求

2. 关键工具与凭证准备

二、2026年4月阿里云轻量服务器部署OpenClaw步骤

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

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

方案一：一键镜像部署（零基础推荐）

步骤1：购买预装OpenClaw的轻量服务器

步骤2：防火墙端口放行

步骤3：初始化OpenClaw与大模型API配置

方案二：手动命令部署（开发者自定义）

三、本地MacOS/Linux/Windows11部署OpenClaw步骤

1. MacOS系统部署

方案A：一键脚本部署（推荐）

方案B：手动部署（已有Node.js环境）

2. Linux系统部署（Ubuntu/Debian/CentOS）

方案A：一键脚本部署（推荐）

方案B：手动部署

3. Windows11系统部署（管理员权限）

方案A：PowerShell一键部署（推荐）

方案B：手动部署（已有Node.js环境）

四、千问大模型API与免费Coding Plan API详细配置（全平台通用）

1. 阿里云千问大模型API配置（核心方案）

步骤1：获取千问API Key

步骤2：全平台配置命令

步骤3：配置文件手动修改（进阶）

2. 免费Coding Plan API配置（低成本替代方案）

步骤1：获取Coding Plan免费API Key

步骤2：配置命令

热门文章

最新文章

相关电子书