一、前言
2026年，OpenClaw（原Clawdbot）已成为轻量化、高可扩展AI智能体框架的主流选择，支持云端与本地双部署、多平台消息集成与强大工具调用能力。对于零基础用户，阿里云计算巢提供官方认证一键部署模板，阿里云轻量服务器提供稳定运行环境，同时支持MacOS/Linux/Windows11全平台本地部署，覆盖个人、团队全场景需求。搭配阿里云千问Qwen系列大模型的高性能API与Coding Plan免费API，可实现长文本理解、复杂推理、代码生成、多轮对话等核心能力，形成“高性能+低成本”的完整方案。
本文基于2026年4月最新实践，完整覆盖阿里云计算巢部署、阿里云轻量服务器部署、本地三系统部署OpenClaw全流程、阿里云千问Qwen与Coding Plan API配置、全场景避坑指南及常见问题解答，所有步骤细致拆解、代码命令可直接复制运行，新手1小时内即可完成从环境搭建到AI交互的全流程落地，彻底消除技术门槛。阿里云部署 OpenClaw 全网最简单，只需两步，详情 访问阿里云OpenClaw一键部署专题页面 了解。
二、部署前核心准备（新手必看，5分钟完成）
（一）账号与权限准备
- 阿里云账号：注册并完成个人实名认证，未实名无法创建云资源、获取大模型API密钥。新用户可享计算巢、轻量服务器新客优惠与百炼大模型免费额度，满足初期测试需求。
- 核心API密钥获取
- 千问Qwen API Key：登录阿里云百炼平台（dashscope.aliyun.com），进入「API Key管理」，创建标准API Key（格式
sk-xxxx，仅显示一次，妥善保存）。 - Coding Plan免费API Key：同一平台进入「Coding Plan」领取免费套餐（90天免费额度），生成专属密钥（格式
sk-sp-xxxx），作为低成本备用方案。
- 千问Qwen API Key：登录阿里云百炼平台（dashscope.aliyun.com），进入「API Key管理」，创建标准API Key（格式
- 本地环境要求
- 系统：MacOS 12+、Linux（Ubuntu 22.04+、CentOS 7+）、Windows 10/11（64位）。
- 硬件：最低2GB内存（推荐4GB+）、10GB可用存储、稳定网络。
- 权限：Windows需管理员权限，MacOS/Linux需sudo权限。
- 工具准备：Chrome/Edge浏览器、本地终端（Mac终端、Windows PowerShell、Linux Shell）、远程连接工具（可选）。
（二）云端部署资源选择（避坑关键）
1. 阿里云计算巢（零代码首选）
- 实例规格：2核4GB内存+40GB ESSD云盘（最低配置，<2GB易启动失败）。
- 地域：中国香港、新加坡、美国弗吉尼亚（免备案，大模型访问稳定）。
- 模板：计算巢应用市场→OpenClaw 2026稳定版（官方认证，预装Node.js 22）。
2. 阿里云轻量服务器（稳定高性价比）
- 实例规格：2核4GB+40GB ESSD+5Mbps带宽（7×24小时稳定运行）。
- 地域：同计算巢，优先海外免备案地域。
- 镜像：应用镜像→OpenClaw（Clawdbot）2026.4（预装全环境）。
三、阿里云计算巢部署OpenClaw（零基础10分钟，零代码）
（一）创建计算巢实例
- 登录阿里云控制台，访问阿里云计算巢OpenClaw社区版部署页面，搜索OpenClaw，选择官方社区版模板，点击立即部署。
- 基础配置（新手直接照搬）：
- 服务名称：自定义（如
OpenClaw-ComputeNest-01）。 - 地域：中国香港/新加坡。
- 规格：2核4GB + 40GB ESSD。
- 登录密码：设置强密码（大小写+数字+符号）。
- 管理员Token：勾选自动生成。
- 百炼API Key：可先留空，后续手动配置。
- 服务名称：自定义（如
- 点击确认部署，等待3-5分钟，实例状态变为运行中。
- 进入实例详情，复制公网IP、管理员Token，保存备用。
（二）端口放行（计算巢自动配置，验证即可）
计算巢模板自动放行18789（Web控制台）、22（SSH）端口。
验证命令（远程连接后执行）：
sudo firewall-cmd --list-ports
# 输出含18789/tcp即成功
（三）初始化与启动（命令直接复制）
远程连接（本地终端执行）：
ssh root@计算巢公网IP系统更新与环境验证：
sudo yum update -y node -v # 需≥22.0.0 pnpm -v openclaw --version一键初始化：
npm config set registry https://registry.npmmirror.com/ openclaw init --non-interactive --accept-risk后台启动服务（7×24小时运行）：
openclaw gateway start --daemon openclaw gateway status # 显示active(running)即成功访问Web控制台：
浏览器访问：http://计算巢公网IP:18789?token=你的管理员Token，发送测试消息正常回复即部署成功。
（四）计算巢部署避坑指南
- 地域选错：内地地域需备案、大模型调用受限。避坑：必选香港/新加坡/弗吉尼亚。
- 内存不足：<4GB导致启动失败、模型超时。避坑：最低2核4GB。
- 服务未后台运行：关闭终端服务停止。避坑：启动必加
--daemon。 - Token丢失：无法登录控制台。避坑：重新生成：
openclaw token generate --admin。 - 开机不自启：服务器重启服务失效。避坑：设置自启：
echo "@reboot openclaw gateway start --daemon" >> /etc/crontab systemctl restart crond
四、阿里云轻量服务器部署OpenClaw（零基础15分钟）
（一）创建轻量服务器实例
- 访问阿里云轻量应用服务器控制台，点击创建实例。
- 配置（新手照搬）：
- 地域：中国香港/新加坡。
- 镜像：应用镜像→OpenClaw 2026.4稳定版。
- 规格：2核4GB+40GB ESSD+5Mbps。
- 登录密码：设置强密码。
- 确认购买，等待1-3分钟，实例运行中，复制公网IP。
零基础部署 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 的地址。
（二）端口放行（核心必做，新手高频踩坑）
- 实例详情→防火墙→一键放通，自动开放18789端口。
- 手动放行（一键失效时）：
- 协议：TCP，端口：18789，策略：允许，来源：0.0.0.0/0。
- 系统命令放行（远程连接后）：
sudo firewall-cmd --permanent --add-port=18789/tcp sudo firewall-cmd --reload sudo firewall-cmd --list-ports
（三）初始化与启动（同计算巢，命令复用）
# 远程连接
ssh root@轻量服务器公网IP
# 环境验证
sudo yum update -y
node -v
openclaw --version
# 初始化
npm config set registry https://registry.npmmirror.com/
openclaw init --non-interactive --accept-risk
# 后台启动
openclaw gateway start --daemon
openclaw gateway status
（四）轻量服务器部署避坑指南
- 端口未放行：Web控制台无法访问。避坑：控制台+系统双重放行。
- 带宽不足：<5Mbps导致模型响应慢、超时。避坑：最低5Mbps带宽。
- 命令不存在：
openclaw: command not found。避坑：修复PATH：echo 'export PATH=$(npm config get prefix)/bin:$PATH' >> ~/.bashrc source ~/.bashrc
五、本地全平台部署OpenClaw（MacOS/Linux/Windows11，零基础）
（一）Windows11部署（管理员权限）
1. 准备：
以管理员身份打开PowerShell（右键→以管理员身份运行）。
2. 一键安装脚本（国内镜像，加速下载）：
# 允许执行脚本（必做，否则报错）
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
# 国内镜像一键安装
iwr -useb https://clawd.org.cn/install.ps1 | iex
3. 初始化与启动：
# 配置国内npm源
npm config set registry https://registry.npmmirror.com/
# 初始化
openclaw init --non-interactive --accept-risk
# 后台启动
openclaw gateway start --daemon
# 验证
openclaw gateway status
4. 访问控制台：
浏览器打开http://localhost:18789。
（二）MacOS部署
1. 安装Homebrew（无则执行）：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2. 安装Node.js 22：
brew install node@22
echo 'export PATH="$(brew --prefix node@22)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
node -v # 验证≥22.0.0
3. 一键安装OpenClaw：
curl -fsSL https://clawd.org.cn/install.sh | bash
4. 启动服务：
openclaw init --non-interactive --accept-risk
openclaw gateway start --daemon
openclaw gateway status
（三）Linux部署（Ubuntu/CentOS）
Ubuntu/Debian
# 安装依赖
sudo apt update && sudo apt install -y nodejs npm git
# 升级Node.js至22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt install -y nodejs
# 安装OpenClaw
curl -fsSL https://clawd.org.cn/install.sh | bash
CentOS/RHEL
# 安装Node.js 22
curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
sudo yum install -y nodejs
# 安装OpenClaw
curl -fsSL https://clawd.org.cn/install.sh | bash
（四）本地部署通用启动与验证
# 通用初始化
openclaw init --non-interactive --accept-risk
# 后台启动
openclaw gateway start --daemon
# 状态检查
openclaw gateway status
# 访问控制台
# 本地：http://localhost:18789
# 远程：http://本地IP:18789
（五）本地部署避坑指南（全平台通用）
- Windows权限不足：报错“权限被拒绝”。避坑：必须管理员身份运行PowerShell。
- 端口18789被占用：启动报错“port in use”。避坑：
- Windows：
netstat -ano | findstr :18789→taskkill /F /PID 进程ID - Mac/Linux：
lsof -i :18789→kill -9 进程ID
- Windows：
- Node.js版本过低：<22.0.0导致安装失败。避坑：强制安装v22+。
- 网络下载失败：安装卡住。避坑：使用国内镜像脚本、关闭VPN。
- MacOS缺少命令行工具：报错“xcode-select error”。避坑：安装：
xcode-select --install。 - Linux权限问题：
EACCES报错。避坑：命令前加sudo。
六、阿里云千问Qwen大模型API配置（高性能首选）
（一）命令行配置（全平台通用，直接复制）
# 配置百炼基础URL（海外地域用intl，内地用dashscope）
openclaw config set models.providers.bailian.baseUrl "https://dashscope-intl.aliyuncs.com/compatible-mode/v1"
# 填入千问API Key（sk-开头）
openclaw config set models.providers.bailian.apiKey "你的千问Qwen API Key"
# 支持模型列表（2026最新版）
openclaw config set models.providers.bailian.models '["qwen3.6-plus","qwen3-max-2026","qwen3-turbo-2026"]'
# 设置默认模型为Qwen3.6-Plus
openclaw config set models.default.model "bailian/qwen3.6-plus"
# 模型参数配置
openclaw config set models.providers.bailian.maxTokens 8192
openclaw config set models.providers.bailian.temperature 0.7
openclaw config set models.providers.bailian.reasoning true # 开启思考模式
# 重启服务生效
openclaw gateway restart
# 测试连接（正常回复即成功）
openclaw chat "介绍一下千问Qwen3.6-Plus的优势"
（二）Web控制台可视化配置
- 登录OpenClaw Web控制台→Settings→Models→Add Model。
- 选择阿里云百炼，填写：
- API Key：你的
sk-xxxx密钥 - Base URL：海外
https://dashscope-intl.aliyuncs.com/compatible-mode/v1 - 模型：
qwen3.6-plus - maxTokens：8192
- temperature：0.7
- reasoning：true
- API Key：你的
- 点击Test Connection→Save→设为默认模型→重启服务。
七、免费Coding Plan API配置（低成本备用）
（一）命令行配置（直接复制）
# Coding Plan专用BaseURL
openclaw config set models.providers.coding-plan.baseUrl "https://coding.dashscope.aliyuncs.com/v1"
# 填入Coding Plan API Key（sk-sp-开头）
openclaw config set models.providers.coding-plan.apiKey "你的Coding Plan API Key"
# 支持免费模型
openclaw config set models.providers.coding-plan.models '["coding-free","qwen3-coder-plus"]'
# 设置默认模型
openclaw config set models.default.model "coding-plan/coding-free"
# 关键：Coding Plan必须关闭思考模式（否则回复为空）
openclaw config set models.providers.coding-plan.reasoning false
# 重启生效
openclaw gateway restart
# 测试免费模型
openclaw chat "写一个Python冒泡排序代码"
（二）Coding Plan配置避坑
- 密钥混淆：千问（sk-）与Coding Plan（sk-sp-）混用。避坑：严格区分前缀。
- 思考模式未关：
reasoning true导致无回复。避坑：强制设为false。 - 额度用尽：免费额度用完调用失败。避坑：百炼平台查看额度，切换模型。
- BaseURL错误：用千问URL导致连接失败。避坑：使用
coding.dashscope专属域名。
八、OpenClaw基础运维命令（全平台通用，新手必备）
# 查看服务状态
openclaw gateway status
# 实时查看日志（排查错误）
openclaw logs -f
# 测试模型连接
openclaw model test
# 系统健康检查（自动排错）
openclaw doctor
# 重启/停止服务
openclaw gateway restart
openclaw gateway stop
# 重置配置
openclaw config reload
# 生成新管理员Token
openclaw token generate --admin
# 安装常用技能
clawhub install search document-parser summarize code-generator translator
# 查看已安装技能
clawhub list
# 更新OpenClaw至最新版
npm update -g openclaw --registry=https://registry.npmmirror.com/
# 卸载旧版本（冲突时）
npm uninstall -g clawdbot moltbot openclaw
九、常见问题解答（FAQ，全覆盖）
1. Web控制台无法访问（连接超时/拒绝）
- 原因：端口未放行、服务未启动、IP/Token错误。
- 解决：核对18789端口放行；执行
openclaw gateway start --daemon；检查IP与Token。
2. 模型调用失败，提示API Key无效
- 原因：密钥错误/含空格/过期、地域不匹配、未实名/欠费。
- 解决：重新复制密钥（无空格）；核对BaseURL与地域；检查账号状态。
3. 服务启动后立即停止
- 原因：内存不足、端口占用、依赖缺失。
- 解决：升级至4GB+内存；释放18789端口；重新执行
openclaw init。
4. Windows安装报错“执行策略禁止”
- 解决：管理员PowerShell执行
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force。
5. 本地部署外网无法访问
- 原因：本地防火墙拦截、路由器未端口映射。
- 解决：关闭本地防火墙；路由器设置18789端口映射至本地IP。
6. 模型响应慢/超时
- 原因：带宽不足、服务器地域过远、模型参数过高。
- 解决：升级带宽；选择近地域服务器；降低maxTokens至4096。
7. 命令行提示openclaw: command not found
- 原因：npm全局路径未加入系统PATH。
- 解决：
- Windows：手动添加
C:\Users\用户名\AppData\Roaming\npm到环境变量。 - Mac/Linux：
echo 'export PATH=$(npm config get prefix)/bin:$PATH' >> ~/.zshrc && source ~/.zshrc。
- Windows：手动添加
8. 服务器重启后服务失效
- 解决：设置开机自启（前文命令），或手动执行
openclaw gateway start --daemon。
十、总结
2026年，OpenClaw已实现云端（计算巢/轻量服务器）+本地（三系统）全场景部署覆盖，阿里云计算巢提供零代码一键部署方案，轻量服务器提供稳定高性价比运行环境，本地部署满足隐私与离线需求。搭配阿里云千问Qwen3.6-Plus高性能API与Coding Plan免费API，形成“主力+备用”的双模型方案，兼顾性能与成本，全面满足个人与小型团队的AI使用需求。
本文完整覆盖从部署前准备、云端双方案部署、本地三系统部署、大模型双API配置、全平台运维、避坑指南、问题排查的全流程，所有步骤均为2026年4月最新实践，命令可直接复制、步骤细致无门槛，新手可按文操作，1小时内完成全流程落地。遵循“选对海外地域、放通核心端口、准确配置密钥、后台启动服务、及时排查错误”五大原则，即可实现OpenClaw 7×24小时稳定运行，快速搭建专属AI助理，高效完成内容创作、代码编写、信息查询、文档处理等各类任务，让AI技术真正落地为日常生产力工具。
