2026年,OpenClaw(原Clawdbot)凭借“本地优先、数据可控、全场景自动化”的核心优势,成为个人与团队搭建AI助手的首选框架。无需深厚技术背景,通过阿里云计算巢可实现5分钟一键云端部署,本地也能快速适配MacOS、Linux、Windows11三大系统,配合阿里云千问或免费Coding Plan大模型API,即可拥有7×24小时在线的智能自动化助手。本文基于2026年最新版本,从计算巢部署、本地多系统安装、大模型API配置到常见问题排查,全程提供可直接复制的代码命令,零基础用户也能轻松完成全流程搭建。
一、OpenClaw核心价值与部署前准备
1.1 OpenClaw核心优势
OpenClaw是一款开源的AI代理自动化框架,区别于传统云端AI工具,核心优势集中在三大维度:
- 数据安全可控:所有对话记录、任务数据、配置文件均存储在本地或自有阿里云服务器,无需上传第三方平台,彻底解决隐私泄露风险;
- 跨平台无缝适配:支持阿里云云端7×24小时稳定运行,同时兼容MacOS、Linux、Windows11本地部署,多端数据可同步,满足不同场景需求;
- 功能灵活扩展:内置文件管理、代码生成、系统监控、消息推送等基础技能,可通过插件扩展浏览器控制、语音交互、跨平台协作等复杂能力;
- 大模型兼容友好:完美适配阿里云千问系列大模型,同时支持百炼Coding Plan免费API,零成本即可启用AI核心能力。阿里云部署 OpenClaw 只需两步,全网最简单,步骤流程 访问阿里云OpenClaw一键部署专题页面 了解。

1.2 部署前必备准备
1.2.1 阿里云账号与权限
- 注册阿里云账号并完成个人实名认证(企业用户需企业认证),未实名无法创建计算巢实例与获取大模型API密钥;
- 访问登录阿里云百炼大模型服务平台,新用户可领取计算巢短期试用额度与百炼大模型免费调用额度,满足初期测试需求;
- 确保账号无欠费、无异常锁定,开通计算巢、弹性计算、百炼大模型服务权限。
1.2.2 资源配置要求
- 云端(阿里云):新手推荐2核4GiB内存+40GiB ESSD云盘,内存低于2GiB会导致服务启动失败、频繁崩溃;地域优先选中国香港、新加坡、美国弗吉尼亚,无需ICP备案,联网搜索功能不受限;
- 本地(个人设备):MacOS(10.15及以上)、Linux(Ubuntu20.04+/CentOS7+)、Windows11(64位专业版),内存≥4GiB,存储空间≥20GiB;
- 核心依赖:Node.js v22及以上版本(OpenClaw 2026稳定版强制要求)、Git工具。
1.2.3 大模型API密钥(二选一)
- 阿里云千问大模型API:访问登录阿里云百炼大模型服务平台,进入“密钥管理”创建API Key(sk-开头),新用户享90天免费额度;
- 免费Coding Plan API:百炼平台开通Coding Plan免费套餐,生成专属API Key(sk-sp-开头),支持Qwen3.5 Plus等多模型免费调用。
二、2026阿里云计算巢部署OpenClaw(零基础零代码,5分钟完成)
阿里云计算巢针对OpenClaw推出专属预装镜像,自动集成Node.js 22、Docker、依赖组件与运行环境,全程无需手动配置、无需编写代码,是长期稳定运行的首选方案。
2.1 计算巢实例创建(零代码核心步骤)
登录阿里云控制台,访问阿里云计算巢OpenClaw社区版部署页面,在应用市场搜索“OpenClaw(原Clawdbot)”,选择官方社区版稳定镜像(认准发布者为OpenClaw官方社区,避免第三方修改版);

