保姆级图文教程：阿里云轻量服务器+本地三系统部署OpenClaw(Clawdbot)+集成千问/Coding Plan API步骤流程

2026年，OpenClaw（原Clawdbot）作为轻量化开源AI代理框架，凭借跨平台兼容、多IM平台无缝对接、大模型灵活调度的特性，成为个人与团队搭建专属AI助手的核心方案。本文完整覆盖2026年阿里云轻量服务器部署及本地MacOS/Linux/Windows11部署OpenClaw(Clawdbot)步骤流程及阿里云千问大模型API配置或市场上免费大模型Coding Plan API配置及常见问题解答，核心聚焦Slack全球协作平台集成全流程，所有代码命令可直接复制，全程无复杂操作，新手也能一次成功落地，打造可在Slack中直接交互的智能AI助手。

一、部署前核心准备（全平台通用，零基础必看）

1.1 OpenClaw 2026环境依赖标准

低于以下标准易出现启动失败、消息响应异常、大模型调用卡顿等问题，务必提前确认：

• 核心运行环境：Node.js ≥ v22.0.0（2026稳定版推荐v22.16.0，LTS长期支持版）、Git ≥ 2.30.0（用于插件安装与版本更新）
• 硬件要求：内存≥2GB（阿里云轻量服务器推荐2核4GB，本地部署建议4GB及以上）、磁盘空间≥10GB（存储配置、模型缓存、日志与Slack消息记录）
• 网络要求：外网通畅（阿里云轻量服务器优先选中国香港/新加坡/美国弗吉尼亚地域，免ICP备案，适配Slack与千问国际节点）
• 权限要求：阿里云账号完成实名认证、Slack账号拥有Workspace管理员权限（用于创建应用与配置权限）阿里云部署 OpenClaw 全网最简单，只需两步，详情 访问阿里云OpenClaw一键部署专题页面 了解。
  
  
  
  

1.2 阿里云轻量服务器部署必备条件

• 实例配置：新手首选2核4GiB内存 + 40GB ESSD系统盘 + 5Mbps带宽（个人测试可先用2核2GiB，长期使用建议升级）
• 镜像选择：应用镜像 → OpenClaw（Clawdbot/Moltbot）2026专属版（Alibaba Cloud Linux 3）（预装Node.js 22、Git、防火墙规则、Slack接入组件，无需手动配置环境）
• 地域选择：优先中国香港/新加坡/美国弗吉尼亚（免备案，Slack连接稳定，千问大模型API访问延迟低）
• 防火墙规则：必须放行22端口（SSH远程）、18789端口（OpenClaw核心服务）、443端口（HTTPS通信）（Slack Socket模式/HTTP模式均需依赖）
• 大模型API准备：阿里云千问Qwen3.6-Plus（付费高性能，支持百万上下文）或阿里云百炼Coding Plan（免费零成本，日常场景够用）二选一

1.3 本地部署必备条件（MacOS/Linux/Windows11）

• 通用要求：网络通畅（本地需能访问外网，对接Slack与阿里云百炼API）、足够磁盘空间（≥10GB）

二、2026年阿里云轻量服务器部署OpenClaw完整流程（官方镜像，一键部署）

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

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

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

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

2.1 轻量服务器实例创建（零基础10分钟搞定）

1. 登录阿里云控制台，搜索进入轻量应用服务器，点击创建实例。
2. 基础配置：
   • 镜像：切换至应用镜像，搜索并选中OpenClaw（Clawdbot/Moltbot）2026专属版（认准官方标识，避免第三方镜像）
   • 实例规格：新手选2核4GiB内存（最低2GiB，避免内存不足），系统盘默认40GB ESSD即可
   • 地域：选中国香港/新加坡/美国弗吉尼亚（免备案，Slack连接无阻碍）
   • 带宽：选5Mbps固定带宽（满足Slack消息收发、大模型调用需求）
3. 网络与防火墙：
   • 自动分配公网IP：勾选是（必须，否则无法外部访问与Slack回调）
   • 防火墙规则：勾选开放22端口（SSH）、18789端口（OpenClaw）、443端口（HTTPS），系统自动配置入方向规则
4. 登录设置：登录方式选密码登录，设置强密码（大小写+数字+符号，≥12位，牢记备用）。
5. 确认订单：核对配置无误后，点击立即购买，支付完成后等待实例状态变为运行中（约3-5分钟）。

2.2 远程连接与基础配置（新手必做，避免踩坑）

步骤1：远程连接轻量服务器（两种方式，新手首选Web终端）

