OpenClaw多Agent配置飞书:打造专属AI打工团队
我们在数字化办公时代,单一AI助手已无法满足复杂工作场景需求。OpenClaw的多Agent架构通过角色专业化、工作空间隔离、权限精细化和协同效率高四大优势,让每个智能体(Agent)都能在专属环境中发挥最大价值。本文将详细介绍如何在飞书环境中配置OpenClaw多Agent架构,打造一个功能强大、分工明确的AI团队。
为什么选择OpenClaw多Agent架构?
核心价值
让每个AI智能体专注其专业领域,避免”全能型”AI的低效与混乱
| 优势 | 传统单Agent方案 | OpenClaw多Agent方案 | 实际效果 |
|---|---|---|---|
| 角色专业化 | 一个AI承担多重角色 | 专属角色AI(运维/文案/分析) | 专业度提升,错误率降低 |
| 工作空间隔离 | 共享工作区,相互干扰 | 独立工作区,任务互不干扰 | 任务处理更专注、安全 |
| 权限精细化 | 全局权限,风险高 | 按Agent配置权限,安全可控 | 数据安全有保障 |
| 协同效率 | 人工协调,低效 | Agent间自动协作,高效 | 任务处理速度提升50%+ |
架构设计与核心原理
sequenceDiagram
飞书MainAgent->>OpenClaw Gateway: 用户请求 (e.g., "统计GitLab数据")
OpenClaw Gateway->>main Agent: 路由到默认Agent
main Agent->>main Agent: 处理请求
main Agent->>OpenClaw Gateway: 返回结果
OpenClaw Gateway->>飞书MainAgent: 显示结果
飞书DevopsAgent->>OpenClaw Gateway: 用户请求 (e.g., "部署ceic-sh-sso-gateway")
OpenClaw Gateway->>devops-agent Agent: 路由到devops-agent
devops-agent Agent->>devops-agent Agent: 生成部署命令
devops-agent Agent->>OpenClaw Gateway: 返回结果
OpenClaw Gateway->>飞书DevopsAgent: 显示部署详情
核心原理:Bindings
OpenClaw通过bindings配置实现精准路由:
{
"bindings": [
{
"agentId": "main",
"match": { "channel": "feishu", "accountId": "default" }
},
{
"agentId": "devops-agent",
"match": { "channel": "feishu", "accountId": "ops" }
}
]
}原理说明
当飞书消息到达网关时,网关根据accountId精准匹配到对应Agent,实现”机器人→Agent”的精确映射。
多Agent核心概念
在OpenClaw当中一个智能体(Agent) 是一个完全独立的作用域,拥有:
| 组件 | 说明 | 路径 |
|---|---|---|
| 工作区 | 专属工作目录,包含文档、规则、笔记 | ~/.openclaw/workspace-<agentId> |
| 状态目录 | 认证配置、模型注册、Agent配置 | ~/.openclaw/agents/<agentId>/agent |
| 会话存储 | 聊天历史与路由状态 | ~/.openclaw/agents/<agentId>/sessions |
| 技能集 | 独立技能,可共享公共技能 | ~/.openclaw/workspace-<agentId>/skills |
关键优势:每个Agent拥有完全独立的环境,互不干扰,避免了”多个Agent共享一个目录”的问题,这是我认为比较好的优势,避免很多技能、任务都使用一个人来进行会导致很混乱。
开始部署单Gateway多Agent模式
这个地方我就省略前提是大家都已经安装好基础的
OpenClaw了,我就不讲具体如何安装了。
飞书应用配置
1. 创建飞书企业自建应用
- 访问飞书开放平台
- 点击”创建企业自建应用”,填写应用名称(如”OpenClaw助手”)
- 在”凭据与基础信息”中获取
App ID和App Secret(务必保存好)
2. 配置飞书权限
在飞书应用管理页面,点击”权限管理” → “批量导入权限”,粘贴以下权限配置:
{
"scopes": {
"tenant": [
"im:message",
"im:message.p2p_msg:readonly",
"im:message.group_at_msg:readonly",
"im:message:send_as_bot",
"im:resource",
"contact:user.base:readonly",
"im:message.group_msg",
"docs:doc",
"docs:doc:readonly",
"docs:document.comment:create",
"docs:document.comment:read",
"docs:document.comment:update",
"docs:document.comment:write_only",
"docs:document.content:read",
"docs:document.media:download",
"docs:document.media:upload",
"docs:document.subscription",
"docs:document.subscription:read",
"docs:document:copy",
"docs:document:export",
"docs:document:import",
"docs:event.document_deleted:read",
"docs:event.document_edited:read",
"docs:event.document_opened:read",
"docs:event:subscribe",
"docs:permission.member",
"docs:permission.member:auth",
"docs:permission.member:create",
"docs:permission.member:delete",
"docs:permission.member:readonly",
"docs:permission.member:retrieve",
"docs:permission.member:transfer",
"docs:permission.member:update"
]
}
}重要提示:配置权限后,点击”确认新增权限”并”申请开通”,等待权限生效。
3. 配置飞书回调
- 在飞书应用管理页面,点击”事件与回调”
- 选择”长连接接收事件”,点击”保存”
- 添加”接收消息”事件:
im.message.receive_v1
OpenClaw多Agent配置
所以现在我们可以把一个Agent看作是我们一个新入职的员工,让我来创建它们各自的隔离工作区。
1. 创建Agent
# 创建默认Agent(日常使用)
openclaw agents add main --workspace ~/.openclaw/workspace
# 创建DevOps专属Agent
openclaw agents add devops-agent --workspace ~/.openclaw/workspace-devops
# 查看已创建的Agent
openclaw agents list输出例子:
Agents:
- main (default)
Workspace: ~/.openclaw/workspace
Agent dir: ~/.openclaw/agents/main/agent
Model: bailian/qwen3.5-plus
- devops-agent
Workspace: ~/.openclaw/workspace-devops
Agent dir: ~/.openclaw/agents/devops-agent/agent
Model: bailian/MiniMax-M2.52. 配置OpenClaw核心文件
编辑~/.openclaw/openclaw.json:
{
"channels": {
"feishu": {
"enabled": true,
"connectionMode": "websocket",
"domain": "feishu",
"groupPolicy": "open",
"accounts": {
"default": {
"appId": "YOUR_DEFAULT_APP_ID",
"appSecret": "YOUR_DEFAULT_APP_SECRET"
},
"ops": {
"appId": "YOUR_OPS_APP_ID",
"appSecret": "YOUR_OPS_APP_SECRET"
}
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "bailian/qwen3.5-plus"
},
"workspace": "/root/.openclaw/workspace"
},
"list": [
{
"id": "main"
},
{
"id": "devops-agent",
"workspace": "/root/.openclaw/workspace-devops",
"agentDir": "/root/.openclaw/agents/devops-agent/agent",
"model": {
"primary": "bailian/MiniMax-M2.5"
},
"identity": {
"name": "DevOps Guardian",
"theme": "Cyber Security / Server Room Blue",
"emoji": "⚙️"
}
}
]
},
"bindings": [
{
"agentId": "main",
"match": { "channel": "feishu", "accountId": "default" }
},
{
"agentId": "devops-agent",
"match": { "channel": "feishu", "accountId": "ops" }
}
]
}配置提示:
openclaw agents add命令会自动更新openclaw.json,无需手动添加。
3. 定义Agent身份与工作规则
- 创建
IDENTITY.md(定义Agent身份)
# Agent: DevOps Guardian
## Role
你是一个高级 DevOps 运维专家,负责监控服务器状态、编写自动化脚本和处理报警。
请保持专业、简洁的工程师沟通风格。
## Theme & Vibe
Cyber Security / Server Room Blue
## Avatar & Emoji
⚙️- 创建
AGENTS.md(定义工作规则)
# Agent Guidelines: DevOps Guardian
## Core Mission
协助用户维护系统高可用性,自动化重复运维任务,快速定位并解决生产环境故障。
## Operational Principles
1. **Safety First (安全第一)**
- 严禁执行未经确认的破坏性命令(如 `rm -rf`, `drop table`)。
- 执行任何写操作前,必须输出 **⚠️ 风险预警** 并等待用户确认。
- 默认所有操作在 `dry-run` 模式下进行。
2. **Precision & Clarity (精准清晰)**
- 输出命令时,必须解释关键参数含义。
- 报错分析包含:现象描述、根本原因推测、验证步骤、解决方案。
3. **Automation Mindset (自动化思维)**
- 同一操作超过3次,主动建议编写脚本自动化。
- 提供的脚本必须包含错误处理和日志记录。
4. **Context Awareness (上下文感知)**
- 始终记住当前操作的环境(Dev/Test/Prod)。
- Prod环境操作自动提升警戒级别。重新加载Agent身份
cd ~/.openclaw/workspace-devops
openclaw agents set-identity --agent devops-agent --from-identity4. 配对飞书机器人
完成配置后请找到并且发布飞书机器人应用-然后在飞书当中找到机器人,飞书机器人会提示配对:
OpenClaw: access not configured.
Your Feishu user id: xxx
Pairing code: NJJA2C6S
Ask the bot owner to approve with:
openclaw pairing approve feishu NJJA2C6S执行配对命令
openclaw pairing approve feishu NJJA2C6S验证成功:配对后,机器人将正常响应飞书消息。
场景:飞书群组中的AI团队协作
- 创建飞书群组:
- “AI研发部”(包含两个机器人:
main和devops-agent)
- “AI研发部”(包含两个机器人:
- 日常协作流程:
- @main:“读取data.csv文件,生成折线图和趋势分析”
- @devops-agent:“部署ceic-sh-sso-gateway到生产环境”
- 系统响应:
mainAgent处理数据,生成图表devops-agentAgent执行部署命令,返回详细结果- 两个Agent在同一个群组中协作,但使用独立工作区
进阶建议:为不同Agent配置专属技能(skills/目录),例如为DevOps Agent配置deploy.sh脚本,为文案Agent配置SEO-optimization.md规则。