一、前言
OpenClaw(原Clawdbot)作为2026年主流的开源AI智能体框架,凭借轻量化、跨平台、可自托管、多IM集成与大模型灵活对接的特性,成为个人与团队搭建专属AI助手的首选方案。本文聚焦阿里云轻量服务器部署OpenClaw的最简流程,覆盖本地MacOS/Linux/Windows11全平台部署方法,详解阿里云千问Qwen3.6-Plus高性能API配置、飞书即时通讯集成步骤,并整理全场景高频问题与避坑方案,所有命令可直接复制运行,零基础用户可按步骤一次部署成功。
二、部署前环境准备(全平台通用)
OpenClaw 2026稳定版对基础环境有明确要求,环境不达标将导致启动失败、模型无法调用、服务闪退等问题,需提前核对:
- 核心依赖:Node.js ≥ v22.16.0 LTS(推荐v24.0.0及以上)、Git ≥ 2.30.0、Python 3.9+(部分插件依赖)
- 硬件配置:内存≥2GB(推荐4GB+)、磁盘空间≥10GB、CPU≥2核
- 网络条件:可正常访问公网,云端部署优先选择中国香港/新加坡地域(免备案,大模型API访问稳定)
- 账号要求:阿里云账号完成实名认证,开通百炼大模型服务获取API密钥
- 端口要求:默认核心端口18789(OpenClaw网关)、飞书集成按需占用对应端口
- 阿里云部署 OpenClaw 全网最简单,只需两步,详情 访问阿里云OpenClaw一键部署专题页面 了解。




三、阿里云轻量服务器部署OpenClaw(最简步骤)
3.1 实例创建与基础配置
- 登录阿里云控制台,进入轻量应用服务器 → 点击创建实例
- 镜像选择:系统镜像 → Alibaba Cloud Linux 3(兼容OpenClaw 2026稳定版)
- 实例规格:2核4GB内存 + 40GB ESSD云盘 + 5Mbps带宽(最低2核2GB,推荐4GB避免卡顿)
- 地域选择:中国香港/新加坡(无需ICP备案,海外API访问延迟更低)
- 登录设置:密码登录,设置包含大小写字母、数字、特殊符号的强密码
- 确认配置后购买,等待3-5分钟实例状态变为运行中,记录公网IP地址
3.2 防火墙端口放行(必做)
轻量服务器默认防火墙拦截所有端口,需手动放行OpenClaw核心端口:
- 进入实例详情页 → 防火墙 → 添加规则
- 新增规则:
- 协议:TCP
- 端口范围:18789
- 授权对象:0.0.0.0/0(允许所有IP访问)
- 命令行备用配置(服务器内执行):
# 永久放行18789端口 sudo firewall-cmd --permanent --add-port=18789/tcp # 重载防火墙规则 sudo firewall-cmd --reload # 验证端口放行状态 sudo firewall-cmd --list-ports
零基础部署 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 的地址。