• 方式1（Web终端，零基础推荐）：进入实例详情页，点击远程连接 → Web终端，输入设置的密码，点击确定，进入Alibaba Cloud Linux 3终端界面。
• 方式2（SSH工具，进阶用户）：用FinalShell/Xshell等工具，输入服务器公网IP、用户名（root）、密码，点击连接。

步骤2：系统更新与依赖校验（确保环境正常）

# 更新系统软件包（修复依赖漏洞，避免版本冲突）
sudo yum update -y

# 校验核心依赖版本（必须达标，否则后续配置报错）
node --version  # 需≥v22.0.0，显示v22.16.0最佳
git --version   # 需≥2.30.0
openclaw --version  # 显示2026.x.x即为预装成功

步骤3：防火墙端口二次放行（安全加固，必做）

阿里云控制台防火墙已放行端口，系统内部防火墙需同步配置，避免拦截请求：

# 启动firewalld防火墙（未启动则执行）
sudo systemctl start firewalld

# 设置防火墙开机自启（服务器重启后自动生效）
sudo systemctl enable firewalld

# 永久放行核心端口（22=SSH、18789=OpenClaw、443=HTTPS）
sudo firewall-cmd --permanent --add-port=22/tcp
sudo firewall-cmd --permanent --add-port=18789/tcp
sudo firewall-cmd --permanent --add-port=443/tcp

# 重载防火墙规则使配置生效
sudo firewall-cmd --reload

# 验证端口放行状态（输出22、18789、443即为成功）
sudo firewall-cmd --list-ports

步骤4：OpenClaw服务启动与自启配置（7×24小时在线）

# 启动OpenClaw核心网关服务
sudo systemctl start openclaw-gateway

# 设置开机自启（服务器重启后自动运行，无需手动启动）
sudo systemctl enable openclaw-gateway

# 查看服务运行状态（显示active (running)即为正常）
sudo systemctl status openclaw-gateway

# 一键诊断系统（排查依赖、端口、配置、网络问题）
openclaw status --all

步骤5：安全认证配置（防止非法访问，企业级必做）

公网直接访问存在安全风险，必须启用令牌认证，避免未授权访问：

# 启用令牌认证模式（关闭无密码公网访问）
openclaw config set gateway.auth.mode token

# 设置自定义安全令牌（长度≥12位，含大小写、数字、符号，牢记备用）
openclaw config set gateway.auth.token "Slack@OpenClaw2026Aliyun"

# 重启网关服务使配置生效
openclaw gateway restart

2.3 访问验证（阿里云轻量部署完成）

本地浏览器输入：http://服务器公网IP:18789，粘贴设置的安全令牌，登录OpenClaw Web UI管理面板，显示控制台界面即部署成功。

三、本地全平台部署OpenClaw（MacOS/Linux/Windows11，2026官方流程）

3.1 本地MacOS部署OpenClaw（Homebrew方式，推荐开发者）

步骤1：环境安装（Node.js+Git，一键搞定）

# 安装Homebrew（未安装则执行，国内镜像加速）
/bin/bash -c "$(curl -fsSL https://mirrors.aliyun.com/homebrew/install.sh)"

# 安装Node.js 22 & Git（预装依赖，避免版本过低）
brew install node@22 git

# 配置Node.js环境变量（使全局生效，避免command not found）
echo 'export PATH="$(brew --prefix node@22)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 验证版本（必须达标，直接复制执行）
node --version  # 需≥v22.0.0
git --version   # 需≥2.30.0

# 配置npm国内镜像（加速安装，避免超时失败）
npm config set registry https://registry.npmmirror.com

步骤2：OpenClaw安装与启动（官方一键脚本）

# 官方一键脚本安装（自动配置所有依赖，无需手动操作）
curl -fsSL https://openclaw.ai/install.sh | bash

# 或npm全局安装（备用，适合进阶用户）
npm install -g openclaw@latest

# 初始化配置（向导模式，新手直接回车默认，无需手动修改）
openclaw onboard

# 启动OpenClaw服务（前台启动，查看日志；后台启动加--daemon）
openclaw gateway start --daemon

# 设置开机自启（可选，MacOS重启后自动运行）
sudo openclaw gateway install

# 访问本地Web UI（自动打开浏览器，输入令牌登录）
open http://localhost:18789

步骤3：MacOS专属避坑（高频问题解决）

# 1. 权限不足（EACCES错误，安装/启动失败）
sudo npm install -g openclaw@latest  # 加sudo提升权限

# 2. 18789端口占用（服务启动失败）
lsof -i :18789  # 查询占用进程PID
kill -9 PID     # 结束占用进程

