一、前言
OpenClaw(曾用名Clawdbot)是2026年主流开源AI智能体框架,支持本地私有化部署、多Agent协同、工具调用、记忆管理与第三方平台接入,可广泛用于内容创作、项目管理、代码开发、自动化运营等场景。本文基于2026年最新稳定版,完整覆盖阿里云云端部署、MacOS/Linux/Windows11本地安装、阿里云千问大模型API配置、Coding Plan免费模型接入、多Agent协同、飞书集成、常见问题排查全流程,所有配置与命令均可直接复制使用,无技术门槛也能快速落地。
二、OpenClaw核心能力与适用场景
- 多Agent调度:支持主控Agent+专业Worker分工协作,实现任务自动拆解、流转、整合。
- 大模型兼容:无缝对接阿里云千问系列、Coding Plan免费模型,支持多模型切换。
- 平台接入:可集成飞书等协作工具,实现移动端与桌面端统一管控。
- 本地优先:数据本地存储,隐私可控,支持7×24小时稳定运行。
- 工具生态:内置文件操作、代码执行、信息检索、定时任务等能力。
- 目前阿里云部署 OpenClaw 只需两步,全网最简单,步骤流程 访问阿里云OpenClaw一键部署专题页面 了解。

适用人群:独立开发者、自媒体运营、创业者、运维人员、轻量化团队办公。
三、2026年阿里云部署OpenClaw(Clawdbot)完整流程
3.1 环境准备
- 注册阿里云账号并完成实名认证。
- 轻量应用服务器/ECS:推荐2核2GB及以上,系统盘≥40GB,操作系统选用Alibaba Cloud Linux 3或Ubuntu 22.04。
- 安全组放行端口:22(SSH)、18789(OpenClaw网关)。
- 阿里云百炼API Key(访问订阅阿里云百炼Coding Plan,用于通义千问模型调用)。
3.2 应用镜像一键部署(新手首选)
阿里云用户零基础部署 OpenClaw 喂饭级步骤流程
第一步:点击打开访问阿里云OpenClaw一键部署专题页面。