进入部署配置页面,按以下参数填写(新手直接照抄,无需修改):
- 服务实例名称:自定义(如OpenClaw-2026,英文字母开头,可含数字、短划线);
- 地域:中国香港、新加坡或美国弗吉尼亚(内地地域访问大模型API受限,必避坑);
- 实例规格:2核4GiB内存、40GiB ESSD系统盘(最低配置,不可更低);
- 镜像:应用镜像→OpenClaw 2026稳定版(预装所有依赖);
- 网络配置:保持默认,系统自动分配公网IP与专有网络;
- 登录密码:设置包含字母、数字、特殊符号的高强度密码(务必牢记);

- 确认配置无误,点击立即购买,完成支付后等待实例状态变为运行中(约3-5分钟)。
2.2 端口放行与基础配置
- 实例运行后,进入应用详情页面,找到“端口放通”模块,点击一键放通,开放18789端口(OpenClaw核心访问端口);
- 执行初始化命令(通过Workbench远程连接服务器,或计算巢内置终端):
# 查看OpenClaw服务状态
sudo systemctl status openclaw-gateway
# 设置开机自启(必选,确保服务器重启后自动运行)
sudo systemctl enable openclaw-gateway
# 启动服务(若未自动启动)
sudo systemctl start openclaw-gateway
- 生成访问令牌(保障Web UI安全):
# 生成随机安全令牌(替换为自定义字符串也可)
openclaw config set gateway.auth.mode token
openclaw config set gateway.auth.token "你的自定义安全令牌(如OpenClaw@2026)"
# 重启服务生效
sudo systemctl restart openclaw-gateway
2.3 访问验证
在浏览器输入:http://阿里云公网IP:18789,输入刚才设置的安全令牌,即可进入OpenClaw Web UI管理面板。
零基础部署 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 的地址。


