2026年,开源AI智能体框架OpenClaw(曾用名Clawdbot)凭借轻量化架构、多平台适配与强大任务执行能力,成为个人与团队搭建专属AI助手的首选方案。它能实现自然语言指令到自动化任务的完整闭环,覆盖日常办公、消息处理、跨平台协同等多元场景。
本文完整覆盖2026年阿里云轻量服务器部署及本地MacOS/Linux/Windows11部署OpenClaw(Clawdbot)步骤流程及阿里云千问大模型API配置或市场上免费大模型Coding Plan API配置及常见问题解答,从阿里云无影云电脑一键部署,到本地三大操作系统全流程搭建,再到阿里云千问与免费Coding Plan大模型API对接,全程提供可直接复制的代码命令、可视化操作指引与高频问题解决方案,确保零基础用户一次部署成功、稳定运行。阿里云部署 OpenClaw 全网最简单,只需两步,详情 访问阿里云OpenClaw一键部署专题页面 了解。



一、部署前核心准备(全平台通用,必做清单)
1.1 核心组件认知
- OpenClaw:AI智能体中枢,负责接收指令、调度大模型、执行自动化任务、反馈结果,支持7×24小时在线与技能扩展。
- 阿里云无影云电脑:云端桌面服务,预装OpenClaw专属镜像,无需本地配置,一键部署、即开即用,适合长期稳定运行。
- 阿里云千问大模型:阿里云百炼旗舰模型,支持Qwen3.6-Plus、Qwen3-Max等,具备超长上下文、强推理与工具调用能力。
- Coding Plan:阿里云百炼推出的免费/低价API套餐,个人用户每月可享免费额度,适配OpenClaw基础场景。
- 本地部署环境:MacOS(推荐M系列芯片)、Linux(Ubuntu/CentOS)、Windows11(WSL2优先),满足离线与自定义需求。
1.2 账号与环境要求
- 阿里云账号:完成实名认证,开通无影云电脑、百炼大模型服务,新用户可领免费试用额度。
- 本地环境:
- MacOS:12及以上版本,推荐16GB+内存
- Linux:Ubuntu 22.04/CentOS 7及以上,2核4GB+内存
- Windows11:专业版/家庭版,开启WSL2(Ubuntu 22.04),4GB+内存
- 必备工具:终端(Mac/Linux)、PowerShell(Windows,管理员)、文本编辑器(保存API密钥、Token)。
1.3 关键信息预准备
- 无影云电脑/本地设备公网/内网IP
- 阿里云百炼千问API Key(sk-)、Coding Plan API Key(sk-sp-)
- OpenClaw管理员Token/Web控制台密码
- 模型对应Base URL(千问与Coding Plan不通用)
二、阿里云无影云电脑部署OpenClaw(新手极简,10分钟完成)
2.1 无影云电脑实例创建(一键部署)
- 登录阿里云控制台,访问阿里云无影云电脑OpenClaw一键部署专题页。
- 实例配置:
- 规格:2核4GB+80GB ESSD(最低稳定配置,多技能并发无压力)
- 镜像:选择OpenClaw(Clawdbot) 2026官方专属镜像(预装Node.js 22、Git、OpenClaw核心程序)
- 地域:中国香港/新加坡(免备案,网络稳定,适配大模型API)
- 时长:按需选择(新用户低至9.9元/月)
- 网络与登录:分配公网IP,设置登录密码,确认订单后等待5-10分钟,实例状态变为「运行中」。
- 下载无影云电脑客户端(支持Mac/Windows),登录并连接至创建的云电脑实例。


2.2 无影云电脑OpenClaw初始化配置
# 1. 打开云电脑终端,验证基础环境(Node.js≥22,OpenClaw≥2026.03)
node -v
openclaw --version
# 旧版本兼容命令:clawdbot --version
# 2. 配置npm国内镜像(加速依赖安装,必做)
npm config set registry https://registry.npmmirror.com/
# 3. 一键初始化OpenClaw(非交互式,自动配置)
openclaw init --non-interactive --accept-risk --enable-skill-market
# 4. 安装为系统服务(开机自启、异常自动重启)
openclaw gateway install
# 5. 后台启动服务(守护进程模式,长期运行)
openclaw gateway start --daemon
# 6. 验证服务状态(显示active(running)即为成功)
openclaw gateway status
# 7. 生成管理员Token(复制保存,Web控制台登录凭证)
openclaw token generate --admin
2.3 Web控制台访问与功能测试
- 云电脑内浏览器访问:
http://localhost:18789;本地访问:http://云电脑公网IP:18789。 - 粘贴管理员Token登录,进入OpenClaw中文控制台。
- 测试指令:“创建一个名为‘无影云部署测试’的文本文件,内容为‘OpenClaw部署成功’”,系统自动执行并反馈路径,说明部署成功。
2.4 无影云部署避坑指南
坑1:云电脑创建失败(地域无资源/权限不足)
- 原因:所选地域资源售罄、账号未实名认证、ECS配额不足。
- 解决方案:切换至中国香港/新加坡地域;完成实名认证;在阿里云配额中心提升ECS实例配额。
坑2:Web控制台无法访问(端口未放行)
- 原因:无影云安全组未放行18789端口、防火墙拦截。
- 解决方案:
```bash云电脑终端放行端口
firewall-cmd --add-port=18789/tcp --permanent
firewall-cmd --reload
阿里云控制台放行:实例→安全组→添加TCP 18789规则
#### 坑3:服务启动失败(内存不足/版本过低)
- **原因**:实例规格低于2核2GB、Node.js版本<22。
- **解决方案**:升级至2核4GB及以上;升级Node.js:
```bash
npm install -g n && n stable
node -v # 验证≥22.0.0
坑4:命令提示“openclaw: command not found”
- 原因:环境变量未生效。
- 解决方案:
echo 'export PATH="$PATH:$(npm prefix -g)/bin"' >> ~/.bashrc source ~/.bashrc openclaw --version零基础部署 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 的地址。


