2026年4月阿里云轻量服务器部署OpenClaw保姆级教程（千问+Coding Plan API配置）

一、OpenClaw核心认知与部署前置准备

1.1 核心定位与价值

OpenClaw（曾用名Clawdbot、Moltbot，社区昵称“小龙虾”）是一款开源、本地优先、可自托管的AI智能体框架，核心价值在于让大模型从“被动问答”升级为“主动执行”——不仅能理解自然语言指令，还能直接在服务器上完成文件管理、终端命令执行、API调用、多步骤任务编排等操作，彻底打通“指令→规划→执行”全链路。

其核心优势包括：

• 隐私可控：数据默认存储在本地或私有云，敏感信息不出内网，适配个人与企业隐私需求；
• 强执行能力：支持文件操作、浏览器自动化、终端命令执行、API调用、任务编排，覆盖全场景自动化；
• 多渠道接入：无缝对接Web UI、CLI、飞书、钉钉、企业微信、QQ、Telegram、iMessage等，实现“聊天即操作”；
• 开源可扩展：社区积累数千个技能包（Skills），支持自定义开发，适配个性化场景；
• 阿里云生态深度适配：2026年推出专属轻量服务器镜像，预装核心依赖，一键部署即可使用，完美兼容阿里云千问大模型与Coding Plan免费API。阿里云部署 OpenClaw 只需两步，全网最简单，步骤流程 访问阿里云OpenClaw一键部署专题页面 了解。
  

1.2 部署前置要求（全平台通用，零基础友好）

（1）硬件配置要求（2026最新适配）

（2）核心软件依赖（必装，版本严格匹配）

OpenClaw基于Node.js开发，2026版本强制要求Node.js≥22.x LTS，低版本会导致依赖安装失败、服务无法启动，所有部署场景均需提前安装以下基础依赖：

1. Node.js 22.x LTS（核心底层环境）

   • 阿里云轻量服务器（Ubuntu/CentOS）安装命令：

     # 安装Node.js 22.x LTS版本
     curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt install -y nodejs
     # 验证安装（输出v22.x.x即为成功）
     node -v
     

   • MacOS（Homebrew安装）命令：

     brew install node@22
     # 验证
     node -v
     

   • Windows11（PowerShell管理员身份）：
     访问Node.js官网下载v22.x LTS安装包，双击安装并勾选“Add to PATH”（自动配置环境变量），安装后重启PowerShell执行node -v验证。

2. pnpm（OpenClaw官方推荐包管理器，替代npm）

   • 全系统通用安装命令：

     npm install -g pnpm
     # 验证（输出正常版本号即为成功）
     pnpm -v
     

   • 避坑提醒：优先用pnpm而非npm，依赖安装速度更快、占用空间更小，可避免依赖树卡死问题。

3. Git（可选，源码部署/插件手动安装必装）

   • 阿里云轻量服务器安装命令：

     sudo apt install git -y
     # 验证
     git --version
     

   • 基础部署可跳过，仅需二次开发、自定义插件时安装。

4. Docker（可选，容器化部署必装）

   • 阿里云轻量服务器安装命令：

     curl -fsSL https://get.docker.com | bash
     # 启动并设置开机自启
     sudo systemctl enable docker && sudo systemctl start docker
     # 验证
     docker --version
     docker compose version
     

   • 适合生产环境、多项目并行部署，基础部署可直接用官方镜像，无需Docker。

（3）核心凭证准备（API配置必备，新手必存）

部署完成后需配置大模型API激活核心能力，提前准备以下凭证，避免配置中断：

1. 阿里云百炼API-Key（对接千问大模型，生产环境首选）

   • 获取路径：注册阿里云账号并完成实名认证→访问阿里云百炼大模型服务平台→进入“密钥管理”→点击“创建API-Key”→生成后立即复制保存（仅显示一次，刷新后无法查看）。
   • 新人福利：首次开通百炼可领取90天免费额度，用于模型推理，新手可免费使用基础功能。