3.3 环境依赖安装
通过阿里云Web终端连接服务器,依次执行以下命令安装依赖:
# 更新系统软件源
sudo dnf update -y
# 安装Git、Python、编译工具
sudo dnf install -y git python39 python39-pip make gcc gcc-c++
# 安装Node.js 24 LTS(2026推荐版本)
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo bash -
sudo dnf install -y nodejs
# 验证安装版本
node -v # 应≥v24.0.0
npm -v
git --version
python3 --version
# 配置npm国内镜像(加速安装)
npm config set registry https://registry.npmmirror.com
3.4 OpenClaw一键安装与初始化
# 全局安装OpenClaw
npm install -g openclaw
# 初始化配置(向导模式,新手直接回车默认)
openclaw onboard
# 配置管理员令牌(安全必做,自定义强密码)
openclaw config set gateway.auth.mode token
openclaw config set gateway.auth.token "OpenClaw@2026Aliyun"
# 启动网关服务
openclaw gateway start
# 设置开机自启
sudo openclaw gateway install
# 查看服务状态(出现active (running)即成功)
openclaw gateway status
# 系统一键诊断
openclaw status --all
3.5 访问验证
浏览器输入地址:http://你的轻量服务器公网IP:18789,输入配置的管理员令牌即可登录OpenClaw管理面板,云端部署完成。
四、本地全平台部署OpenClaw(MacOS/Linux/Windows11)
4.1 MacOS本地部署
# 安装Homebrew(未安装时执行)
/bin/bash -c "$(curl -fsSL https://mirrors.aliyun.com/homebrew/install.sh)"
# 安装Node.js 24、Git、Python
brew install node@24 git python3
# 配置环境变量
echo 'export PATH="$(brew --prefix node@24)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# 验证版本
node -v
# 配置npm镜像
npm config set registry https://registry.npmmirror.com
# 安装OpenClaw
npm install -g openclaw
# 初始化
openclaw onboard
# 启动服务
openclaw gateway start
# 安装系统服务(开机自启)
sudo openclaw gateway install
访问地址:http://localhost:18789
4.2 Linux(Ubuntu/Debian)部署
# 更新系统
sudo apt update && sudo apt upgrade -y
# 安装依赖
sudo apt install -y git python3 python3-pip build-essential
# 安装Node.js 24
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo bash -
sudo apt install -y nodejs
# 配置npm镜像
npm config set registry https://registry.npmmirror.com
# 安装OpenClaw
npm install -g openclaw
# 初始化
openclaw onboard
# 启动并设置自启
openclaw gateway start
sudo openclaw gateway install
# 查看状态
systemctl status openclaw-gateway
4.3 Windows11部署(管理员PowerShell)
必须右键以管理员身份运行PowerShell
# 允许执行脚本
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
# 安装Node.js 24、Git、Python
winget install OpenJS.NodeJS --version 24.0.0 -y
winget install Git.Git -y
winget install Python.Python.3.12 -y
# 重启终端生效
# 配置npm镜像
npm config set registry https://registry.npmmirror.com
# 安装OpenClaw
npm install -g openclaw
# 初始化
openclaw onboard
# 启动服务
openclaw gateway start
# 安装系统服务
openclaw gateway install
访问地址:http://localhost:18789
五、阿里云千问Qwen3.6-Plus API配置(高性能首选)
5.1 获取API密钥与接口地址
- 登录阿里云百炼平台(dashscope.aliyun.com)
- 进入 API Key管理 → 创建API Key,选择Qwen3.6-Plus模型权限
- 保存密钥(格式:
sk-xxxxxxxxxxxxxxxxxxxxxxxx),仅显示一次,务必妥善保管 - 接口地址(按地域选择):
- 国内(北京/杭州):
https://dashscope.aliyuncs.com/compatible-mode/v1 - 海外(中国香港/新加坡):
https://dashscope-intl.aliyuncs.com/compatible-mode/v1
- 国内(北京/杭州):
5.2 命令行一键配置(全平台通用)
# 设置默认主模型为千问Qwen3.6-Plus
openclaw config set agents.defaults.model.primary "dashscope-api/qwen3.6-plus"
# 配置API密钥
openclaw config set providers.dashscope-api.apikey "sk-你的API密钥"
# 配置接口地址(按地域选择)
openclaw config set providers.dashscope-api.baseurl "https://dashscope.aliyuncs.com/compatible-mode/v1"
# 模型参数优化(2026推荐配置)
openclaw config set providers.dashscope-api.temperature 0.6 # 随机性,0-1
openclaw config set providers.dashscope-api.maxTokens 65536 # 最大响应长度
openclaw config set providers.dashscope-api.contextWindow 1000000 # 上下文窗口
openclaw config set providers.dashscope-api.stream true # 流式输出
openclaw config set providers.dashscope-api.timeout 60000 # 超时时间(毫秒)
# 重启网关生效
openclaw gateway restart
# 测试模型调用
openclaw chat "介绍一下OpenClaw框架与千问Qwen3.6-Plus的集成优势"
5.3 配置文件手动配置(进阶)
若命令行配置失效,可直接编辑配置文件~/.openclaw/openclaw.json:
{
"providers": {
"dashscope-api": {
"apiKey": "sk-你的API密钥",
"baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
"temperature": 0.6,
"maxTokens": 65536,
"contextWindow": 1000000,
"stream": true,
"timeout": 60000
}
},
"agents": {
"defaults": {
"model": {
"primary": "dashscope-api/qwen3.6-plus"
}
}
}
}
修改后执行openclaw gateway restart生效。
六、OpenClaw集成飞书(企业IM对接)
6.1 飞书开放平台应用创建
- 登录飞书开放平台(open.feishu.cn)→ 企业自建应用 → 创建应用
- 填写应用名称(如"OpenClaw智能助手")、描述,上传图标,点击创建
- 添加应用能力 → 选择机器人 → 点击添加
- 进入凭证与基础信息,复制
App ID(cli_xxx)、App Secret - 权限管理 → 申请核心权限:
- 消息权限:
im:message:readonly、im:message:send_as_bot - 资源权限:
im:resource、aily:file:read
- 消息权限:
- 事件与回调 → 订阅方式选择使用长连接接收事件(WebSocket)
- 添加事件:
im.message.receive_v1(接收消息,必选)、im.chat.member.bot.added_v1(机器人进群,可选) - 版本管理与发布 → 创建版本 → 提交审核 → 发布应用
6.2 OpenClaw飞书配置
# 添加飞书渠道
openclaw channels add
# 选择 feishu (lark openplatform)
# 依次输入:App ID、App Secret
# 提示是否启用:选择 yes
# 重启网关生效
openclaw gateway restart
# 查看渠道状态
openclaw channels list
配置完成后,将飞书机器人添加至群组,即可通过飞书与OpenClaw对话,调用千问Qwen3.6-Plus能力。
七、OpenClaw核心运维命令(收藏)
# 查看网关状态
openclaw gateway status
# 重启服务
openclaw gateway restart
# 停止服务
openclaw gateway stop
# 查看实时日志
openclaw logs --follow --gateway
# 系统全量诊断
openclaw status --all
# 自动修复常见问题
openclaw doctor
# 重置所有配置
openclaw config --reset
# 更新OpenClaw版本
npm update -g openclaw
openclaw gateway restart
# 查看已安装插件
openclaw plugins list
# 生成管理员令牌
openclaw token generate --admin
八、高频问题与避坑指南(新手90%问题解决)
8.1 部署与启动问题
服务启动失败/闪退
- 原因:内存不足、Node.js版本过低、端口占用、权限不足
- 解决:
- 升级服务器/本地内存至4GB+
- 确保Node.js ≥ v22.16.0,重新安装
- 杀死占用18789端口进程:
# Mac/Linux lsof -i :18789 | kill -9 $(awk 'NR==2{print $2}') # Windows netstat -ano | findstr :18789 taskkill /F /PID 进程ID - 本地部署始终以管理员/root权限运行
Web UI无法访问
- 原因:防火墙未放行端口、IP错误、服务未启动、绑定地址为127.0.0.1
- 解决:
- 阿里云轻量确认放行18789端口
- 核对公网IP/本地地址正确
- 执行
openclaw gateway status确认服务运行 - 修改配置绑定0.0.0.0:
openclaw config set gateway.host 0.0.0.0 openclaw gateway restart
Windows安装报错“权限不足”
- 解决:右键PowerShell → 以管理员身份运行所有命令
Mac提示“文件已损坏”
- 解决:
sudo xattr -rd com.apple.quarantine /usr/local/bin/openclaw
- 解决:
8.2 大模型API配置问题
调用返回401/密钥无效
- 原因:API Key错误、格式错误、未开通Qwen3.6-Plus权限、地域不匹配
- 解决:
- 核对密钥为
sk-开头,无多余空格 - 百炼平台确认已开通Qwen3.6-Plus服务
- 接口地址与密钥地域一致(国内/海外)
- 重新生成密钥配置
- 核对密钥为
模型调用超时/无响应
- 原因:网络延迟、地域过远、超时时间过短、额度用尽
- 解决:
- 服务器切换至中国香港/新加坡地域
- 调高超时时间至60000ms:
openclaw config set providers.dashscope-api.timeout 60000 openclaw gateway restart - 百炼平台查看额度是否充足
配置修改后不生效
- 原因:未重启网关服务、配置文件格式错误
- 解决:
- 每次修改后必须执行
openclaw gateway restart - 检查
openclaw.json格式是否正确(无语法错误)
- 每次修改后必须执行
8.3 飞书集成问题
机器人不响应消息
- 原因:权限未申请、事件未添加、长连接未启动、渠道未启用
- 解决:
- 确认申请
im:message:readonly、im:message:send_as_bot权限 - 事件订阅添加
im.message.receive_v1 - 执行
openclaw channels list查看飞书渠道状态为enabled - 重启OpenClaw网关
- 确认申请
无法接收群消息
- 解决:添加
im.chat.member.bot.added_v1事件,重新发布应用
- 解决:添加
8.4 通用问题
服务重启后配置丢失
- 解决:执行
sudo openclaw gateway install设置开机自启,避免配置重置
- 解决:执行
模型回复缓慢/卡顿
- 解决:
- 升级服务器配置至4核8GB
- 启用模型缓存:
openclaw config set models.cache.enabled true openclaw config set models.cache.ttl 3600 openclaw gateway restart
- 解决:
依赖安装失败
- 解决:切换npm镜像
npm config set registry https://registry.npmmirror.com,删除node_modules重新安装
- 解决:切换npm镜像
九、总结
本文完整覆盖2026年阿里云轻量服务器部署OpenClaw、本地MacOS/Linux/Windows11全平台搭建、千问Qwen3.6-Plus API高性能配置、飞书IM集成四大核心流程,搭配全场景高频问题排查方案,所有命令均为实测可直接复制,无需复杂操作即可完成部署。
OpenClaw与千问Qwen3.6-Plus的组合,可实现本地/云端7×24小时稳定运行,支持对话交互、任务自动化、代码辅助、企业IM对接等全场景能力。遵循环境达标→端口放行→安全配置→模型对接→重启生效的核心流程,可避开90%以上常见问题,轻松搭建专属AI智能体系统。