三、本地全平台部署OpenClaw(MacOS/Linux/Windows11)
本地部署适合个人日常使用、敏感数据处理、开发调试,所有数据存储在本地设备,零服务器成本。
3.1 MacOS本地部署(终端操作)
# 1. 安装Homebrew(未安装时执行,国内镜像加速)
/bin/bash -c "$(curl -fsSL https://mirrors.ustc.edu.cn/git/homebrew/install/HEAD/install.sh)"
# 2. 安装Node.js v22(强制要求版本≥22)
brew install node@22
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# 验证Node.js版本
node -v # 输出v22.x.x即为正常
# 3. 配置npm国内镜像(加速安装)
npm config set registry https://registry.npmmirror.com
# 4. 全局安装OpenClaw最新版
npm install -g openclaw@latest
# 5. 初始化配置(新手按提示选择)
openclaw onboard
# 风险提示:输入Yes
# 模式选择:QuickStart(快速启动)
# 模型配置:暂时跳过(后续统一配置)
# 渠道绑定:Skip for now
# 技能配置:No
# 6. 启动网关服务
openclaw gateway start
# 7. 设置开机自启(可选)
sudo openclaw gateway install
# 8. 访问Web UI
openclaw dashboard
- 访问地址:
http://localhost:18789 - 避坑:Mac提示“应用已损坏”,执行命令解除限制:
sudo xattr -rd com.apple.quarantine /Applications/OpenClaw.app
3.2 Linux(Ubuntu)本地部署
# 1. 安装Node.js v22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs git
# 验证版本
node -v
# 2. 配置npm镜像
npm config set registry https://registry.npmmirror.com
# 3. 安装OpenClaw
npm install -g openclaw@latest
# 4. 初始化
openclaw init --sandbox enable --workdir ~/.openclaw
# 5. 启动服务
openclaw gateway start
# 6. 开机自启
openclaw config set gateway.autoStart true
- 访问地址:
http://localhost:18789
3.3 Windows11本地部署(管理员PowerShell)
必须以管理员身份运行PowerShell,否则权限不足导致安装失败。
# 1. 解锁脚本执行权限(首次执行)
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
# 2. 安装Node.js、Git(winget一键安装)
winget install OpenJS.NodeJS --version 22.14.0 -y
winget install Git.Git -y
# 重启PowerShell生效,验证版本
node -v
git --version
# 3. 配置npm国内镜像
npm config set registry https://registry.npmmirror.com
# 4. 全局安装OpenClaw
npm install -g openclaw@latest
# 5. 初始化配置
openclaw onboard
# 按提示:Yes → QuickStart → 跳过模型 → 跳过渠道 → No技能
# 6. 启动服务
openclaw gateway start
# 7. 访问Web UI
Start-Process "http://localhost:18789"
- 避坑:安装路径禁止含中文字符,否则服务闪退;优先使用WSL2部署,兼容性更佳。
四、阿里云千问大模型API配置(稳定高效首选)
4.1 获取千问API Key
- 登录阿里云百炼大模型平台,进入密钥管理页面;
- 点击创建API Key,生成密钥(格式:sk-xxxxxx),仅显示一次,务必妥善保存;
- 确认已开通通义千问3.5 Plus模型权限(新用户默认开通,享免费额度)。
4.2 命令行配置(全平台通用,推荐)
# 1. 设置主模型为千问3.5 Plus
openclaw config set agents.defaults.model.primary "dashscope-api/qwen3.5-plus"
# 2. 配置千问API Key(替换为你的密钥)
openclaw config set providers.dashscope-api.apikey "sk-你的千问API Key"
# 3. 配置千问Base URL(华北2北京地域,其他地域见下方)
openclaw config set providers.dashscope-api.baseurl "https://dashscope.aliyuncs.com/compatible-mode/v1"
# 其他地域Base URL:
# 新加坡:https://dashscope-intl.aliyuncs.com/compatible-mode/v1
# 美国弗吉尼亚:https://dashscope-us.aliyuncs.com/compatible-mode/v1
# 4. 重启网关使配置生效
openclaw gateway restart
# 5. 验证配置(输出正常回复即为成功)
openclaw chat "介绍一下OpenClaw的核心功能"
4.3 配置文件写入(备用)
编辑~/.openclaw/openclaw.json(Windows路径:C:\Users\你的用户名.openclaw\openclaw.json):
{
"models": {
"mode": "merge",
"providers": {
"dashscope-api": {
"baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
"apiKey": "sk-你的千问API Key",
"api": "openai-completions",
"models": [
{
"id": "qwen3.5-plus",
"name": "通义千问3.5 Plus",
"contextWindow": 1000000,
"maxTokens": 65536
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "dashscope-api/qwen3.5-plus"
}
}
}
}
重启服务生效:openclaw gateway restart。
五、阿里云百炼Coding Plan免费大模型API配置(零成本)
5.1 获取免费API Key
- 登录阿里云百炼平台,进入Coding Plan专区,点击开通免费套餐;
- 在“我的订阅”→“API密钥管理”,点击创建API-Key,生成专属密钥(格式:sk-sp-xxxxxx);
- 记录固定Base URL:
https://coding.dashscope.aliyuncs.com/v1。
5.2 配置与生效
# 1. 配置Coding Plan提供商
openclaw config set providers.coding-plan.baseurl "https://coding.dashscope.aliyuncs.com/v1"
openclaw config set providers.coding-plan.apikey "你的sk-sp-xxx API Key"
# 2. 设置默认模型
openclaw config set agents.defaults.model.primary "coding-plan/qwen3.5-plus"
# 3. 重启服务
openclaw gateway restart
# 4. 测试调用
openclaw chat "用Python写一个读取Excel文件的脚本"
- 配置文件参考(直接复制替换):
{ "models": { "mode": "merge", "providers": { "coding-plan": { "baseUrl": "https://coding.dashscope.aliyuncs.com/v1", "apiKey": "你的sk-sp-xxx", "api": "openai-completions", "models": [ { "id": "qwen3.5-plus", "name": "Qwen3.5 Plus(免费)", "contextWindow": 1000000, "maxTokens": 4096 } ] } } }, "agents": { "defaults": { "model": { "primary": "coding-plan/qwen3.5-plus" } } } }
六、核心功能常用命令(日常运维必备)
6.1 服务管理命令
# 查看服务状态
openclaw gateway status
# 启动/停止/重启服务
openclaw gateway start
openclaw gateway stop
openclaw gateway restart
# 查看实时日志(排查问题必备)
openclaw logs --follow --gateway
# 一键诊断系统状态
openclaw status --all
# 自动修复常见配置问题
openclaw doctor
6.2 Agent与技能管理
# 创建自定义Agent(示例:个人秘书)
openclaw agents add \
--name "secretary" \
--alias "智能秘书" \
--role "日程管理、邮件处理、待办提醒、文档汇总" \
--model "coding-plan/qwen3.5-plus" \
--description "语言简洁,高效执行任务"
# 查看所有Agent
openclaw agents list
# 安装常用技能
openclaw plugins install file-manager code-generator system-monitor
# 查看已安装技能
openclaw plugins list
6.3 定时任务配置
# 添加每日18点汇总任务
openclaw cron add \
--name "daily-report" \
--schedule "0 18 * * *" \
--command "调用secretary,汇总今日工作完成情况,生成报告"
# 启动定时任务
openclaw cron start daily-report
七、常见问题解答(新手必看)
7.1 部署与启动问题
服务启动失败,提示“port 18789 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
Node.js版本过低,提示“unsupported version”
- 解决:升级至v22及以上,Linux/Mac用NodeSource脚本,Windows用winget更新。
Windows部署闪退/无响应
- 解决:以管理员身份运行PowerShell;安装路径全英文;改用WSL2部署。
7.2 模型调用问题
401授权错误,“invalid api key”
- 原因:API Key错误、格式不符、额度用尽;
- 解决:确认Key为千问(sk-)或Coding Plan(sk-sp-)专属;重新生成密钥;检查账号余额。
模型调用超时,“request timeout”
- 解决:阿里云服务器放行443端口;检查网络连通性;调整超时参数:
openclaw config set models.providers.coding-plan.timeout 30000 openclaw gateway restart
- 解决:阿里云服务器放行443端口;检查网络连通性;调整超时参数:
AI无响应,一直显示“思考中”
- 解决:查看网关日志定位错误;重启服务;重新配置API Key。
7.3 功能使用问题
无法执行文件/命令操作
- 原因:沙盒模式限制、权限不足;
- 解决:关闭沙盒模式(
openclaw config set sandbox.enabled false);以管理员身份启动服务。
Web UI加载缓慢/打不开
- 解决:清除浏览器缓存;检查服务器带宽;重启网关服务。
八、优化建议与最佳实践
8.1 性能优化
- 云端升级:复杂任务场景,将阿里云实例升级至4核8GiB内存,提升并发处理能力;
- 缓存启用:开启模型调用缓存,减少重复请求:
openclaw config set models.cache.enabled true; - 日志清理:启用日志轮转,避免日志占满磁盘:
openclaw config set logs.rotation.enabled true。
8.2 安全优化
- 权限最小化:本地部署避免在主力机安装,使用专用设备或虚拟机;
- 访问控制:云端仅开放必要端口,启用令牌认证,禁止公网无密码访问;
- 定期更新:及时升级OpenClaw版本,修复安全漏洞:
npm update -g openclaw。
8.3 效率提升
- 配置备份:定期备份
~/.openclaw/目录,防止配置丢失; - 技能精简:仅安装业务所需技能,减少资源占用;
- 角色细分:为不同场景创建专属Agent(开发、办公、运维),提升响应专业性。
九、总结
2026年OpenClaw的部署门槛已大幅降低,阿里云计算巢实现零基础零代码一键云端部署,本地三大系统也能通过简单命令快速搭建,配合阿里云千问或免费Coding Plan大模型,个人与团队均可快速拥有专属AI自动化助手。
本文覆盖从准备、部署、配置到排查的全流程,所有代码可直接复制执行,核心在于把握“数据安全+稳定运行+灵活扩展”三大原则。无论是个人提升效率,还是团队实现自动化协作,OpenClaw都能提供可靠支撑,随着技能生态的完善,将成为AI时代不可或缺的生产力工具。