夜雨聆风OpenClaw+飞书+智谱AI多Agent协同实操教程｜零基础搭建专属智能协作团队
本文聚焦OpenClaw+飞书+智谱AI多Agent协同核心实操，全程干货无废话，手把手教你在Mac本地搭建由1个主智能体+5个子智能体组成的专业协作团队，实现产品、开发、测试、架构、运维的分工协同，同时附上避坑指南、常用命令和双机器人部署对比，零基础也能直接跟着操作。
本次实操核心目标：搭建“编程牛马小分队”智能体团队，主智能体统筹协调，5个子智能体各司其职，实现AI多角色并行协作，可直接应用于写作、编程、项目开发等各类场景。
一、前期准备：硬件+软件+账号，提前备齐不踩坑
搭建前需确保所有准备工作到位，磁盘空间和软件版本是核心，避免后续出现莫名报错，具体清单如下：
「硬件要求」
Mac笔记本（重点：保证足够磁盘空间，建议清理出80G以上，否则会出现权限、启动等各类问题）。
「软件要求」
node.js ≥22版本（后续需验证版本，低于22需升级）； Homebrew（Mac万能软件安装神器，后续用于环境搭建）。
「账号/密钥准备」
智谱AI账号：获取API Key（用于OpenClaw配置大模型，需提前在智谱AI开放平台申请）； 飞书个人账号：需注册并登录飞书开发者平台（https://open.feishu.cn/app），用于创建智能体应用。
二、环境搭建：一步一步操作，核心命令直接复制
本阶段为基础核心，涵盖Homebrew安装、Node版本验证、飞书应用创建、OpenClaw安装，所有命令可直接复制，按提示操作即可。
1. 安装Homebrew（Mac专属）
执行以下一键安装命令，按终端提示操作：
/bin/bash -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"步骤1：按提示选择1，再选择5； 步骤2：安装完成后按提示重启命令行终端，或执行 source .zprofile；验证：输入 brew -v，显示版本号（如Homebrew 5.0.15）即安装成功。
2. 验证Node.js版本
打开终端，直接输入以下命令验证版本：
node -v结果：显示版本号≥22（如v24.13.1）即满足要求； 若版本过低：需通过Homebrew升级node，确保符合最低要求。
3. 创建飞书企业自建应用
所有智能体需对应独立飞书应用，1个智能体=1个应用，步骤如下：
打开飞书开发者平台（https://open.feishu.cn/app），选择企业自建应用（个人/企业飞书均选此选项）； 为6个智能体（1主+5子）分别创建应用，命名建议：程序员openclaw小助手（主）、产品经理-openclaw小助手、开发-openclaw小助手、测试-openclaw小助手、架构师-openclaw小助手、运维-openclaw小助手； 为每个应用添加机器人能力，并导入完整权限清单（核心权限含im:message、contact:contact.base、docs:document.content等，确保智能体可收发消息、访问文档、操作群聊）； 核心权限配置代码块可直接复制使用： {"scopes": {"tenant": ["contact:contact.base:readonly", "aily:file:read", "aily:file:write","im:chat", "im:message", "im:message:send_as_bot", "docs:document.content:read"],"user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]}}每个应用创建完成后，记录App ID和App Secret（后续OpenClaw配置需使用，务必妥善保存）。
4. 一键安装OpenClaw
终端输入以下一键安装命令，全程不要中断网络，按向导逐步选择配置：
curl -fsSL https://openclaw.ai/install.sh | bash关键配置选择（按顺序）：
提示“Continue?”：选择Yes； Onboarding mode：选择Quick Start； Model/auth provider：选择Z.AI（智谱AI）； Z.AI auth method：选择Coding-Plan-CN； 输入智谱AI API Key，选择模型zai/glm-4.7（可按需求更换）； 接入渠道：选择Feishu/Lark（飞书）； Install Feishu plugin?：选择Download from npm； App Secret提供方式：选择Enter App Secret，输入飞书主应用的App ID和App Secret； Feishu connection mode：选择WebSocket（Mac本地运行必选）； Feishu domain：选择Feishu (feishu.cn) - China； Group chat policy：选择open； skills：暂时跳过，后续按需添加； Enable hooks?：按空格全选； 交互方式：选择Hatch in TUI（推荐）。
验证安装：
输入openclaw --version，显示版本号（如2026.3.2）即安装成功。
三、智能体配置：1主5子，独立隔离+跨体通信
本阶段是多Agent协同的核心，实现主智能体统筹、子智能体分工，关键要求：每个智能体配置独立工作空间，避免上下文污染，步骤如下：
1. 配置主智能体机器人（核心统筹）
主智能体负责任务拆解、分配、协调和结果汇总，需完成事件与回调配置：
进入飞书开发者平台主应用配置界面，找到事件与回调； 订阅方式选择使用长链接接收事件（无需公网域名，本地运行首选）； 添加事件im.message.receive_v1，开通对应权限； 回调配置同理选择长链接接收回调，完成后发布应用版本（版本号建议1.0.0）； 飞书内找到主智能体机器人，发送任意消息，获取配对码； 打开新终端，执行配对命令 openclaw pairing approve feishu，提示“Approved”即配对成功。
2. 配置5个子智能体机器人（专业分工）
通过主智能体聊天框发送指令，自动完成子智能体配置，无需手动操作：
飞书内给主智能体机器人发送以下配置指令（替换对应App ID和App Secret）： 帮我配置其他几个飞书渠道bot，飞书支持多账号，但要用 accounts 结构，并且将渠道的dmPolicy 和groupPolicy改为open，allowFrom设置为["*"]，配置完成后自动重启：id: test name: 测试达人 App ID: 【你的测试应用ID】 App Secret: 【你的测试应用密钥】id: dev name: 开发达人 App ID: 【你的开发应用ID】 App Secret: 【你的开发应用密钥】id: pm name: 产品达人 App ID: 【你的产品应用ID】 App Secret: 【你的产品应用密钥】id: sa name: 架构达人 App ID: 【你的架构应用ID】 App Secret: 【你的架构应用密钥】id: ops name: 运维达人 App ID: 【你的运维应用ID】 App Secret: 【你的运维应用密钥】若提示配置完成但未自动重启，终端执行重启命令： openclaw gateway restart；验证配置：终端输入 openclaw gateway status，显示“Runtime: running”即状态正常；按主智能体配置步骤，为5个子智能体分别完成事件与回调配置+应用发布。
3. 绑定独立工作空间+开启跨智能体通信
（1）绑定独立workspace
给主智能体发送以下指令，为每个智能体配置独立工作空间，避免数据混杂：
参考channel的配置添加agents和bindings，每个agent的workspace需要隔离，不能是同一个目录，配置完成后重启：{"agents": {"list": [{"id": "main", "default": true, "name": "程序员openclaw小助手", "workspace": "/root/.openclaw/workspace"},{"id": "test", "name": "测试达人", "workspace": "/root/.openclaw/workspace-test"},{"id": "dev", "name": "开发达人", "workspace": "/root/.openclaw/workspace-dev"},{"id": "pm", "name": "产品达人", "workspace": "/root/.openclaw/workspace-pm"},{"id": "sa", "name": "架构达人", "workspace": "/root/.openclaw/workspace-sa"},{"id": "ops", "name": "运维达人", "workspace": "/root/.openclaw/workspace-ops"}]},"bindings": [{"agentId": "main", "match": {"channel": "feishu", "accountId": "main"}},{"agentId": "test", "match": {"channel": "feishu", "accountId": "test"}},{"agentId": "dev", "match": {"channel": "feishu", "accountId": "dev"}},{"agentId": "pm", "match": {"channel": "feishu", "accountId": "pm"}},{"agentId": "sa", "match": {"channel": "feishu", "accountId": "sa"}},{"agentId": "ops", "match": {"channel": "feishu", "accountId": "ops"}}]}（2）开启跨智能体通信
给主智能体发送指令，实现主、子智能体之间的高效协同：
配置开启所有agent之间的通信agentToagent提示“agent-to-agent通信已开启”即配置成功，所有智能体可互相交互、同步信息。
四、人设配置：3大核心文件，定义智能体“岗位职责”
为每个智能体配置SOUL.md、AGENTS.md、USER.md三大文件，明确核心人格、职责分工、用户信息，避免工作混乱，直接和对应智能体私聊发送配置指令即可自动创建。
1. 三大文件核心作用
SOUL.md：定义智能体核心人格、行为准则、工作底线（如主智能体的“统筹协调、任务闭环”原则）； AGENTS.md：明确所有智能体的角色清单、核心职责、协作规则（如开发负责代码编写，测试负责用例设计）； USER.md：记录团队名称、用户称呼、时区等信息（让智能体交互更贴合实际场景）。
2. 主智能体（程序员openclaw小助手）核心配置示例
「SOUL.md」（核心准则+行为原则+底线）
## 核心准则1. 你是程序开发多角色协作体系的核心协调者，连接开发、产品、测试、架构、运维的关键枢纽；2. 专注编程工作全流程管控：任务拆解、角色分配、进度跟踪、跨角色协调；3. 以“高效落地用户需求”为核心目标，平衡各角色工作负荷。## 行为原则1. 先规划再分配：接收任务后先输出结构化规划，再分配至对应角色；2. 结构化汇报：遵循“结果+进度+问题+解决方案”逻辑；3. 任务闭环管理：所有任务跟踪至完成，不遗留半截任务。## 底线1. 不随意变更任务范围，确需变更需同步所有相关角色；2. 不隐瞒阻塞问题，发现后10分钟内同步协调；3. 不越权决策专业问题，仅负责协调推动，最终决策交对应角色。「AGENTS.md」（角色清单+协作规则）
## 核心角色列表main(程序员openclaw小助手)：整体规划、跨角色协调、进度跟踪dev(开发)：代码编写、功能实现、Bug修复pm(产品)：需求梳理、功能设计、输出产品文档test(测试)：测试计划、功能测试、输出测试报告sa(架构)：技术架构设计、技术选型、性能优化ops(运维)：部署上线、环境配置、故障排查## 角色协作规则1. main统一接收任务并分配，定期汇总进度；2. dev配合pm确认需求、配合test修复Bug；3. test基于pm需求文档和dev功能清单制定测试方案；4. sa为dev提供技术指导、为ops提供部署建议。「USER.md」（用户信息）
我们都在编程牛马小分队一起工作，你是程序员openclaw小助手，你可以称呼我为【你的称呼】小队长3. 子智能体配置
子智能体仅需根据自身角色，修改SOUL.md的核心准则和职责，AGENTS.md和USER.md与主智能体保持一致，例如产品智能体聚焦“需求梳理、产品设计”，开发智能体聚焦“代码实现、版本迭代”。
五、团队搭建与协同调试：从配置到实战，实现真正多角色协作
1. 搭建飞书协作群
飞书创建群聊，命名“编程牛马小分队”； 将1主5子共6个智能体全部拉入群聊，完成团队搭建。
2. 调试协同模式（推荐混合模式）
初期配置后智能体可能存在“主智能体单角色扮演”问题，需配置混合协作模式，兼顾效率和透明性：
群内@主智能体，发送指令： 配置混合协作模式，默认汇总结果，需要时可展开子智能体工作详情；验证模式：群内提出具体需求（如“开发一个低龄儿童古诗带背小工具”），主智能体将自动分配任务，子智能体后台独立工作； 结果反馈：子智能体完成任务后，由主智能体汇总结果并同步，需查看详情时，@主智能体发送“查看XX子智能体工作详情”即可。
3. 核心协同流程（实战示例）
用户@主智能体提出需求； 主智能体输出结构化任务规划，分配至对应子智能体； 子智能体后台独立执行任务（如pm做需求分析、dev做代码开发）； 子智能体完成后同步结果给主智能体； 主智能体汇总所有结果，向用户同步最终成果； 若有问题，用户反馈给主智能体，由主智能体协调子智能体迭代优化。
六、双机器人部署对比：腾讯云版VS Mac本地版，按需选择
实操中可搭建两大机器人，分别部署在腾讯云和Mac本地，适配不同使用场景，核心差异如下，可根据自身需求选择：
七、必备干货：常用命令+常见问题，避坑事半功倍
1. OpenClaw核心常用命令（直接复制）
openclaw gateway status | |
openclaw gateway restart | |
openclaw doctor --fix | |
openclaw pairing approve feishu |
重点推荐：openclaw doctor --fix，配置出错、启动失败、权限异常时，执行此命令可自动修复配置+备份原文件+重启服务，解决90%的常见问题。
2. 常见问题及解决方案（避坑核心）
（1）配置子智能体时提示“无权限访问文件系统”
解决方案：打开配置文件 ~/.openclaw/openclaw.json，将"profile":"messaging"修改为以下内容，启用文件工具权限：
修改后执行重启命令即可。"tools":{"profile":"full"}
（2）重启OpenClaw后无反应，状态显示“异常”
解决方案：先执行 openclaw gateway status查看错误提示，再执行openclaw doctor --fix，系统会自动诊断并修复，按提示操作即可。
（3）子智能体未独立工作，仍由主智能体单角色扮演
解决方案：① 检查各智能体workspace是否独立，非独立则重新发送绑定指令；② 确认 agentToagent通信已开启；③ 执行openclaw doctor --fix修复配置。
（4）安装/配置中出现各类“莫名报错”
核心解决方案：清理干净环境后重新安装，删除本地node、npm、OpenClaw相关文件，在纯干净环境下重新执行安装步骤（环境越干净，问题越少）。
（5）飞书机器人无响应，无法收发消息
解决方案：① 检查飞书应用是否已发布版本（未发布则无法正常使用）；② 验证应用权限是否完整导入；③ 执行 openclaw gateway restart重启服务。
八、多Agent协同核心价值：为什么比“全能单Agent”更高效？
很多人疑惑为何要搭建复杂的多Agent体系，而非使用单一全能Agent，核心差异在于专业分工、并行协作、上下文隔离，具体对比如下，更贴合实际工作场景：
简单来说，多Agent协同就是用AI打造专属的专业团队，主智能体做“项目经理”，子智能体做“各领域专家”，各司其职、高效协同，让AI提效真正落地。
文末互动
你在OpenClaw或多Agent协同实操中遇到了哪些问题？还有哪些想解锁的AI工具实操教程？欢迎在评论区留言分享，一起交流学习，玩转AI提效！
