前言
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官方镜像,无需复杂环境配置,一键部署、公网可直接访问,适合长期稳定运行。
- 飞书集成:通过OpenClaw官方飞书插件,基于WebSocket长连接实现AI机器人与飞书无缝对接,支持单聊、群聊@响应、消息自动处理、任务进度同步。
- 阿里云千问大模型:阿里云百炼旗舰模型(Qwen3.6-Plus/Qwen3-Max),具备超长上下文、强逻辑推理与工具调用能力,为OpenClaw提供企业级智能大脑。
- Coding Plan:阿里云百炼推出的免费API套餐,个人用户每月享18000次免费请求,适配OpenClaw基础场景,零成本入门首选。
- 本地部署环境:MacOS(M系列芯片最优)、Linux(Ubuntu/CentOS)、Windows11(WSL2优先),满足离线运行、自定义配置需求。
1.2 账号与环境要求
- 阿里云账号:注册阿里云账号完成实名认证,开通轻量应用服务器、百炼大模型服务,新用户可领取免费试用额度。
- 飞书账号:拥有企业自建应用创建权限(个人/企业账号均可,企业版功能更完整)。
- 服务器配置:阿里云轻量服务器推荐2核4GB内存+40GB ESSD云盘(最低2核2GB,低于2GB易导致服务崩溃)。
- 本地环境:
- MacOS:12及以上版本,内存≥8GB
- Linux:Ubuntu 22.04/CentOS 7及以上,2核4GB+内存
- Windows11:专业版/家庭版,开启WSL2(Ubuntu 22.04),内存≥4GB
- 必备工具:终端(Mac/Linux)、PowerShell(Windows管理员权限)、文本编辑器(保存API密钥、App凭证)。
1.3 关键信息预准备(部署前必存)
- 阿里云轻量服务器公网IP
- 飞书App ID(cli_开头)、App Secret
- 阿里云百炼千问API Key(sk-开头)、Coding Plan API Key(sk-sp-开头)
- OpenClaw管理员Token(Web控制台登录凭证)
- 模型对应Base URL(千问与Coding Plan不通用)
二、阿里云轻量服务器部署OpenClaw(新手极简,10分钟完成)
2.1 轻量服务器实例创建(官方镜像一键部署)
- 登录阿里云控制台,搜索「轻量应用服务器」,进入创建页面。
- 选择应用镜像:在「应用镜像」中搜索并选择OpenClaw(Clawdbot) 2026官方稳定版(预装Node.js 22、依赖环境与核心程序)。
- 实例配置:
- 套餐:2核4GB内存+40GB ESSD云盘(推荐,稳定运行无压力)
- 地域:中国香港/新加坡(免备案、网络稳定,适配飞书与大模型API)
- 操作系统:Alibaba Cloud Linux 3(官方优化,兼容性最佳)
- 登录方式:设置密码(牢记,用于远程登录)
- 确认订单:核对配置后点击「创建」,等待5-8分钟,实例状态变为「运行中」,记录公网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 的地址。