2. Coding Plan API-Key（市场免费大模型API，零成本测试替代）

   • 获取路径：访问阿里云百炼Coding Plan专区→领取免费套餐→进入“API管理”→点击“创建API-Key”→复制生成的Key（格式：sk-sp-xxxxxxxx）。
   • 优势：2026年按次收费，成本可控，支持qwen3.5-plus、kimi-k2.5、MiniMax-M2.5、glm-5等模型，适合个人测试与基础使用。

3. 阿里云轻量服务器专属凭证（仅阿里云部署需准备）

   • 阿里云账号（已完成实名认证）、服务器登录密码/密钥、服务器公网IP（后续远程连接、访问Web控制台必备）。

1.3 新手必备工具清单（一站式准备，无遗漏）

二、阿里云轻量服务器零基础部署OpenClaw（核心流程，15分钟落地）

阿里云轻量服务器部署适合7×24小时在线、公网访问、团队共享场景，2026年提供一键镜像部署（新手首选，无需手动配置环境）与手动命令部署（进阶自定义）两种方案，全程可复制代码命令，零基础也能快速完成。

2.1 方案一：一键镜像部署（零基础首选，10分钟完成）

阿里云轻量服务器已推出OpenClaw专属官方镜像，预装Node.js 22、Git、pnpm等核心依赖，购买服务器后自动完成环境搭建，仅需几步初始化配置即可启用，是新手最优选择。

零基础部署 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. 点击“创建实例”，按以下参数配置（新手直接复制，无需调整）：
   • 地域：优先选中国香港（免备案，国内访问延迟低）；其次选美国弗吉尼亚（全球网络最优，适配跨境场景）；国内用户若选内地地域，需完成ICP备案，新手建议直接选海外地域。
   • 镜像：切换到“应用镜像”标签，搜索“OpenClaw（Clawdbot）2026稳定版”（标注“官方预装”，已预装所有依赖）。
   • 实例规格：新手选2核4GB内存+40GB ESSD系统盘+5Mbps带宽（满足基础运行，避免内存不足报错）；预算有限可选2核2GB，但不推荐。
   • 购买时长：新用户选1个月（性价比最高，测试后可续费）；长期使用选1年（更优惠）。
   • 登录方式：设置root强密码（包含大小写字母、数字、特殊符号，如OpenClaw@2026），记录至记事本（后续SSH连接必需）。
   • 勾选服务协议，点击“立即购买”，完成支付。
3. 等待实例创建：支付后约5-10分钟，实例状态变为“运行中”，复制服务器公网IP（如47.0.XX.XX），保存至记事本。

步骤2：放行核心端口（必做，新手易踩坑，否则无法访问）

OpenClaw默认使用随机端口（2026年4月起优化，避免恶意扫描），需先放行端口，否则无法访问Web控制台与服务通信。

1. 进入轻量应用服务器控制台，找到目标实例，点击实例ID进入详情页。
2. 点击“应用详情”页签，在“OpenClaw使用步骤”区域，点击“端口放通”下的“执行命令”，选择“一键放通”。
3. 等待命令执行成功（约1分钟），系统自动放行OpenClaw核心端口，可在“基础配置”中查看随机端口号（后续访问需用到）。
4. 备用方案（手动放行，若一键放通失败）：

   # SSH登录服务器后执行（替换为你的公网IP）
   ssh root@47.0.XX.XX
   # 放行OpenClaw核心端口（随机端口，需替换为实际端口号）
   sudo ufw allow 随机端口号/tcp
   sudo ufw allow 22/tcp（SSH端口，必放）
   sudo ufw reload
   

   避坑提醒：必须同时放行22端口（SSH）与OpenClaw随机端口，否则无法远程连接与访问服务。

步骤3：SSH远程连接服务器（初始化配置，可复制代码）

1. 打开远程连接工具（推荐FinalShell），点击“新建连接”→选择“SSH连接”。
2. 填写连接参数：
   • 主机：服务器公网IP（如47.0.XX.XX）
   • 端口：22（默认SSH端口，无需修改）
   • 用户名：root（固定）
   • 密码：购买服务器时设置的root密码
