一站式搭建OpenClaw(Clawdbot)：阿里云1分钟部署、本地多系统适配与大模型API对接实战手册-阿里云开发者社区

一、前言

2026年，OpenClaw（曾用名Clawdbot）已成为轻量化、高扩展、跨平台的AI智能体运行框架，凭借极低资源占用、插件化能力扩展、多模型兼容与可视化管理等优势，成为个人与团队搭建AI自动化工作流的首选方案。无论是需要7×24小时稳定运行的云端服务，还是本地快速调试的开发环境，OpenClaw均能完美适配。本文基于2026年最新实践，完整覆盖阿里云轻量服务器零基础部署、本地MacOS/Linux/Windows11全平台安装、阿里云千问Qwen3.6-Plus大模型配置、免费Coding Plan API接入、全平台运维命令与高频问题一站式排查，所有代码可直接复制执行，全程无门槛、无冗余配置，适合零基础用户与开发者快速上手。

二、部署前核心准备

2.1 基础环境要求

云端部署（阿里云轻量服务器）
- 实例规格：2核4GB内存 + 40GB ESSD云盘 + 5Mbps带宽（最低2核2GB，推荐4GB避免内存溢出）
- 地域选择：中国香港、新加坡、美国弗吉尼亚（内地除香港外联网搜索功能受限）
- 系统镜像：OpenClaw（Clawdbot）2026官方稳定版（Alibaba Cloud Linux 3.2104）
- 必备权限：阿里云账号完成实名认证，可访问轻量服务器与百炼控制台
本地部署（三系统通用）
- 系统版本：macOS 12+ / Ubuntu 20.04+ / Windows 11（WSL2）
- 核心依赖：Node.js 22.x及以上版本、Git、npm/pnpm
- 内存要求：≥4GB，推荐8GB以上保证流畅运行
- 权限：macOS/Linux需sudo权限，Windows需管理员PowerShell权限
  阿里云部署 OpenClaw 全网最简单，只需两步，详情访问阿里云OpenClaw一键部署专题页面 了解。

2.2 关键端口与文件说明

默认端口：OpenClaw核心Web控制台与服务端口为18789（TCP），必须放行
配置文件路径
- Linux/macOS：~/.openclaw/openclaw.json
- Windows11（WSL2）：/home/用户名/.openclaw/openclaw.json
核心命令：全平台通用，openclaw为主命令，gateway为网关服务管理模块

三、阿里云轻量服务器部署OpenClaw（2026零基础版）

步骤1：创建实例与选择镜像

登录阿里云控制台，进入轻量应用服务器 → 点击创建实例
镜像选择：应用镜像 → OpenClaw（Clawdbot）2026稳定版（官方预装，无需手动配置环境）
实例配置（新手直接照搬）
- 实例名称：自定义（如OpenClaw-2026）
- 地域：中国香港（免备案、延迟低）
- 套餐：2核4GB + 40GB ESSD + 5Mbps
- 登录方式：密码登录（设置高强度密码）
完成购买，等待实例状态变为运行中（约1–3分钟）

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

第一步：点击打开访问阿里云OpenClaw一键部署专题页面。
阿里云OpenClaw一键部署专题页面：https://www.aliyun.com/activity/ecs/clawdbot

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

镜像：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 的地址。

步骤2：防火墙放行18789端口（必做）

方式一：控制台可视化放行（推荐新手）

进入实例详情 → 应用详情 → 找到端口放通
点击一键放通，自动放行TCP 18789端口

方式二：命令行放行（进阶）
通过Workbench或SSH远程连接服务器，执行：

# 永久放行18789端口
sudo firewall-cmd --permanent --add-port=18789/tcp
# 重载防火墙规则
sudo firewall-cmd --reload
# 验证端口是否放行
sudo firewall-cmd --list-ports | grep 18789

步骤3：初始化与启动服务（核心命令）

# 1. 进入OpenClaw安装目录
cd /opt/openclaw

# 2. 配置国内npm镜像（加速依赖安装）
npm config set registry https://registry.npmmirror.com

# 3. 非交互式初始化（跳过向导，自动完成配置）
openclaw init --non-interactive --accept-risk

# 4. 安装系统服务并设置开机自启（服务器重启后自动运行）
openclaw gateway install

# 5. 后台守护进程启动（推荐，关闭终端不中断服务）
openclaw gateway start --daemon

# 6. 查看服务运行状态
openclaw gateway status
# 显示"active (running)"表示启动成功

步骤4：访问Web控制台与生成Token

获取访问地址：http://你的服务器公网IP:18789

生成管理员Token（首次访问需验证）