第二步:打开选择阿里云轻量应用服务器,配置参考如下:
- 镜像: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(Clawdbot) 2026稳定版。
- 配置实例规格、地域、登录密码,完成购买。
- 等待3–5分钟,实例自动完成部署,获取公网IP。
- 浏览器访问:
http://公网IP:18789进入Web管理界面。
3.3 命令行手动部署(适合自定义环境)
1. 远程连接服务器,关闭防火墙并放行端口
# Alibaba Cloud Linux / CentOS
systemctl stop firewalld
systemctl disable firewalld
sed -i 's/^SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config
setenforce 0
# Ubuntu
sudo ufw disable
2. 安装Node.js 22+(运行必需)
curl -fsSL https://nodejs.org/dist/v22.0.0/node-v22.0.0-linux-x64.tar.xz -o node.tar.xz
tar -xf node.tar.xz -C /usr/local --strip-components=1
node -v
npm -v
3. 一键安装OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash
4. 初始化配置并设置开机自启
openclaw onboard
openclaw gateway install
openclaw gateway start
systemctl enable openclaw
5. 验证服务状态
openclaw status --all
curl http://127.0.0.1:18789
四、本地全平台部署(MacOS / Linux / Windows11)
4.1 MacOS部署
# 安装Homebrew(已安装可跳过)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装Node.js
brew install node
node -v
npm -v
# 安装OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash
# 初始化并后台运行
openclaw onboard --install-daemon
openclaw gateway start
4.2 Linux(Ubuntu/Debian)部署
sudo apt update && sudo apt upgrade -y
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash
sudo apt install -y nodejs git
# 安装OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash
# 初始化与系统服务
openclaw onboard
openclaw gateway install
sudo systemctl start openclaw
sudo systemctl enable openclaw
4.3 Windows11部署
- 以管理员身份打开PowerShell。
- 执行一键安装脚本
Set-ExecutionPolicy Bypass -Scope Process -Force iwr -useb https://openclaw.ai/install.ps1 | iex - 初始化配置
openclaw onboard --install-daemon openclaw gateway start - 验证安装
openclaw --version openclaw status --all
五、阿里云千问大模型API配置
5.1 获取API Key
- 访问登录阿里云百炼大模型服务平台,登录阿里云百炼Model Studio。
- 进入密钥管理,创建API Key,保存
sk-xxxx格式密钥。 - 确认已开通Qwen3-Max、Qwen3.5-Plus等模型权限。
5.2 命令行快速配置
openclaw config set models.providers.bailian.baseUrl "https://dashscope.aliyuncs.com/compatible-mode/v1"
openclaw config set models.providers.bailian.apiKey "sk-你的APIKey"
openclaw config set agents.defaults.model.primary "bailian/qwen3-max-2026-01-23"
5.3 配置文件写入(openclaw.json)
"models": {
"mode": "merge",
"providers": {
"bailian": {
"baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
"apiKey": "sk-你的APIKey",
"models": [
{
"id": "qwen3-max-2026-01-23",
"name": "Qwen3 Max",
"contextWindow": 128000,
"maxTokens": 8192
}
]
}
}
}
六、Coding Plan免费大模型API配置
6.1 开通免费额度
- 访问订阅阿里云百炼Coding Plan,进入阿里云百炼Coding Plan页面。
- 领取免费额度,获取专属API Key(格式:
sk-sp-xxxx)。
6.2 命令行配置
openclaw config set models.providers.coding-plan.baseUrl "https://coding.dashscope.aliyuncs.com/v1"
openclaw config set models.providers.coding-plan.apiKey "sk-sp-你的APIKey"
openclaw config set agents.defaults.model.primary "coding-plan/qwen3-max"
6.3 配置文件示例
"models": {
"providers": {
"coding-plan": {
"baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
"apiKey": "sk-sp-你的APIKey",
"models": [
{
"id":"qwen3-max","name":"Qwen3 Max Coding"}
]
}
}
}
七、多Agent协同与飞书集成配置
7.1 多Agent定义(openclaw.json)
"agents": {
"defaults": {
"models": {
"qwen-portal/coder-model": {
"alias": "qwen" }
},
"maxConcurrent": 4
},
"list": [
{
"id": "main",
"default": true,
"name": "总指挥",
"workspace": "~/.openclaw/workspace-main",
"model": "qwen-portal/coder-model"
},
{
"id": "writer",
"name": "文案创作",
"workspace": "~/.openclaw/workspace-writer",
"model": "qwen-portal/coder-model"
},
{
"id": "coder",
"name": "代码开发",
"workspace": "~/.openclaw/workspace-coder",
"model": "qwen-portal/coder-model"
},
{
"id": "researcher",
"name": "信息调研",
"workspace": "~/.openclaw/workspace-researcher",
"model": "qwen-portal/coder-model"
}
]
}
7.2 开启Agent间通信
"tools": {
"agentToAgent": {
"enabled": true,
"allow": ["main","writer","coder","researcher"]
}
}
7.3 飞书通道配置
"bindings": [
{
"agentId":"main","match":{
"channel":"feishu","accountId":"main"}},
{
"agentId":"writer","match":{
"channel":"feishu","accountId":"writer"}}
],
"channels": {
"feishu": {
"enabled": true,
"dmPolicy": "pairing",
"groupPolicy": "open",
"accounts": {
"main": {
"appId":"cli_xxx","appSecret":"xxx"},
"writer": {
"appId":"cli_xxx","appSecret":"xxx"}
}
}
}
7.4 启动服务
openclaw doctor
openclaw gateway restart
八、常见问题解答
服务启动失败,端口18789占用
- 结束占用进程:
lsof -i:18789 | kill -9 PID - 或修改配置文件端口,重启服务。
- 结束占用进程:
模型调用返回401/403
- 核对API Key是否正确,Coding Plan必须用
sk-sp-开头密钥。 - 确认账号有可用额度,未过期、未欠费。
- 检查baseUrl是否正确,无多余空格。
- 核对API Key是否正确,Coding Plan必须用
飞书机器人不响应
- 确认AppId、AppSecret正确,机器人已拉入群组。
- 配置
groupPolicy":"open",消息需@对应Agent。 - 重启gateway:
openclaw gateway restart。
Agent无法互相通信
- 检查
agentToAgent.enabled":true。 - 确认allow列表包含所有Agent ID。
- 使用
openclaw doctor检查配置语法。
- 检查
Windows权限不足/脚本无法运行
- 必须以管理员身份运行PowerShell。
- 执行
Set-ExecutionPolicy RemoteSigned解除策略限制。
内存不足导致服务崩溃
- 云端服务器最低2核2GB,本地建议16GB内存以上。
- 关闭多余应用,减少模型并发数量。
配置文件不生效
- 路径:Mac/Linux
~/.openclaw/openclaw.json;WindowsC:\Users\用户名\.openclaw\openclaw.json。 - 用
openclaw doctor检查JSON格式错误。
- 路径:Mac/Linux
九、启动与使用流程
- 检查配置合法性:
openclaw doctor - 启动网关服务:
openclaw gateway - 查看运行状态:
openclaw status --all - 访问Web控制台:
http://本机IP:18789 - 飞书群内@主控Agent,下达任务指令,触发多Agent协同流程
十、总结
OpenClaw作为2026年成熟的AI智能体框架,通过云端+本地双部署模式,满足个人与团队的私有化、高可用需求;对接阿里云千问与Coding Plan免费模型,兼顾性能与成本;多Agent协同+飞书集成,真正实现一人即可运营完整业务流程,覆盖内容创作、开发、调研、运营全场景。本文提供的安装命令、配置文件、问题排查方案均为2026年最新实测可用版本,可直接用于生产环境与日常办公,大幅提升自动化效率。