三、本地MacOS部署OpenClaw(低功耗稳定,M系列最优)
3.1 环境准备与依赖安装
# 1. 安装Homebrew(Mac包管理器,已安装可跳过)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 2. 安装Node.js 22(OpenClaw强制要求)
brew install node@22
# 3. 配置Node.js环境变量
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# 4. 验证版本
node -v # 应≥v22.0.0
npm -v
3.2 OpenClaw一键安装与启动
# 1. 官方一键安装脚本(自动配置所有依赖)
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
# 2. 初始化OpenClaw(交互式向导,新手选QuickStart)
openclaw onboard
# 按提示操作:确认风险→选择本地网关→暂不配置渠道→启用基础技能
# 3. 安装守护进程(开机自启)
openclaw gateway install
# 4. 后台启动服务
openclaw gateway start --daemon
# 5. 验证服务状态
openclaw gateway status
# 6. 优化:禁用Mac睡眠(长期运行必备)
sudo pmset -a sleep 0 displaysleep 0 disksleep 0
caffeinate -d -i -s & # 保持系统唤醒
3.3 访问与测试
- 本地访问:
http://localhost:18789 - 测试指令:“查询今日天气”,验证AI响应与任务执行能力
四、本地Linux部署OpenClaw(服务器首选,稳定高效)
4.1 环境准备(以Ubuntu 22.04为例)
# 1. 系统更新
sudo apt update && sudo apt upgrade -y
# 2. 安装依赖
sudo apt install -y nodejs npm git curl
# 3. 升级Node.js至22(Ubuntu默认版本较低)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt install -y nodejs
# 4. 验证版本
node -v
npm -v
4.2 OpenClaw安装与配置
# 1. 一键安装
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
# 2. 初始化配置
openclaw init --non-interactive --accept-risk
# 3. 安装系统服务
sudo openclaw gateway install
# 4. 启动服务
sudo openclaw gateway start --daemon
# 5. 放行防火墙端口(服务器必做)
sudo ufw allow 18789/tcp
sudo ufw reload
# 6. 查看服务日志(排查问题)
openclaw logs --tail 100 -f
五、本地Windows11部署OpenClaw(WSL2优先,原生兼容差)
5.1 环境准备(WSL2 Ubuntu 22.04)
- 开启WSL2:设置→系统→开发者选项→开启「开发人员模式」;控制面板→程序→启用或关闭Windows功能→勾选「适用于Linux的Windows子系统」与「虚拟机平台」。
- 安装Ubuntu 22.04(Microsoft Store搜索安装)。
- 以管理员身份打开PowerShell,执行:
# 安装WSL2并设置默认版本 wsl --install -d Ubuntu-22.04 wsl --set-default-version 2
5.2 WSL2内OpenClaw部署(同Linux步骤)
# 进入WSL2 Ubuntu终端,执行以下命令
sudo apt update && sudo apt upgrade -y
sudo apt install -y nodejs npm git curl
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt install -y nodejs
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
openclaw init --non-interactive --accept-risk
sudo openclaw gateway install
sudo openclaw gateway start --daemon
sudo ufw allow 18789/tcp
5.3 原生Windows11部署(不推荐,仅备用)
# 以管理员身份运行PowerShell
# 1. 允许脚本执行
Set-ExecutionPolicy Bypass -Scope Process -Force
# 2. 安装Node.js与Git
winget install OpenJS.NodeJS.LTS -y
winget install Git.Git -y
# 3. 配置npm镜像
npm config set registry https://registry.npmmirror.com/
# 4. 安装OpenClaw
npm install -g openclaw@latest
# 5. 初始化
openclaw onboard
# 6. 启动服务
openclaw gateway start
六、阿里云千问大模型API配置(企业级,强智能)
6.1 获取千问API密钥
- 访问登录阿里云百炼大模型服务平台,完成实名认证。
- 进入「密钥管理」→「创建API Key」,复制生成的sk-开头密钥(仅显示一次)。
- 记录Base URL:
- 国内节点:
https://dashscope.aliyuncs.com/compatible-mode/v1 - 国际节点:
https://dashscope-intl.aliyuncs.com/compatible-mode/v1
- 国内节点:
6.2 OpenClaw命令行配置(推荐)
# 1. 设置默认模型为千问Qwen3.6-Plus
openclaw config set agents.defaults.model.primary "dashscope-api/qwen3.6-plus"
# 2. 配置API Key(替换为你的密钥)
openclaw config set providers.dashscope-api.apikey "sk-你的千问API Key"
# 3. 配置Base URL
openclaw config set providers.dashscope-api.baseurl "https://dashscope.aliyuncs.com/compatible-mode/v1"
# 4. 优化模型参数(提升准确性)
openclaw config set agents.defaults.model.parameters.temperature 0.3
openclaw config set agents.defaults.model.parameters.maxTokens 8192
openclaw config set agents.defaults.model.parameters.reasoning false # 必关,否则回复为空
# 5. 重启服务生效
openclaw gateway restart
# 6. 测试连接(成功提示Model connection successful)
openclaw model test
6.3 Web控制台配置(可视化)
- 登录OpenClaw控制台→「模型设置」→「添加模型」。
- 选择「阿里云百炼(DashScope)」,填入API Key、Base URL,选择Qwen3.6-Plus。
- 保存配置,重启服务,发送测试指令验证。
七、免费Coding Plan API配置(个人首选,低成本)
7.1 获取Coding Plan密钥
- 访问登录阿里云百炼大模型服务平台,进入「Coding Plan」,订阅Lite免费版(每月18000次免费请求)。
- 生成并复制sk-sp-开头API Key(与千问密钥不通用)。
- 专用Base URL:
https://coding.dashscope.aliyuncs.com/v1。
7.2 OpenClaw配置步骤
# 1. 设置Coding Plan模型
openclaw config set agents.defaults.model.primary "bailian-coding/qwen3-coder"
# 2. 配置专属密钥与地址
openclaw config set providers.bailian-coding.apikey "sk-sp-你的Coding Plan Key"
openclaw config set providers.bailian-coding.baseurl "https://coding.dashscope.aliyuncs.com/v1"
# 3. 参数优化
openclaw config set agents.defaults.model.parameters.temperature 0.2
openclaw config set agents.defaults.model.parameters.maxTokens 4096
# 4. 重启服务并测试
openclaw gateway restart
openclaw model test
八、全平台部署常见问题与解决方案(高频汇总)
8.1 服务启动类问题
问题1:端口18789被占用
- 表现:启动报错「Port 18789 is already in use」
- 解决:
# 查找占用进程
lsof -i :18789 # Mac/Linux
netstat -ano | findstr :18789 # Windows
# 结束进程
kill -9 进程ID # Mac/Linux
taskkill /F /PID 进程ID # Windows
# 或修改端口
openclaw config set gateway.port 18790
openclaw gateway restart
问题2:服务启动失败,提示权限不足
- 解决:以管理员/root身份运行;修正目录权限:
sudo chown -R $USER:$USER ~/.openclaw
sudo chmod -R 755 ~/.openclaw
8.2 大模型API类问题
问题1:模型调用失败,提示「API Key无效」
- 原因:密钥错误、千问与Coding Plan密钥混用、地域不匹配
- 解决:核对密钥类型;切换对应Base URL;重新生成密钥。
问题2:回复为空/无响应
- 原因:未关闭
reasoning参数、模型参数错误 - 解决:
openclaw config set agents.defaults.model.parameters.reasoning false
openclaw gateway restart
问题3:调用频繁被限流
- 解决:降低请求频率;升级Coding Plan套餐;
openclaw config set agents.defaults.model.rateLimit 1 openclaw gateway restart
8.3 本地部署类问题
问题1:Mac/Linux安装卡住(网络问题)
- 解决:切换npm镜像;使用代理;手动下载安装包。
问题2:Windows WSL2无法访问Web控制台
- 解决:放行WSL防火墙;确认端口转发;使用
localhost访问。
问题3:本地部署后外网无法访问
- 解决:路由器端口映射18789;配置公网IP;关闭本地防火墙。
九、总结
2026年,OpenClaw已实现全平台覆盖,无论是阿里云无影云电脑的一键云端部署,还是本地MacOS/Linux/Windows11的自定义搭建,都能满足不同用户的需求。搭配阿里云千问大模型的强智能能力,或Coding Plan的免费API,零基础用户也能快速搭建专属AI智能体,实现从简单对话到复杂任务执行的全能力覆盖。
本文完整覆盖2026年阿里云轻量服务器部署及本地MacOS/Linux/Windows11部署OpenClaw(Clawdbot)步骤流程及阿里云千问大模型API配置或市场上免费大模型Coding Plan API配置及常见问题解答,全流程提供可直接复制的代码命令、避坑指南与问题解决方案,确保用户一次部署成功、长期稳定运行。无论是个人日常效率提升,还是团队自动化办公,都能通过本教程快速落地,享受AI智能体带来的便捷体验。