# 3. 换端口启动（端口冲突时，避免与其他服务冲突）
openclaw gateway --port 18790

# 4. M系列芯片（Apple Silicon）兼容性问题
softwareupdate --install-rosetta  # 安装Rosetta 2，兼容x86程序

3.2 本地Linux部署OpenClaw（Ubuntu/Debian通用，稳定可靠）

步骤1：环境安装（Node.js+Git，官方源安装）

# 更新系统软件包（修复漏洞，安装依赖）
sudo apt update && sudo apt upgrade -y

# 安装Node.js 22（官方源，避免版本过低）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs git

# 验证版本（直接复制执行，确认环境正常）
node --version
git --version

# 配置npm国内镜像（加速安装，提升效率）
npm config set registry https://registry.npmmirror.com

步骤2：OpenClaw安装与启动（一键安装+系统服务）

# 官方一键脚本安装（推荐，自动配置环境）
curl -fsSL https://openclaw.ai/install.sh | bash

# 或npm全局安装（备用）
sudo npm install -g openclaw@latest

# 初始化配置（新手直接回车，快速完成基础设置）
openclaw onboard

# 启动服务并设置开机自启（Linux系统推荐，稳定运行）
sudo systemctl start openclaw-gateway
sudo systemctl enable openclaw-gateway

# 验证服务状态（显示active (running)即为成功）
sudo system即为成功）
sudo systemctl status openclaw-gateway

# 访问本地服务（curl测试，确认服务正常）
curl http://localhost:18789

步骤3：Linux常见问题（快速排查，直接复制解决）

# 1. command not found（命令未找到，环境变量未生效）
sudo npm install -g openclaw@latest
source ~/.bashrc  # 刷新环境变量

# 2. 权限问题（配置文件无法写入）
sudo chown -R $USER:$USER ~/.openclaw  # 赋予当前用户权限

# 3. 防火墙拦截（无法访问Web UI）
sudo ufw allow 18789/tcp  # 放行18789端口
sudo ufw allow 443/tcp    # 放行443端口
sudo ufw reload          # 重载防火墙规则

# 4. 内存不足（服务启动失败、卡顿）
# 关闭无用进程，或升级本地内存至4GB及以上（本地部署最低2GB，推荐4GB）

3.3 本地Windows11部署OpenClaw（管理员PowerShell，完整流程）

步骤1：环境安装（Node.js+Git，winget方式，管理员权限）

必须以管理员身份打开PowerShell（Win+X → 终端(管理员)）：

# 允许脚本执行（解决PowerShell权限拦截，避免安装失败）
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
# 输入Y确认，回车执行

# 安装Node.js 22（winget官方源，稳定版本）
winget install OpenJS.NodeJS --version 22.16.0

# 安装Git（官方源，适配Windows系统）
winget install Git.Git

# 重启终端（使环境变量生效），验证版本（直接复制执行）
node -v  # 需≥v22.0.0
git --version

# 配置npm国内镜像（加速安装，避免超时）
npm config set registry https://registry.npmmirror.com

步骤2：OpenClaw安装与启动（一键安装+Windows服务）

# 官方一键脚本安装（推荐，自动配置Windows服务）
iwr -useb https://openclaw.ai/install.ps1 | iex

# 或npm全局安装（备用，管理员权限执行）
npm install -g openclaw@latest

# 验证安装（显示openclaw版本号即为成功）
openclaw --version

# 初始化配置（向导模式，新手直接回车，快速完成）
openclaw onboard

# 启动服务（前台启动，查看日志；后台启动加--daemon）
openclaw gateway start --daemon

# 安装为Windows服务（开机自启，7×24小时在线，推荐）
openclaw gateway install

# 访问本地Web UI（自动打开浏览器，输入令牌登录）
start http://localhost:18789

步骤3：Windows11高频问题（直接复制解决，新手必看）

# 1. 端口占用（18789端口被占用，服务启动失败）
netstat -ano | findstr :18789  # 查询占用进程PID
taskkill /F /PID PID         # 结束占用进程

# 2. 权限不足（安装/配置失败，提示拒绝访问）
重新以管理员身份打开PowerShell执行命令

# 3. 杀毒软件拦截（安装卡住、服务启动失败）
暂时关闭本地杀毒/防火墙，或添加`C:\Users\用户名\.openclaw`到白名单

# 4. 中文路径报错（配置文件写入失败）
OpenClaw安装路径必须全英文，无空格、中文、特殊字符（如D:\OpenClaw，避免D:\我的OpenClaw）