OpenClaw(昵称“小龙虾”,原Clawdbot)作为2026年主流的开源多智能体框架,其Actor模型架构天生适配多智能体协作——每个Agent拥有独立文件系统、记忆存储和身份配置,通过Gateway路由实现消息传递。但从零手工搭建协作型智能体团队,常面临协作规范缺失、配置门槛高、任务委派易失联、协作过程不透明等问题,导致调试成本高、Token消耗大。
本文基于2026年OpenClaw最新稳定版(v1.9.3),结合实测经验与官方文档,系统梳理阿里云云端部署、本地多系统(MacOS/Linux/Windows11)部署流程,详解阿里云百炼Coding Plan及免费大模型API配置技巧,重点拆解agentrun-team技能的核心功能与使用方法,通过实战案例展示多智能体团队搭建全流程,附上常见问题排查方案,所有代码命令可直接复制执行,助力用户快速搭建高效协作的智能体团队。阿里云上OpenClaw极速一键部署最简单,步骤详情 访问阿里云OpenClaw一键部署专题页面 了解。

一、部署前基础准备
(一)硬件与软件要求
- 硬件配置:云端部署推荐2核4G及以上服务器(多智能体协作需更多资源);本地部署需CPU≥4核、内存≥16GB、硬盘剩余空间≥30GB,确保多Agent同时运行无卡顿。
- 必备工具:Git(版本控制)、Node.js(≥18.x,技能管理核心依赖)、终端工具(Windows推荐PowerShell,MacOS/Linux自带终端)、远程连接工具(如FinalShell,用于云端部署)、文本编辑器(如VS Code,修改配置文件)、钉钉客户端(多智能体协作通讯用)。
- 网络要求:稳定的互联网连接,部署过程需下载源码与依赖包,建议带宽≥10Mbps;国内用户可切换国内镜像源加速下载,避免网络超时。
- 账号准备:阿里云账号(云端部署与百炼API配置用)、GitHub账号(获取技能源码)、钉钉企业账号(创建机器人用于协作)、目标AI模型平台账号(免费API配置用)。
(二)核心资源与安全须知
- 阿里云服务开通:注册阿里云账号,完成实名认证,开通“轻量应用服务器”与“阿里云百炼”服务,两者均免费开通,仅服务器租赁需付费,百炼新用户可领取90天免费调用额度。
- 钉钉机器人准备:登录钉钉开发者后台,创建企业内部应用(数量对应智能体团队成员数),每个应用添加“机器人”能力并发布上线,记录每个应用的Client ID与Client Secret,用于后续通讯绑定。
- 免费大模型资源:访问订阅阿里云百炼Coding Plan,收集支持Coding Plan API的免费模型平台,如通义千问开放平台、GLM开源社区等,提前注册账号并了解API调用规则与免费额度限制。
- 技能选择原则:优先安装官方认证技能,agentrun-team技能作为多智能体协作核心,建议从官方仓库获取,避免第三方修改版本导致协作异常。
二、多场景部署流程(2026实测稳定版)
(一)阿里云云端部署(推荐,支持7×24小时协作)
阿里云提供OpenClaw专属镜像,部署流程简化,无需手动配置依赖,适合需要长期稳定运行的多智能体团队,最快30分钟即可完成全流程配置。
阿里云用户零基础部署 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,推荐访问订阅阿里云百炼Coding Plan,阿里云百炼Coding Plan每天两场抢购活动,从按tokens计费升级为按次收费,可以进一步节省费用!
- 购买后,在控制台生成API Key。注:这里复制并保存好你的API Key,后面要用。

- 回到轻量应用服务器-控制台,单击服务器卡片中的实例 ID,进入服务器概览页。

- 在服务器概览页面单击应用详情页签,进入服务器详情页面。

- 端口放通在OpenClaw使用步骤区域中,单击端口放通下的执行命令,可开放获取OpenClaw 服务运行端口的防火墙。

- 这里系统会列出我们第一步中创建的阿里云百炼 Coding Plan的API Key,直接选择就可以。