2.2 远程连接与OpenClaw初始化配置
2.2.1 远程登录服务器(两种方式)
# 方式1:阿里云控制台Web终端(推荐,无需安装工具)
# 轻量服务器实例详情页→远程连接→Web终端,直接登录
# 方式2:本地终端SSH连接(替换为你的公网IP)
ssh root@你的轻量服务器公网IP
# 首次登录输入yes确认,再输入设置的密码登录
2.2.2 核心初始化命令(直接复制执行)
# 1. 验证基础环境(Node.js≥22,OpenClaw≥2026.04)
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://你的轻量服务器公网IP:18789 - 粘贴生成的管理员Token,登录OpenClaw中文控制台
- 发送测试指令:“创建一个名为‘阿里云部署测试’的文本文件,内容为‘OpenClaw部署成功’”
- 系统自动执行并反馈文件路径,说明阿里云轻量服务器部署OpenClaw成功
2.4 阿里云部署避坑指南(新手必看)
坑1:实例创建失败(地域无资源/权限不足)
- 原因:所选地域资源售罄、账号未实名认证、ECS配额不足
- 解决方案:切换至中国香港/新加坡地域;完成实名认证;在阿里云配额中心提升实例配额
坑2:Web控制台无法访问(端口未放行)
- 原因:轻量服务器防火墙未放行18789端口、安全组规则缺失
- 解决方案(命令行一键放行):
firewall-cmd --add-port=18789/tcp --permanent firewall-cmd --reload # 控制台放行:实例→防火墙→添加规则,放行TCP 18789端口
坑3:服务启动失败(内存不足/版本过低)
- 原因:服务器内存<2GB、Node.js版本<22
- 解决方案:升级至2核4GB及以上;升级Node.js:
npm install -g n && n stable node -v # 验证版本≥v22.0.0
坑4:命令提示“openclaw: command not found”
- 原因:环境变量未生效
- 解决方案:
echo 'export PATH="$PATH:$(npm prefix -g)/bin"' >> ~/.bashrc source ~/.bashrc openclaw --version
三、本地MacOS部署OpenClaw(低功耗稳定,M系列最优)
3.1 环境准备与依赖安装
# 1. 安装Homebrew包管理器(已安装可跳过)
/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环境变量(Zsh终端,Mac默认)
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# 4. 验证版本(必须≥v22.0.0)
node -v
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
sudo apt install -y nodejs npm git curl
# 2. 升级Node.js至22(Ubuntu默认版本过低)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt install -y nodejs
# 3. 验证版本
node -v
npm -v
4.2 OpenClaw安装与配置
# 1. 一键安装OpenClaw
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
# 2. 非交互式初始化(服务器推荐,无人工干预)
openclaw init --non-interactive --accept-risk
# 3. 安装系统服务(root权限)
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子系统」与「虚拟机平台」
- 以管理员身份打开PowerShell,执行:
# 安装WSL2并部署Ubuntu 22.04 wsl --install -d Ubuntu-22.04 wsl --set-default-version 2 - 启动Ubuntu,设置用户名与密码,进入Linux终端
5.2 WSL2内OpenClaw部署(同Linux步骤)
# 执行以下Linux部署命令
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
六、飞书渠道深度集成(企业协作必备,20分钟完成)
6.1 飞书开放平台应用创建(前置必做)
- 访问飞书开放平台:
https://open.feishu.cn/app,登录企业飞书账号 - 点击「创建应用」→「企业自建应用」,填写应用名称(如OpenClaw-AI)、描述,点击「创建」
- 获取应用凭证:进入「凭证与基础信息」,复制App ID与App Secret(妥善保管,勿泄露)
- 添加机器人能力:左侧「添加能力」→「按能力添加」→找到「机器人」卡片→点击「配置」→开启机器人功能→设置机器人名称→保存
6.2 飞书应用权限配置(核心必做)
- 左侧进入「权限管理」→「开通权限」,搜索并开通以下核心权限(缺一不可):
# 批量导入权限JSON(直接复制粘贴) { "scopes": { "tenant": [ "im:message", "im:message.group_at_msg:readonly", "im:message.p2p_msg:readonly", "im:message:send_as_bot", "im:resource", "im:chat.members:bot_access", "contact:user.base:readonly" ] } }
- 点击「批量开通」,确认所有权限状态为「已开通」
6.3 飞书事件订阅(WebSocket长连接,稳定优先)
- 左侧进入「事件与回调」→「事件配置」→「订阅方式」
- 选择使用长连接接收事件(WebSocket)→点击「保存」(必须先启动OpenClaw服务,否则保存失败)
- 点击「添加事件」,搜索并添加im.message.receive_v1(接收消息,必选),可选添加:
- im.message.message_read_v1(消息已读)
- im.chat.member.bot.added_v1(机器人进群)
- 左侧进入「版本管理与发布」→「创建版本」→填写版本号(1.0.0)→「保存」→「发布」(企业自建应用自动通过)
6.4 OpenClaw飞书渠道配置(命令行一键完成)
步骤1:安装飞书插件
# 安装官方飞书渠道插件
openclaw plugins install @openclaw/feishu
# 验证插件安装
openclaw plugins list | grep feishu
步骤2:配置飞书参数(替换为你的凭证)
# 1. 启用飞书渠道
openclaw config set channels.feishu.enabled true
# 2. 连接模式设置为WebSocket长连接(推荐)
openclaw config set channels.feishu.mode "websocket"
# 3. 填入飞书App凭证(替换为你的信息)
openclaw config set channels.feishu.appId "cli_你的飞书App ID"
openclaw config set channels.feishu.appSecret "你的飞书App Secret"
# 4. 功能配置
openclaw config set channels.feishu.enableGroup true # 启用群聊响应
openclaw config set channels.feishu.requireMention true # 群聊需@机器人响应
openclaw config set channels.feishu.dmPolicy "pairing" # 私聊需配对验证
# 5. 重启服务生效
openclaw gateway restart
步骤3:飞书配对验证(安全必做)
- 在飞书单聊/群聊中@机器人,发送:“配对OpenClaw”
- 查看服务器终端,获取配对码(如:PAIR-FEISHU-6688)
- 执行配对批准命令:
```bash查看待审批配对列表
openclaw pairing list feishu
批准配对(替换为实际配对码)
openclaw pairing approve feishu PAIR-FEISHU-6688
4. 终端显示「✅ 飞书配对成功!」,即完成集成
### 6.5 飞书功能测试与优化
- **单聊测试**:向机器人发送“帮我总结OpenClaw部署要点”
- **群聊测试**:在飞书群@机器人,发送“创建今日任务清单”
- **安全优化**(命令行):
```bash
# 限制仅信任用户/群组可触发AI
openclaw config set channels.feishu.allowFrom ["@张三", "#项目协作群"]
# 启用消息缓存,提升响应速度
openclaw config set channels.feishu.cache true
# 重启服务生效
openclaw gateway restart
6.6 飞书集成避坑指南
坑1:WebSocket连接失败(凭证错误/权限不足)
- 原因:App ID/Secret填写错误、未开通必需权限、未发布应用
- 解决方案:核对凭证;重新开通所有权限;发布应用新版本
坑2:机器人不回复(未配对/事件未订阅)
- 原因:未完成配对验证、未添加im.message.receive_v1事件
- 解决方案:重新执行配对流程;在事件订阅中添加必需事件
坑3:群聊无响应(未开启群聊功能/未加入群组)
- 原因:未开启enableGroup、机器人未加入目标群组
- 解决方案:
在飞书群执行openclaw config set channels.feishu.enableGroup true openclaw gateway restart/invite @机器人名称添加
坑4:频繁掉线(网络波动)
- 解决方案:更换阿里云轻量服务器至中国香港地域;重启OpenClaw服务
七、阿里云千问大模型API配置(企业级,强智能)
7.1 获取千问API密钥
- 登录阿里云百炼控制台,完成实名认证
- 进入「密钥管理」→「创建API Key」,复制生成的sk-开头密钥(仅显示一次,加密保存)
- 记录Base URL:
- 国内节点:
https://dashscope.aliyuncs.com/compatible-mode/v1 - 国际节点:
https://dashscope-intl.aliyuncs.com/compatible-mode/v1
- 国内节点:
7.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
八、免费Coding Plan API配置(个人首选,零成本)
8.1 获取Coding Plan密钥
- 百炼控制台进入「Coding Plan」,订阅Lite免费版(每月18000次免费请求)
- 生成并复制sk-sp-开头API Key(与千问密钥不通用)
- 专用Base URL:
https://coding.dashscope.aliyuncs.com/v1
8.2 OpenClaw配置步骤
# 1. 设置Coding Plan专属模型
openclaw config set agents.defaults.model.primary "coding-plan/qwen3-coding"
# 2. 配置专属密钥与地址
openclaw config set providers.coding-plan.apikey "sk-sp-你的Coding Plan Key"
openclaw config set providers.coding-plan.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
九、全平台部署常见问题与解决方案(高频汇总)
9.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
9.2 大模型API类问题
问题1:模型调用失败,API Key无效
- 原因:密钥错误、千问与Coding Plan密钥混用、地域不匹配
- 解决:核对密钥类型;切换对应Base URL;重新生成密钥
问题2:回复为空/无响应
- 原因:未关闭reasoning参数
- 解决:
openclaw config set agents.defaults.model.parameters.reasoning false
openclaw gateway restart
问题3:调用频繁被限流
- 解决:降低请求频率;
openclaw config set agents.defaults.model.rateLimit 1
openclaw gateway restart
9.3 飞书集成类问题
问题1:长连接保存失败
- 原因:OpenClaw服务未启动
- 解决:先执行
openclaw gateway start,再配置飞书事件订阅
问题2:机器人进群无响应
- 原因:未开启群聊权限、未添加机器人进群
- 解决:开启enableGroup参数;在群内执行
/invite添加机器人
9.4 本地部署类问题
问题1:Mac/Linux安装卡住
- 解决:切换npm镜像;使用代理;手动下载安装包
问题2:Windows WSL2无法访问Web控制台
- 解决:放行WSL防火墙;使用localhost访问;确认端口转发正常
十、总结
2026年,OpenClaw已实现阿里云云端与本地全平台覆盖,搭配飞书企业级协作集成与阿里云千问/Coding Plan大模型API,零基础用户也能快速搭建专属AI智能体,实现从简单对话到复杂任务执行、跨平台消息协同的全能力覆盖。
本文完整覆盖2026年阿里云轻量服务器部署及本地MacOS/Linux/Windows11部署OpenClaw(Clawdbot)步骤流程及阿里云千问大模型API配置或市场上免费大模型Coding Plan API配置及常见问题解答,从部署前准备、云端/本地搭建、飞书深度集成到大模型API对接,全程提供可直接复制的代码命令、避坑指南与问题解决方案,确保用户一次部署成功、长期稳定运行。无论是个人日常效率提升,还是企业团队办公自动化,都能通过本教程快速落地,享受AI智能体带来的高效协作新体验。