# 生成永久管理员Token，允许所有IP访问
openclaw token generate --admin --allow-ip 0.0.0.0/0
# 执行后复制生成的Token，粘贴到Web控制台登录框

阿里云轻量服务器避坑指南（新手必看）

内存不足导致服务崩溃：严禁使用1核1GB/2核2GB实例，最低2核4GB
端口未放行无法访问：必须完成步骤2，90%新手问题源于此
服务未设置自启：必须执行openclaw gateway install，否则服务器重启后服务失效
地域选择错误：内地地域（除香港）无法使用联网搜索功能，优先选香港/新加坡
命令不存在：执行source /etc/profile刷新环境变量，或重新安装
启动后自动退出：执行openclaw logs gateway查看日志，多为配置文件错误或端口占用

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

4.1 macOS 部署（官方推荐）

# 1. 安装Xcode命令行工具（必备依赖）
xcode-select --install

# 2. 安装Homebrew包管理器（如已安装可跳过）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 3. 安装Node.js 22.x（指定版本，避免兼容问题）
brew install node@22
# 配置环境变量（永久生效）
echo 'export PATH="/opt/homebrew/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 4. 一键安装OpenClaw（官方脚本，自动处理所有依赖）
curl -fsSL https://openclaw.ai/install.sh | bash

# 5. 初始化并安装系统服务（开机自启）
openclaw onboard --install-daemon

# 6. 后台启动服务
openclaw gateway start --daemon

# 7. 验证安装
openclaw --version
# 显示2026.x.x版本号即成功

4.2 Linux（Ubuntu/Debian）部署

# 1. 更新系统并安装基础依赖
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git build-essential

# 2. 安装Node.js 22.x（官方源）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash
sudo apt install -y nodejs

# 3. 安装OpenClaw（国内镜像加速）
npm install -g openclaw@latest --registry=https://registry.npmmirror.com

# 4. 初始化并配置自启
openclaw onboard --install-daemon

# 5. 放行防火墙端口
sudo ufw allow 18789/tcp
sudo ufw reload

# 6. 启动服务
openclaw gateway start --daemon

4.3 Windows11 部署（WSL2 唯一支持方式）

步骤1：启用WSL2（管理员PowerShell执行）

# 安装WSL2并设置默认版本
wsl --install
wsl --set-default-version 2
# 重启电脑完成安装

步骤2：WSL2 Ubuntu终端执行部署

# 1. 更新系统
sudo apt update && sudo apt upgrade -y

# 2. 安装Node.js与依赖
sudo apt install -y nodejs npm

# 3. 安装OpenClaw
npm install -g openclaw@latest --registry=https://registry.npmmirror.com

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

4.4 本地部署验证

浏览器访问：http://localhost:18789，输入Token即可进入控制台

本地部署避坑指南

Windows原生部署失败：不支持直接运行，必须使用WSL2
macOS权限错误：命令前加sudo，或执行chown -R $USER ~/.openclaw
Node.js版本过低：必须≥22.x，执行node -v验证
端口被占用：执行lsof -i :18789（Mac/Linux）或netstat -ano | findstr :18789（Windows）找到进程并关闭

五、大模型API配置（千问Qwen3.6-Plus + 免费Coding Plan）

5.1 阿里云千问Qwen3.6-Plus 配置（付费高性能）

步骤1：获取API Key

登录阿里云百炼控制台 → 密钥管理 → 创建API Key
选择Qwen3.6-Plus权限，生成sk-xxxx格式密钥（仅显示一次，妥善保存）
记录对应地域Base URL：
- 国内（北京/杭州）：https://dashscope.aliyuncs.com/compatible-mode/v1
- 中国香港/新加坡：https://dashscope-intl.aliyuncs.com/compatible-mode/v1

步骤2：配置文件写入（全平台通用）

# 编辑配置文件
nano ~/.openclaw/openclaw.json

写入以下配置（替换API Key与Base URL）

{
   
  "models": {
   
    "default": "dashscope-api/qwen3.6-plus",
    "providers": {
   
      "dashscope-api": {
   
        "baseUrl": "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
        "apiKey": "sk-你的千问Qwen3.6-Plus API Key",
        "models": [
          {
   
            "id": "qwen3.6-plus",
            "maxTokens": 8192,
            "temperature": 0.3,
            "reasoning": false
          }
        ]
      }
    }
  }
}

步骤3：重启服务生效

openclaw gateway restart

步骤4：验证模型调用

openclaw model test
# 显示"Model test passed"表示配置成功

5.2 免费Coding Plan API 配置（零成本轻量使用）

步骤1：获取免费API Key

进入阿里云百炼Coding Plan页面 → 订阅免费套餐
密钥管理 → 创建API Key，生成sk-sp-xxxx格式密钥

