OpenClaw(曾用名Clawdbot,昵称“小龙虾”)作为2026年热门的开源AI智能体平台,核心价值在于能将自然语言指令转化为实际操作,涵盖文件处理、程序控制、流程自动化等多种场景,无需用户具备编程基础。对于零基础用户而言,部署OpenClaw的核心需求的是“简单易操作、稳定可复用”,而阿里云部署可实现7×24小时稳定运行、多设备远程访问,本地部署则保障数据私有化,再结合QQ、企业微信接入,能让AI智能体融入日常沟通场景,大幅提升效率。
本文严格面向2026年零基础、零技术用户,整合全平台部署、免费API配置、社交平台对接三大核心内容,全程无营销词汇,所有代码命令可直接复制执行,不涉及复杂概念,同时补充新手高频问题解答,确保用户既能快速完成部署,也能顺利实现OpenClaw与QQ、企业微信的对接,真正发挥其自动化价值。文中明确包含2026年新手零基础阿里云/MacOS/Linux/Windows11本地部署OpenClaw(Clawdbot)步骤流程、免费大模型阿里云百炼API配置及常见问题解答,专注实用操作。阿里云上OpenClaw极速一键部署最简单,步骤详情 访问阿里云OpenClaw一键部署专题页面 了解。



一、核心认知:部署模式选择与前置准备
(一)部署模式对比(按需选择,零基础友好)
OpenClaw主要有阿里云部署和本地部署两种模式,两者各有优势,新手可根据自身需求灵活选择,无需盲目追求复杂配置,具体对比如下:
| 对比维度 | 阿里云部署 | 本地部署(Windows11/MacOS/Linux) |
|---|---|---|
| 核心优势 | 7×24小时稳定运行、多设备协同、公网访问、无需本地硬件支撑 | 数据私有化、零服务器成本、断网可用、操作更灵活 |
| 适用场景 | 团队协作、定时任务、远程访问、长期运行自动化流程 | 个人办公、敏感数据处理、离线使用、短期测试 |
| 硬件要求 | 无需本地硬件,阿里云服务器2vCPU+4GiB内存起步 | Windows11/MacOS12+/Linux(Ubuntu22.04+),内存≥4GB、可用空间≥10GB |
| 操作难度 | ⭐(一键部署,30分钟完成) | ⭐⭐(需配置本地环境,适合熟悉电脑基础操作的用户) |
| 网络要求 | 推荐阿里云中国香港地域(免备案,网络稳定) | 无公网IP要求,断网可执行基础操作 |
核心结论:新手优先选择阿里云部署,无需担心本地环境兼容问题,可实现长期稳定运行;若注重数据隐私、仅用于个人办公,可选择本地部署,兼顾便捷性与安全性。
(二)前置准备(必做,避免部署中断)
无论选择哪种部署模式,需提前准备以下内容,全程零技术门槛,按要求准备即可:
- 账号与凭证:
- 阿里云账号:注册阿里云账号 并完成实名认证(个人用户支付宝刷脸即可,企业用户需完成资质审核);
- 阿里云百炼API密钥:访问登录阿里云百炼大模型服务平台,开通服务后创建Access Key ID和Access Key Secret(仅创建时可完整查看Access Key Secret,务必复制保存至加密记事本,避免丢失);
- QQ/企业微信账号:若需对接社交平台,需准备对应账号(企业微信需管理员权限)。
- 辅助工具:
- 远程连接工具:FinalShell(新手首选,适配阿里云部署,用于远程操作服务器);
- 文本编辑器:VS Code或系统自带记事本(用于编辑配置文件);
- 基础终端工具:Windows11用PowerShell(管理员身份),MacOS/Linux用自带终端。
- 核心依赖(自动安装,无需手动配置):
- Node.js≥v22.0.0(OpenClaw运行核心依赖);
- Git(技能安装、配置同步依赖);
- Python≥3.9(部分技能与API对接依赖)。
二、2026年OpenClaw全平台部署流程(零基础抄作业)
(一)阿里云部署(极速版,推荐新手)
阿里云部署无需担心本地环境兼容问题,可实现7×24小时稳定运行,支持远程访问和多设备协同,新手30分钟可完成,全程代码可直接复制执行,步骤如下:
新手零基础阿里云上部署OpenClaw喂饭级步骤流程
第一步:打开访问阿里云OpenClaw一键部署专题页面,找到并点击【一键购买并部署】。




