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

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

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

1. 核心环境要求

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及以上。
• 地域：默认美国（弗吉尼亚），目前中国内地域（除香港）的轻量应用服务器，联网搜索功能受限。
• 时长：根据自己的需求及预算选择。

第三步：打开访问阿里云百炼大模型控制台，找到密钥管理，单击创建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 的地址。
  
  

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

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

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

步骤2：防火墙端口放行

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

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

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

1. 远程连接服务器（SSH方式）：
   • 打开FinalShell，点击「新建连接」→「SSH连接」，填写公网IP、用户名（root）、密码，点击连接。
2. 执行初始化命令：

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

3. 配置千问大模型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
     

4. 配置免费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
     

5. 获取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环境）

1. 下载安装Node.js≥22（https://nodejs.org/），勾选「Add to PATH」，重启PowerShell。
2. 安装OpenClaw：

   npm install -g openclaw
   

3. 初始化与启动（同PowerShell一键部署）。

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

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

步骤1：获取千问API Key

1. 访问登录阿里云百炼大模型服务平台，登录阿里云账号（需实名认证）。
2. 进入「API-KEY管理」页面，点击「创建API-KEY」，输入名称（如「OpenClaw千问配置」），点击确定。
3. 系统生成API Key（格式：sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx），点击「复制」，妥善保存（仅显示一次，丢失需重新创建）。
4. 开通对应模型服务：在「模型广场」选择「通义千问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

1. 访问订阅阿里云百炼Coding Plan页面。
2. 2026年4月活动期间，新用户可领取免费额度（如100万tokens），老用户可领取续费额度。
3. 点击「创建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"