- 获取访问地址单击访问 Web UI 面板下的执行命令,获取 OpenClaw WebUI 的地址。


阿里云服务器购买与配置
1. 服务器购买与配置:
- 访问阿里云OpenClaw一键部署专题页面,点击【一键购买并部署】。
- 配置选择:镜像勾选“OpenClaw 2026.3.3(Moltbot)”,实例选择2核4G及以上(内存≤2GiB会导致多Agent运行卡顿),系统盘40GiB ESSD,地域推荐中国香港或新加坡(免备案,确保钉钉通讯流畅),购买时长根据需求选择(测试阶段可选1个月)。
- 支付完成后,在阿里云控制台获取服务器公网IP、默认用户名(root)与登录密码(购买时设置)。
2. 服务器连接与端口配置:
- 打开FinalShell,新建连接,输入公网IP、用户名与密码,建立远程连接。
- 开放服务端口:执行以下命令放行OpenClaw默认端口(18789)与通讯端口,避免防火墙拦截:
# CentOS系统
firewall-cmd --zone=public --add-port=18789/tcp --permanent
firewall-cmd --zone=public --add-port=8080/tcp --permanent
firewall-cmd --reload
# Ubuntu系统
ufw allow 18789
ufw allow 8080
ufw reload
3. 初始化与API配置:
- 在服务器控制台点击实例ID进入概览页,切换至“应用详情”标签页。
- 执行基础配置:依次点击“初始化OpenClaw配置”“生成访问Token”“开启公网访问”,系统自动完成环境初始化。
- 配置百炼API:点击“一键配置API-Key”,输入阿里云百炼的AccessKey ID与AccessKey Secret,执行命令完成绑定。
- 验证部署:获取Web UI面板地址,在本地浏览器访问该地址,发送测试指令“你好”,若正常回复则部署成功。
(二)本地部署流程(MacOS/Linux/Windows11)
1. MacOS系统部署
依赖环境安装:
打开终端,执行以下命令安装Git、Node.js与核心依赖:# 安装Homebrew(已安装可跳过) /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # 安装Git与Node.js brew install git nodejs # 切换npm国内镜像源 npm config set registry https://registry.npmmirror.com # 安装ClawHub CLI(技能管理工具) sudo npm install -g clawhub # 验证版本 node -v # 显示v18.x及以上即为合格 git --version源码下载与初始化:
# 创建工作目录 mkdir -p ~/openclaw/workspace cd ~/openclaw/workspace # 克隆OpenClaw源码 git clone https://github.com/openclaw/openclaw.git ./openclaw-core cd openclaw-core # 安装项目依赖 npm install # 初始化配置文件 cp config.example.json config.json # 全局链接,便于终端直接调用 sudo npm link --global启动与验证:
# 启动OpenClaw服务 openclaw start # 后台运行(可选) nohup openclaw start > openclaw.log 2>&1 &启动成功后,访问http://localhost:18789即可进入Web UI交互界面。
2. Linux系统部署(以Ubuntu 22.04为例)
- 系统更新与依赖安装:
# 更新系统包
sudo apt update && sudo apt upgrade -y
# 安装Git、Node.js与编译依赖
sudo apt install git nodejs npm build-essential -y
# 升级npm与安装ClawHub CLI
npm install -g npm@latest clawhub
# 切换国内镜像源
npm config set registry https://registry.npmmirror.com
- 源码部署与配置:
# 创建工作目录并授权
sudo mkdir -p /opt/openclaw
sudo chown $USER:$USER /opt/openclaw
cd /opt/openclaw
# 克隆源码
git clone https://github.com/openclaw/openclaw.git ./openclaw-core
cd openclaw-core
# 安装依赖与初始化
npm install
cp config.example.json config.json
# 全局链接
sudo npm link --global
- 设置开机自启(可选):
# 创建系统服务文件
sudo nano /etc/systemd/system/openclaw.service
粘贴以下内容:
[Unit]
Description=OpenClaw Service
After=network.target
[Service]
User=root
WorkingDirectory=/opt/openclaw/openclaw-core
ExecStart=/usr/local/bin/openclaw start
Restart=always
[Install]
WantedBy=multi-user.target
保存后执行:
sudo systemctl daemon-reload
sudo systemctl enable openclaw
sudo systemctl start openclaw
# 查看运行状态
sudo systemctl status openclaw
3. Windows11系统部署
- 依赖环境安装:
- 下载并安装Git(勾选“Add to PATH”)与Node.js(≥18.x,默认安装即可)。
- 打开PowerShell(管理员身份),验证安装:
node -v git --version
源码部署与配置:
# 创建工作目录 mkdir -Force C:\openclaw\workspace cd C:\openclaw\workspace # 克隆源码 git clone https://github.com/openclaw/openclaw.git .\openclaw-core cd .\openclaw-core # 安装依赖与ClawHub CLI npm install npm install -g clawhub # 复制配置文件 copy config.example.json config.json # 全局链接 npm link --global启动与验证:
# 启动服务 openclaw start # 后台运行(可选,需安装PM2) npm install -g pm2 pm2 start npm --name "openclaw" -- run start启动成功后,访问
http://localhost:18789即可进入Web UI交互界面。
(三)全系统通用初始化操作
部署完成后,执行以下命令完成基础配置,确保多智能体协作正常:
# 初始化工作区
openclaw init
# 查看系统状态
openclaw status
# 升级至最新版本
openclaw update
# 安装基础通讯依赖
npm install @openclaw/dingtalk-adapter
三、AI模型API配置(阿里云百炼+免费Coding Plan)
(一)阿里云百炼API配置
- 获取API密钥:
- 访问登录阿里云百炼大模型服务平台,选择“Coding Plan”,根据需求购买套餐(首购低至7.9元/月,支持通义千问、Kimi-k2.5等多模型)。
- 进入“API密钥管理”,点击“创建密钥”,生成AccessKey ID与AccessKey Secret,妥善保存(仅显示一次,泄露需及时重置)。
- 配置OpenClaw调用:
- 打开配置文件(本地路径:~/openclaw/workspace/openclaw-core/config.json;云端路径:/opt/openclaw/openclaw-core/config.json)。
- 编辑模型配置字段:
"llm": { "provider": "aliyun-bailian", "accessKeyId": "你的AccessKey ID", "accessKeySecret": "你的AccessKey Secret", "model": "Qwen3.5-Plus", // 选择已订阅的模型 "endpoint": "https://coding.dashscope.aliyuncs.com/v1" } - 重启服务生效:
# 本地部署 openclaw restart # 云端部署 sudo systemctl restart openclaw
(二)免费大模型Coding Plan API配置(以通义千问开放平台为例)
- 获取API密钥:
- 登录通义千问开放平台,完成实名认证后,进入“API密钥管理”创建密钥,获取api_key与api_secret。
- 查看免费额度:新用户可领取Qwen-Tiny、Qwen-Lite等模型的免费调用次数,足够日常测试与轻量协作使用。
- 配置OpenClaw:
修改config.json文件:
重启服务后,发送测试指令(如“总结多智能体协作的核心优势”),若正常返回结果则配置成功。"llm": { "provider": "qwen", "apiKey": "你的api_key", "apiSecret": "你的api_secret", "model": "qwen-tiny", "endpoint": "https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation" }
(三)多模型切换方法
如需为不同智能体配置不同模型,可通过以下命令快速切换:
# 打开配置界面
openclaw config
# 选择Model选项,在列表中选择目标模型
# 输入对应模型的API Key
# 重启服务生效
openclaw gateway restart
支持切换的模型包括Minimax M2.5、GLM-4、Kimi-k2.5等,切换前需确认模型已在对应平台开通权限。
四、多智能体协作核心:agentrun-team技能详解
agentrun-team技能将多智能体协作的最佳实践封装为自动化流程,用户只需描述团队需求,即可自动完成Agent创建、通讯配置、规范注入等全部流程,解决手工搭建的诸多痛点。
(一)技能安装与基础配置
1. 安装方法(支持4种核心方式)
(1)命令行安装(推荐)
# 安装agentrun-team技能
openclaw skills install agentrun-team
# 启用技能
openclaw skills enable agentrun-team
# 检查技能状态
openclaw skills check agentrun-team
(2)ClawHub安装
# 搜索技能
clawhub search "agentrun-team"
# 安装技能
clawhub install agentrun-team
# 更新技能至最新版本
clawhub update agentrun-team
(3)GitHub源码安装
# 进入技能工作目录
cd ~/.openclaw/workspace/skills
# 克隆技能仓库
git clone https://github.com/openclaw/agentrun-team.git ./agentrun-team
# 重启OpenClaw加载技能
openclaw restart
(4)自然语言自动安装(新手首选)
直接在Web UI交互界面发送指令:
“请帮我安装agentrun-team技能,GitHub链接为https://github.com/openclaw/agentrun-team”
2. 通讯基础配置
技能安装后,需完成钉钉通讯绑定,确保智能体团队可通过钉钉群协作:
# 配置钉钉全局适配器
openclaw config set adapter.dingtalk.enabled true
# 测试通讯连接
openclaw adapter test dingtalk
测试成功后,技能将自动为每个智能体绑定对应的钉钉机器人凭证。
(二)核心功能与协作机制
agentrun-team技能通过四大核心模块实现高效协作,无需手动配置协作规则:
1. 配置通讯基础
自动完成人工配置易出错的关键步骤,确保多智能体通讯顺畅:
- 统一身份标识:为每个Agent分配唯一Agent ID(如pm、dev、qa),作为消息路由和权限控制的基础。
- 全功能通讯绑定:自动绑定钉钉机器人,配置RobotCode,支持文字、图片、文件等多种消息类型。
- 安全互通:开启A2A通讯开关,配置Session可见性白名单,预设循环检测,防止智能体陷入死循环对话。
2. 构建团队意识
向OpenClaw的核心配置文件注入协作准则与团队信息,让每个Agent明确自身角色与协作规则:
- 追加至AGENTS.md(团队通讯录):
# 团队成员
你的队友:
- **<AgentID>** (<角色名称>): 负责<职责描述>
注:**粗体**部分是Agent ID,用于sessions_send查找和@mention
- 追加至SOUL.md(协作准则):
# 信任队友
- 在你的领域内交付高质量工作。队友也会这样做
- 任务更适合队友时,委派给他,然后等待
- 委派任务后,不要催促
- 不要替队友做他的工作
# 诚实汇报
- 当你觉得无法按时完成或者需要执行风险操作时,立即报告
- 遇到阻塞?立即报告,不要试图绕过
# 共享协作
共享文件区 (`/data/.openclaw/shared/`) 是团队协作的关键
- **需要分享给队友**的大文件、长文本结果必须存放在这里
- 不需要分享的私有文件,请存放在你自己的工作区
- 确保文件名清晰且便于审计
3. 统一文档协作
创建共享文件区作为协作中枢,避免信息孤岛:
- 共享文件路径:
/data/.openclaw/shared/,所有团队成员可访问读写。 - 文件命名规范:自动生成“日期-AgentID-任务名称”格式的文件名,便于审计与追溯。
- 大文件传输优化:通过文件共享替代A2A消息传递长文本,避免超时与Token浪费。
4. 确保协作闭环
设计双重汇报协议,解决原生机制30秒超时问题,确保任务委派与结果回传可靠:
- 委派任务后如何继续:
**理解返回值**: - 你会**立即**收到工具返回:`{ status: "accepted" }` - **含义**:任务已发送。 **接下来怎么做?** **策略 A:并行执行(无依赖)** - 如果你还有其他独立任务,不要等待,立即继续执行。 **策略 B:串行等待(强依赖)** - 如果你必须拿到队友的结果才能继续: - **动作**:告知User “已委派给 @<队友ID>,等待结果。” - **状态**:结束当前轮次(停止运行)。 - **恢复**:当队友通过`sessions_send`回复你时,你会收到一条新消息(被唤醒),届时读取内容继续工作。 - 接到任务后如何闭环:
**关键流程**: 1. **通知User开始** 收到任务后,立即用`message`工具在群里告知User你已接手。 **注意**:在消息开头**@上游AgentID**(即任务来源),以便清晰展示协作关系。 2. **执行任务** 3. **通知User完成** 完成任务后,先用`message`工具在群里向User汇报结果(同样需要**@上游AgentID**)。 4. **回传结果给队友** 同时,**必须**调用`sessions_send`将结果发回给委派任务的Agent,以便唤醒他继续工作。
(三)实战案例:10分钟搭建招投标与政策申报团队
1. 准备工作
- 已完成OpenClaw部署与API配置。
- 已创建3个钉钉机器人,记录各自的Client ID与Client Secret。
2. 一句话组建团队
在OpenClaw Control UI中发送组队指令,技能将自动完成团队创建:
帮我组建一个“招投标与政策申报团队”。
目标:监控“人工智能”、“大模型”、“数字化转型”相关的政府补贴政策及央企招标信息,每日早报推送,并对高价值项目进行申报可行性分析。
成员配置:
ID: policy_lead
名称: 申报主管
职责: 项目经理。负责根据公司资质筛选信息,指挥Writer进行深度解读,最终向我汇报。
钉钉凭证: dingtalk:<Client ID>:<Client Secret>
ID: radar
名称: 信息雷达
职责: 数据采集。利用搜索工具每日监控政府采购网、工信部等网站。
钉钉凭证: dingtalk:<Client ID>:<Client Secret>
ID: writer
名称: 材料撰写师
职责: 深度分析。阅读Radar提供的政策文件,输出“符合度分析报告”。
钉钉凭证: dingtalk:<Client ID>:<Client Secret>
发送后等待3-4分钟,直至页面提示“配置已就绪”,重启OpenClaw服务生效。
3. 激活团队成员
- 在钉钉新建群聊,将3个机器人拉入群中。
- 分别@每个机器人,发送激活指令(如“@申报主管 激活”),完成Agent与机器人的绑定。
4. 下达任务与协作流程
在钉钉群中@申报主管下达任务:
我们团队需要尽快切入浙江省的低空经济市场。请你带领团队完成一轮全省范围的商机摸排,重点关注浙江省政府采购网及各地市公共资源交易中心发布的最新招标信息。完成之后向我汇报。
团队协作流程:
- 申报主管(policy_lead)接收任务后,委派信息雷达(radar)执行全网扫描,并在群内告知用户“已委派给@radar,等待结果”。
- 信息雷达(radar)收到任务后,在群内@policy_lead告知“已接手扫描任务”,执行搜索工具完成招标信息采集,生成关键标段清单存入共享文件区,随后@policy_lead与用户汇报“扫描完成,关键标段清单已就绪”,并通过sessions_send唤醒申报主管。
- 申报主管(policy_lead)被唤醒后,对清单进行SWOT分析,再委派材料撰写师(writer)撰写技术方案,群内告知“已委派给@writer,等待方案输出”。
- 材料撰写师(writer)收到任务后,读取共享文件区的清单,完成方案骨架撰写,@policy_lead与用户汇报“方案撰写完成”,通过sessions_send回传结果。
- 申报主管(policy_lead)汇总清单、SWOT分析与方案,向用户交付最终成果。
五、常见问题排查(解决90%的使用问题)
(一)部署相关问题
启动失败提示“端口被占用”:
# Linux/MacOS查看占用18789端口的进程 lsof -i :18789 # 终止进程(替换PID为实际进程ID) kill -9 PID # Windows系统 netstat -ano | findstr :18789 taskkill /F /PID PID # 或修改配置文件更换端口(编辑config.json的port字段)依赖安装慢或失败:
- 切换国内镜像源:
npm config set registry https://registry.npmmirror.com - 清除npm缓存:
npm cache clean --force - 手动安装缺失依赖:根据错误提示执行
npm install 依赖库名称
- 阿里云服务器部署后无法访问:
- 检查服务器状态:阿里云控制台确认实例处于“运行中”状态。
- 验证端口开放:执行
firewall-cmd --list-ports(CentOS)或ufw status(Ubuntu),确认18789与8080端口已开放。 - 检查服务状态:
openclaw status,确保服务正常运行。
(二)API配置相关问题
- 调用提示“权限不足”或“密钥无效”:
- 检查密钥正确性:确认AccessKey ID/Secret无拼写错误,区分大小写。
- 验证额度与有效期:阿里云百炼控制台查看免费额度是否用尽,Coding Plan是否过期。
- 检查网络连通性:云端服务器选择香港/海外地域,避免国内网络限制。
- 模型切换后不生效:
- 执行
openclaw gateway restart重启网关,确保配置加载。 - 检查模型权限:确认已在对应平台开通目标模型的调用权限。
- 查看日志排查:
openclaw logs | grep llm,根据错误提示修正配置。
(三)多智能体协作相关问题
- 智能体无法接收委派任务:
- 检查A2A通讯开关:
openclaw config get agentToAgent.enabled,确保返回true。 - 验证Session可见性白名单:确认委派方与接收方Agent ID在白名单中。
- 重启通讯适配器:
openclaw adapter restart dingtalk
- 任务委派后无回应:
- 检查共享文件区权限:
chmod -R 777 /data/.openclaw/shared/(Linux/MacOS),确保智能体可读写。 - 查看协作日志:
openclaw logs | grep sessions_send,排查任务发送是否成功。 - 确认钉钉机器人状态:在钉钉开发者后台检查机器人是否正常运行,未被禁用。
- 协作过程未在钉钉群同步:
- 检查announce机制:
openclaw config get agentToAgent.announceToGroup,确保返回true。 - 验证机器人凭证:确认智能体配置的钉钉Client ID与Client Secret正确无误。
- 重新激活机器人:在钉钉群@机器人发送“重启”指令,重新绑定智能体。
(四)系统稳定性问题
- 多智能体运行时卡顿:
- 关闭冗余技能:仅启用agentrun-team及协作必需的技能,执行
openclaw skills disable <技能名称>。 - 升级硬件配置:云端部署可升级服务器至4核8G,本地部署关闭其他占用资源的程序。
- 清理缓存:
openclaw cache clear,释放存储空间。
- 智能体陷入死循环对话:
- 启用循环检测:
openclaw config set agentToAgent.maxPingPongTurns 10,限制最大对话轮次。 - 重启OpenClaw服务:
openclaw restart,终止当前会话。 - 调整协作规则:在SOUL.md中追加“避免重复委派同一任务”准则。
六、核心要点总结
- 部署方案选择:多智能体协作优先选择阿里云云端部署,支持7×24小时稳定运行,避免本地设备关机导致协作中断;本地部署适合测试场景,需确保硬件资源充足。
- 核心技能价值:agentrun-team技能是多智能体协作的关键,通过标准化协作规范、自动化配置流程,大幅降低搭建门槛,实现“一句话组建团队”。
- API配置技巧:新手可先使用免费大模型API熟悉协作流程,复杂场景切换阿里云百炼Coding Plan,支持多模型切换,适配不同智能体的功能需求。
- 协作注意事项:钉钉机器人是多智能体通讯的核心,需确保每个智能体绑定独立机器人;共享文件区是信息同步的关键,需规范文件命名与访问权限。
- 问题排查逻辑:遇到协作异常,优先排查“通讯连接→权限配置→日志信息→硬件资源”,多数问题可通过重启服务、重新激活机器人或修正配置解决。
OpenClaw的多智能体协作能力,本质是通过专业分工提升复杂任务的执行效率。通过本文的流程与技巧,用户可在1小时内完成全流程部署与团队搭建,让智能体团队像真实员工一样自动拆解任务、协作执行、实时汇报,真正解放重复劳动,专注核心决策。如需进一步拓展功能,可探索自定义协作规则、添加更多角色智能体等进阶内容,持续挖掘多智能体协作的潜力。