第二步:打开选购阿里云轻量应用服务器,配置参考如下:
- 镜像:OpenClaw(Moltbot)镜像(已经购买服务器的用户可以重置系统重新选择镜像)
- 实例:内存必须2GiB及以上。
- 地域:默认美国(弗吉尼亚),目前中国内地域(除香港)的轻量应用服务器,联网搜索功能受限。
- 时长:根据自己的需求及预算选择。



第三步:打开访问阿里云百炼大模型控制台,找到密钥管理,单击创建API-Key。

前往轻量应用服务器控制台,找到安装好OpenClaw的实例,进入「应用详情」放行18789端口、配置百炼API-Key、执行命令,生成访问OpenClaw的Token。
- 端口放通:需要放通对应端口的防火墙,单击一键放通即可。
- 配置百炼API-Key,单击一键配置,输入百炼的API-Key。单击执行命令,写入API-Key。
- 配置OpenClaw:单击执行命令,生成访问OpenClaw的Token。
- 访问控制页面:单击打开网站页面可进入OpenClaw对话页面。
1. 阿里云服务器选购与基础配置
服务器选购:
- 登录阿里云官网,访问阿里云轻量应用服务器控制台,点击“创建实例”;
- 地域选择:优先中国香港(免备案,网络稳定,避免国内地域备案繁琐流程);
- 镜像选择:系统镜像→Ubuntu 22.04 LTS(兼容性最佳,适配2026年OpenClaw最新版本);
- 实例规格:2vCPU+4GiB内存+40GiB ESSD(个人使用足够,多任务并发可选择4vCPU配置);
- 付费类型:按需付费(适合短期测试)或包年包月(适合长期运行,性价比更高);
- 设置root密码:设置强密码(含大小写字母+数字+特殊符号),牢记备用,用于远程连接;
- 提交订单,等待1-3分钟,实例状态变为“运行中”,记录服务器公网IP(后续用于访问和配置)。
端口放行(必须做,否则无法访问控制台):
- 进入服务器实例详情页,找到“防火墙”选项,点击“添加规则”;
- 依次放行以下端口,协议均选择TCP,授权对象均设置为“0.0.0.0/0”(允许所有设备访问):
- 22端口:用于远程连接服务器;
- 18789端口:OpenClaw Web控制台核心端口;
- 3000端口:QQ/企业微信对接回调端口。
远程连接服务器:
- 打开FinalShell,新建SSH连接;
- 配置连接信息:主机填写服务器公网IP,端口22,用户名root,密码为实例创建时设置的root密码;
- 点击“连接”,首次连接需确认“信任主机”,出现命令行界面即为连接成功。
2. OpenClaw一键安装与初始化
连接服务器后,复制以下命令,逐行执行,全程自动完成,无需手动干预:
# 1. 更新系统依赖,确保环境兼容
sudo apt update && sudo apt upgrade -y
# 2. 安装核心依赖(Node.js 22+、Git、Python3)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs git python3-pip
# 3. 配置npm国内镜像,加速OpenClaw安装
npm config set registry https://registry.npmmirror.com
# 4. 全局安装最新版OpenClaw
npm install -g openclaw@latest
# 5. 验证安装是否成功(显示版本号即为成功)
openclaw --version
# 6. 运行配置向导(交互式操作,按提示选择即可)
openclaw onboard
配置向导交互步骤(新手直接按以下提示操作,无需修改):
- 提示风险说明,输入Yes并回车;
- 选择模式,选择QuickStart(快速开始);
- 选择模型接入,暂时选择“Custom Provider”(后续配置阿里云百炼API);
- 网关绑定,选择lan(监听所有网络接口,支持多设备访问);
- 频道配置、技能配置、钩子(Hooks)均输入Skip,后续按需配置;
- 孵化方式,选择Open the Web UI(启动Web控制台)。
3. 启动服务与获取登录令牌
# 1. 启动OpenClaw网关服务
openclaw gateway start
# 2. 查看服务运行状态(显示running即为正常)
openclaw gateway status
# 3. 生成管理员访问令牌(复制保存,登录控制台需用)
openclaw token generate --admin
4. 部署验证
- 打开浏览器,输入
http://服务器公网IP:18789/?token=你生成的令牌,粘贴令牌后,能正常进入OpenClaw Web控制台,即为阿里云部署成功; - 补充:设置开机自启,避免服务器重启后服务中断,执行以下命令:
echo "openclaw gateway start" >> /etc/rc.d/rc.local chmod +x /etc/rc.d/rc.local
(二)本地部署(Windows11+MacOS+Linux,数据私有化)
本地部署适合注重数据隐私、仅用于个人办公的用户,三大系统步骤类似,全程一键操作,代码可直接复制,具体如下:
1. Windows11本地部署(办公场景适配)
系统要求:Windows11 64位、内存≥4GB(推荐8GB+)、可用空间≥10GB
# 1. 以管理员身份打开PowerShell(右键开始菜单,选择“Windows终端(管理员)”)
# 2. 解决执行策略限制,避免脚本无法运行
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force
# 3. 安装核心依赖(Node.js 22+、Python 3.9、Git)
winget install OpenJS.NodeJS.LTS --version 22.2.0
winget install Python.Python.3.9
winget install Git.Git
# 4. 配置npm国内镜像,加速安装
npm config set registry https://registry.npmmirror.com
# 5. 全局安装OpenClaw
npm install -g openclaw@latest
# 6. 运行配置向导(交互步骤参考阿里云部署)
openclaw onboard
# 7. 启动网关服务
openclaw gateway start
# 8. 获取访问令牌
openclaw token generate --admin
关键避坑点:
- 将
C:\Users\你的用户名\.openclaw添加到Windows Defender排除列表,避免被误判为病毒; - 若出现“权限不足”报错,执行
icacls %USERPROFILE%\.openclaw /grant:r 你的用户名:(F),赋予完全控制权限; - 访问方式:浏览器输入
http://localhost:18789/?token=你生成的令牌,即可登录控制台。
2. MacOS本地部署(体验最佳,推荐)
系统要求:MacOS 12+(M系列/Intel芯片)、内存≥8GB、可用空间≥10GB
# 1. 打开终端(Cmd + Space输入“Terminal”,回车打开)
# 2. 安装Homebrew(国内用户用镜像加速,避免下载缓慢)
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
# 3. 安装核心依赖(Node.js 22、Python 3.9、Git)
brew install node@22 python@3.9 git
# 4. 配置Node.js环境变量,确保全局可调用
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# 5. 全局安装OpenClaw
npm install -g openclaw@latest
# 6. 运行配置向导
openclaw onboard
# 7. 启动网关服务(后台运行,不占用终端)
nohup openclaw gateway start > ~/.openclaw/logs/gateway.log 2>&1 &
# 8. 获取访问令牌
openclaw token generate --admin
M系列芯片避坑点:
- 若安装依赖失败,执行
arch -arm64 brew install node@22,指定ARM架构安装,避免Rosetta 2转译兼容性问题; - 访问方式:浏览器输入
http://localhost:18789/?token=你生成的令牌,粘贴令牌登录。
3. Linux本地部署(Ubuntu 22.04 LTS,稳定性强)
系统要求:Ubuntu 22.04 LTS、内存≥4GB、可用空间≥10GB
# 1. 更新系统依赖
sudo apt update && sudo apt upgrade -y
# 2. 安装核心工具与依赖
sudo apt install curl git python3-pip -y
# 3. 安装Node.js 22+
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
# 4. 配置npm国内镜像
npm config set registry https://registry.npmmirror.com
# 5. 全局安装OpenClaw
npm install -g openclaw@latest
# 6. 运行配置向导
openclaw onboard
# 7. 启动网关服务并设置开机自启
sudo systemctl enable --now openclaw
openclaw gateway start
# 8. 获取访问令牌
openclaw token generate --admin
访问方式:浏览器输入 http://localhost:18789/?token=你生成的令牌,粘贴令牌即可登录控制台;若需局域网内其他设备访问,需放行18789端口(参考阿里云端口放行步骤)。
三、阿里云百炼免费API配置(核心步骤,零成本解锁智能)
OpenClaw默认仅提供基础指令解析能力,配置阿里云百炼API后,可大幅提升自然语言理解、复杂任务拆解与响应质量,新用户可领取90天免费额度,零成本解锁AI智能能力,全平台通用,步骤如下:
(一)API密钥获取步骤(新手必看)
- 登录阿里云官网,访问登录阿里云百炼大模型服务平台;
- 点击“开通服务”,阅读并同意服务协议,新用户自动领取90天免费额度(可在“费用管理”中查看额度使用情况);
- 进入“密钥管理”页面,点击“创建Access Key”,完成身份验证(短信或扫码验证)后,生成Access Key ID和Access Key Secret;
- 立即复制并保存密钥(Access Key Secret仅创建时可完整查看,丢失需重新创建,建议保存至加密记事本,避免泄露);
- 推荐操作:开启“消费限额”,进入“费用管理”→“消费限额”,设置每月最大消费额度,避免意外超额计费。
(二)OpenClaw对接阿里云百炼API(全环境通用)
复制以下命令,逐行执行,替换对应凭证即可,配置完成后重启网关生效:
# 1. 配置百炼API密钥(替换为你的Access Key ID和Secret)
openclaw config set models.providers.bailian.accessKeyId "你的Access Key ID"
openclaw config set models.providers.bailian.accessKeySecret "你的Access Key Secret"
# 2. 配置国内接口地址(降低调用延迟,国内部署必做)
openclaw config set models.providers.bailian.baseUrl "https://dashscope.aliyuncs.com/compatible-mode/v1"
# 3. 设置默认模型(推荐qwen3.5,免费额度足够使用,推理速度快)
openclaw config set models.default "qwen3.5"
# 4. 配置上下文窗口与超时时间(避免报错)
openclaw config set models.providers.bailian.models.0.contextWindow 32768
openclaw config set models.providers.bailian.timeout 60000
# 5. 重启网关,使配置生效(不同环境重启命令)
# 阿里云/Linux
openclaw gateway restart
# MacOS
pkill -f openclaw && nohup openclaw gateway start > ~/.openclaw/logs/gateway.log 2>&1 &
# Windows11(PowerShell)
openclaw gateway stop
openclaw gateway start
(三)API配置验证与避坑要点
- 验证方法:登录OpenClaw Web控制台,输入测试指令(如“帮我整理2026年Q2个人工作计划,分3条核心要点”),若返回结构化、符合要求的回复,即为配置成功;
- 避坑要点(新手高频错误):
- 密钥复制错误:逐字符核对Access Key ID与Secret,避免多余空格或换行,两者不可混淆;
- 接口地址错误:国内部署必须使用指定的国内接口地址,否则会出现调用超时、无法连接的问题;
- 服务未重启:配置完成后必须重启网关,否则配置不生效,这是新手最容易忽略的步骤;
- 免费额度耗尽:登录百炼控制台查看额度,若额度不足,可切换为qwen-turbo轻量模型,节省额度。
四、快速接入QQ/企业微信(核心扩展,融入日常沟通)
部署完成后,将OpenClaw接入QQ、企业微信,可实现“聊天发指令,AI做操作”,无需打开Web控制台,大幅提升使用便捷性,步骤简单,全程复制命令即可,适配所有部署模式(阿里云/本地)。
(一)接入企业微信(适合团队协作、客户管理)
1. 企业微信应用创建(需管理员权限)
- 登录企业微信管理后台,进入“应用管理”→“创建应用”;
- 填写应用名称(如“OpenClaw智能助手”)、上传图标,选择应用可见范围(按需设置);
- 应用创建完成后,记录下“AgentID”和“Secret”(在应用详情页查看);
- 进入应用详情页,找到“接收消息”→“设置API”,填写服务器URL(格式:http://你的IP:3000/webhook/wechatwork,阿里云部署填公网IP,本地部署填局域网IP);
- 随机生成Token和EncodingAESKey,记录保存,后续配置需用。
2. OpenClaw配置企业微信对接
# 1. 编辑OpenClaw配置文件(全环境通用)
# 阿里云/Linux/MacOS
nano ~/.openclaw/openclaw.json
# Windows11(PowerShell)
notepad %USERPROFILE%\.openclaw\openclaw.json
在配置文件中添加以下内容(替换为你的企业微信凭证):
{
"channels": {
"wechatwork": {
"enabled": true,
"corpId": "你的企业ID",
"agentId": "你的AgentID",
"secret": "你的Secret",
"token": "你的Token",
"encodingAESKey": "你的EncodingAESKey",
"webhookPath": "/webhook/wechatwork"
}
}
}
3. 生效与验证
# 重启网关,使配置生效
openclaw gateway restart
# 验证对接:在企业微信中给该应用发送消息(如“帮我查询当前时间”),AI能正常回复即为成功
(二)接入QQ(适合个人使用、社群运营)
QQ接入推荐使用OneBot协议(适合个人用户,操作简单,无需官方审核),步骤如下:
1. 安装go-cqhttp(OneBot协议依赖)
# 1. 安装go-cqhttp(不同系统命令不同)
# Linux
wget https://github.com/Mrs4s/go-cqhttp/releases/latest/download/go-cqhttp_linux_amd64.tar.gz
tar -xzf go-cqhttp_linux_amd64.tar.gz
# MacOS
brew install go-cqhttp
# Windows11
# 访问go-cqhttp官方页面,下载Windows版本,解压后双击运行
# 2. 初始化go-cqhttp配置
go-cqhttp
# 选择通信方式:输入3(反向WS),按提示完成初始化
2. 配置go-cqhttp(对接QQ)
编辑go-cqhttp的config.yml配置文件,修改以下核心内容:
account:
uin: 你的QQ号
password: '你的QQ密码'
servers:
- ws-reverse:
url: ws://127.0.0.1:3001/onebot
reverse: true
middlewares:<<: *default
3. OpenClaw配置QQ对接
# 1. 编辑OpenClaw配置文件
# 阿里云/Linux/MacOS
nano ~/.openclaw/openclaw.json
# Windows11(PowerShell)
notepad %USERPROFILE%\.openclaw\openclaw.json
在配置文件中添加以下内容:
{
"channels": {
"onebot": {
"enabled": true,
"wsUrl": "ws://127.0.0.1:3001/onebot",
"accessToken": ""
}
}
}
4. 生效与验证
# 1. 启动go-cqhttp(保持终端运行,不可关闭)
go-cqhttp
# 2. 重启OpenClaw网关
openclaw gateway restart
# 3. 验证对接:用其他QQ给你的QQ发送消息(如“帮我生成一段简单的工作通知”),AI能正常回复即为成功
五、新手高频问题解答(避坑必备,零技术也能解决)
(一)部署类问题
问题1:OpenClaw启动失败,提示“端口被占用”?
- 解决方案:Windows执行
netstat -ano | findstr "18789",MacOS/Linux/阿里云执行lsof -i:18789,找到占用端口的进程,终止进程后,重启网关(openclaw gateway restart);若仍失败,可修改端口(openclaw config set gateway.port 18790),重新启动。
- 解决方案:Windows执行
问题2:阿里云部署后,无法访问Web控制台,提示“无法连接”?
- 解决方案:① 检查18789端口是否放行(进入阿里云服务器防火墙,确认规则已添加);② 核对服务器公网IP是否正确,避免输入错误;③ 检查OpenClaw服务是否正常运行(
openclaw gateway status),若未运行,执行openclaw gateway start。
- 解决方案:① 检查18789端口是否放行(进入阿里云服务器防火墙,确认规则已添加);② 核对服务器公网IP是否正确,避免输入错误;③ 检查OpenClaw服务是否正常运行(
问题3:Mac M系列芯片安装OpenClaw后,提示“架构不兼容”?
- 解决方案:执行
arch -arm64 npm install -g openclaw@latest,指定ARM架构重新安装,同时确保所有依赖(Node.js、Git)均为ARM架构版本,避免Rosetta 2转译问题。
- 解决方案:执行
问题4:本地部署后,启动网关提示“Node.js版本过低”?
- 解决方案:执行
node --version验证版本,确保≥22.0.0;Windows重新运行Node.js安装命令,Linux/MacOS执行sudo npm install -g n && sudo n 22.0.0,升级Node.js版本。
- 解决方案:执行
(二)API与对接类问题
问题1:阿里云百炼API调用提示“密钥无效”?
- 解决方案:逐字符核对Access Key ID与Secret,删除多余空格;登录阿里云百炼控制台,确认密钥未过期、未被禁用;若密钥丢失,重新创建Access Key,重新配置API。
问题2:接入QQ/企业微信后,发送消息无响应?
- 解决方案:① 检查3000端口是否放行(阿里云部署需在防火墙添加规则,本地部署需关闭防火墙或添加例外);② 核对配置文件中的凭证(AgentID、Secret、QQ号等)是否正确;③ 重启go-cqhttp(QQ对接)和OpenClaw网关,重新尝试。
问题3:API调用提示“context window too small”(上下文窗口过小)?
- 原因:OpenClaw配置的上下文窗口与百炼模型支持的不一致;
- 解决方案:执行
openclaw config set models.providers.bailian.models.0.contextWindow 32768,将上下文窗口设置为32768(qwen3.5支持的最大窗口),重启网关生效。
(三)日常使用类问题
问题1:如何更新OpenClaw至最新版本?
- 解决方案:执行
npm install -g openclaw@latest,一键更新,更新完成后重启网关(openclaw gateway restart)。
- 解决方案:执行
问题2:忘记访问令牌,无法登录Web控制台?
- 解决方案:执行
openclaw token generate --admin,重新生成管理员令牌,复制后登录即可。
- 解决方案:执行
问题3:OpenClaw执行指令时,提示“技能缺失”?
- 解决方案:执行
clawhub install 技能名(如clawhub install web-scraper),安装对应的技能,重启网关后即可使用;若不知道需要安装什么技能,执行clawhub list,查看热门技能推荐。
- 解决方案:执行
六、总结
2026年零基础用户部署OpenClaw的核心是“简化操作、聚焦实用”,本文通过阿里云与本地全平台部署流程、阿里云百炼免费API配置、QQ/企业微信对接步骤,以及新手高频问题解答,全程零技术门槛,所有代码可直接复制执行,无需复杂编程知识,确保用户能快速完成部署并投入使用。
核心要点总结:
- 部署选择:新手优先选阿里云部署,无需担心环境兼容,可实现7×24小时稳定运行;注重数据隐私选本地部署,三大系统均支持一键操作;
- API配置:阿里云百炼免费额度足够新手使用,核心是正确填写密钥、配置国内接口地址,重启网关生效,避免密钥复制错误;
- 社交对接:企业微信对接适合团队协作,QQ对接适合个人使用,均需按步骤配置凭证、放行端口,重启服务后验证;
- 避坑核心:确保Node.js版本≥22.0.0,配置后重启网关,端口放行到位,凭证填写正确,遇到问题可参考高频问题解答,无需专业技术支持。
通过本文的流程与技巧,零基础用户可在1-2小时内完成OpenClaw全平台部署、API配置与社交平台对接,真正实现“自然语言指令驱动自动化操作”,让OpenClaw融入日常工作与沟通,解放双手,提升效率。