步骤2：配置文件写入

nano ~/.openclaw/openclaw.json

写入免费模型配置

{
   
  "models": {
   
    "default": "coding-plan/coding-free",
    "providers": {
   
      "coding-plan": {
   
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "apiKey": "sk-sp-你的Coding Plan免费API Key",
        "models": [
          {
   
            "id": "coding-free",
            "maxTokens": 4096,
            "temperature": 0.5
          }
        ]
      }
    }
  }
}

步骤3：重启与验证

openclaw gateway restart
openclaw model test

大模型配置避坑指南

API Key错误/过期：重新生成密钥，确保无空格、无多余字符
Base URL与地域不匹配：香港/新加坡必须使用国际版地址
模型ID错误：千问为qwen3.6-plus，Coding Plan为coding-free
reasoning设为true：必须设为false，否则模型无回复
额度不足：Coding Plan免费版每日有限额，超额需等待重置

六、OpenClaw全平台通用运维命令

# 服务管理
openclaw gateway start          # 前台启动
openclaw gateway start --daemon # 后台启动
openclaw gateway stop           # 停止服务
openclaw gateway restart        # 重启服务
openclaw gateway status         # 查看状态
openclaw gateway install        # 安装系统服务（开机自启）
openclaw gateway uninstall      # 卸载系统服务

# 配置与日志
openclaw config edit            # 编辑配置文件
openclaw config reload          # 重载配置
openclaw logs                   # 查看所有日志
openclaw logs gateway -f        # 实时查看网关日志
openclaw doctor                 # 系统检查与自动修复

# 模型与权限
openclaw model list             # 列出可用模型
openclaw model test             # 测试模型连接
openclaw token generate --admin # 生成管理员Token

# 技能管理
openclaw skill install 技能名    # 安装技能
openclaw skill list             # 查看已安装技能
openclaw skill uninstall 技能名  # 卸载技能

七、高频问题一站式解答（覆盖95%故障）

1. 无法访问Web控制台（http://IP:18789）

检查18789端口是否放行（服务器防火墙+安全组）
执行openclaw gateway status确认服务运行中
本地部署关闭电脑防火墙/安全软件
服务器公网IP是否正确，无VPN干扰

2. 服务启动后立即退出/自动停止

内存不足：升级至4GB以上内存
端口被占用：关闭占用18789的程序
配置文件JSON格式错误：检查引号、逗号，用openclaw doctor修复
依赖缺失：重新执行openclaw init

3. 模型调用失败/无回复

API Key错误、过期或权限不足
Base URL填写错误（国内/国际版混淆）
账户无可用额度（千问）或免费额度用尽（Coding Plan）
网络无法访问百炼API（服务器地域限制）

4. 命令不存在：openclaw: command not found

npm全局路径未加入环境变量
执行source ~/.zshrc（Mac）或source ~/.bashrc（Linux）
重新安装：npm install -g openclaw@latest

5. Windows11部署失败

未启用WSL2，必须用WSL2运行
未用管理员身份打开PowerShell
网络问题导致下载失败，切换国内npm镜像

6. 技能安装后不生效

必须执行openclaw gateway restart重启服务
技能名称错误，核对官方技能列表
技能与当前OpenClaw版本不兼容

7. 服务器重启后服务不运行

未执行openclaw gateway install设置开机自启
执行systemctl enable openclaw-gateway手动添加自启

8. 模型回复慢/超时

服务器带宽不足（推荐≥5Mbps）
地域过远，更换就近节点
降低maxTokens参数（如从8192改为4096）

八、总结

本文基于2026年最新实践，完整提供了阿里云轻量服务器零基础部署、本地MacOS/Linux/Windows11全平台安装、阿里云千问Qwen3.6-Plus高性能配置、免费Coding Plan零成本接入、全平台运维命令与高频问题一站式排查的完整方案。所有步骤均经过实测验证，代码可直接复制执行，无需额外修改，真正实现零基础15分钟内完成从云端到本地的全链路部署。

核心要点回顾：

云端最低2核4GB，本地4GB内存起步
18789端口必须放行，90%访问问题源于此
大模型配置后必须重启服务生效
免费Coding Plan满足日常轻量使用，千问适合高性能场景
故障优先用openclaw logs与openclaw doctor排查

按照本文流程操作，即可快速搭建稳定、高效、可扩展的OpenClaw AI智能体服务，实现自然语言驱动的自动化工作流、智能问答、技能扩展等全场景能力。

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

一站式搭建OpenClaw(Clawdbot)：阿里云1分钟部署、本地多系统适配与大模型API对接实战手册