3. 点击“连接”，输入密码后成功登录服务器（终端界面显示root@xxx:~#即为成功）。
4. 执行初始化命令（一键配置，无需手动干预）：

   # 进入OpenClaw官方默认安装目录
   cd /opt/openclaw
   # 一键初始化（非交互式，自动配置基础环境、接受风险、启用技能市场）
   openclaw init --non-interactive --accept-risk --enable-skill-market
   # 验证初始化是否成功（输出OpenClaw版本号即为成功）
   openclaw --version
   

   避坑提醒：初始化时若提示权限不足，执行sudo chmod -R 755 /opt/openclaw赋予目录权限后重试。

步骤4：启动OpenClaw服务并设置开机自启（长期稳定运行）

# 启动OpenClaw网关服务（后台运行，--detach表示脱离终端）
openclaw gateway start --detach
# 设置服务开机自启（服务器重启后自动运行）
sudo systemctl enable openclaw
# 查看服务状态（显示active (running)即为正常运行）
sudo systemctl status openclaw

• 常见状态说明：
  • active (running)：服务正常，可正常访问
  • inactive (dead)：服务未启动，执行openclaw gateway start --detach重启
  • failed：服务启动失败，查看日志排查：openclaw logs --tail 100。

2.2 方案二：手动命令部署（进阶自定义，适合有基础用户）

若已购买阿里云轻量服务器（未预装OpenClaw镜像），可通过手动命令部署，步骤如下（新手可跳过，直接用一键方案）：

1. SSH登录服务器（同步骤3），执行系统依赖安装命令：

   # Alibaba Cloud Linux系统安装依赖
   yum install -y curl git gcc make
   # Ubuntu系统安装依赖
   sudo apt update && sudo apt install -y curl git gcc make
   

2. 安装Node.js 22.x LTS（用nvm管理版本，避免系统版本冲突）：

   # 安装nvm
   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
   # 激活nvm（Zsh用~/.zshrc，Bash用~/.bashrc）
   source ~/.zshrc
   # 安装Node.js 22
   nvm install 22
   # 切换至Node.js 22版本
   nvm use 22
   # 验证版本
   node -v
   

3. 安装pnpm与OpenClaw：

   # 安装pnpm
   npm install -g pnpm
   # 安装OpenClaw最新稳定版
   pnpm add -g openclaw@latest
   # 验证安装
   openclaw --version
   

4. 后续步骤同一键部署的“步骤3-步骤4”（初始化、启动服务、设置开机自启）。

三、大模型API配置（千问+Coding Plan双方案，新手必做）

OpenClaw本身不提供模型能力，必须接入大模型API才能实现智能交互与任务执行，2026年提供两种配置方案：阿里云千问大模型API（生产环境首选，性能稳定）、免费Coding Plan API（零成本，适合测试），两种方案可同时配置，自由切换。

3.1 方案一：阿里云千问大模型API配置（生产环境首选，稳定高效）

千问大模型是阿里云自研的通用大模型，支持qwen3.5-plus、qwen3-max、qwen3-coder-plus等多种模型，适配复杂任务与高并发场景，2026版本完美兼容OpenClaw，支持国内API节点，无需代理即可稳定使用。

步骤1：获取千问API-Key（必做，仅显示一次，妥善保存）

1. 访问登录阿里云百炼大模型服务平台，登录阿里云账号（已完成实名认证）。
2. 进入左侧菜单栏“密钥管理”页面，点击“创建API-Key”。
3. 输入密钥名称（如“OpenClaw-千问”），点击“确定”，系统自动生成API-Key（格式：sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx）。
4. 立即复制并保存至加密记事本，页面刷新后无法再次查看，若怀疑泄露需立即禁用旧密钥并重新创建。
5. 记录对应地域的Base URL（根据服务器地域选择，降低网络延迟）：
   • 华北2（北京）：https://dashscope.aliyuncs.com/compatible-mode/v1
   • 新加坡：https://dashscope-intl.aliyuncs.com/compatible-mode/v1
   • 美国（弗吉尼亚）：https://dashscope-us.aliyuncs.com/compatible-mode/v1