OpenClaw多Agent配置飞书:打造专属AI打工团队

发布于:2026-03-06 · #openclaw

我们在数字化办公时代,单一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配置实现精准路由

JSON
UTF-8|12 Lines|
{
  "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. 创建飞书企业自建应用

  1. 访问飞书开放平台
  2. 点击”创建企业自建应用”,填写应用名称(如”OpenClaw助手”)
  3. 在”凭据与基础信息”中获取App IDApp Secret(务必保存好)

2. 配置飞书权限

在飞书应用管理页面,点击”权限管理” → “批量导入权限”,粘贴以下权限配置:

JSON
UTF-8|39 Lines|
{
  "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. 配置飞书回调

  1. 在飞书应用管理页面,点击”事件与回调”
  2. 选择”长连接接收事件”,点击”保存”
  3. 添加”接收消息”事件:im.message.receive_v1

OpenClaw多Agent配置

所以现在我们可以把一个Agent看作是我们一个新入职的员工,让我来创建它们各自的隔离工作区。

1. 创建Agent

Bash
UTF-8|8 Lines|
# 创建默认Agent(日常使用)
openclaw agents add main --workspace ~/.openclaw/workspace

# 创建DevOps专属Agent
openclaw agents add devops-agent --workspace ~/.openclaw/workspace-devops

# 查看已创建的Agent
openclaw agents list

输出例子:

Bash
UTF-8|9 Lines|
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.5

2. 配置OpenClaw核心文件

编辑~/.openclaw/openclaw.json

JSON
UTF-8|56 Lines|
{
  "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身份与工作规则

  1. 创建IDENTITY.md(定义Agent身份)
Markdown
UTF-8|11 Lines|
# Agent: DevOps Guardian

## Role
你是一个高级 DevOps 运维专家,负责监控服务器状态、编写自动化脚本和处理报警。
请保持专业、简洁的工程师沟通风格。

## Theme & Vibe
Cyber Security / Server Room Blue

## Avatar & Emoji
⚙️
  1. 创建AGENTS.md(定义工作规则)
Markdown
UTF-8|22 Lines|
# 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身份

Bash
UTF-8|2 Lines|
cd ~/.openclaw/workspace-devops
openclaw agents set-identity --agent devops-agent --from-identity

4. 配对飞书机器人

完成配置后请找到并且发布飞书机器人应用-然后在飞书当中找到机器人,飞书机器人会提示配对:

Bash
UTF-8|5 Lines|
OpenClaw: access not configured.
Your Feishu user id: xxx
Pairing code: NJJA2C6S
Ask the bot owner to approve with: 
openclaw pairing approve feishu NJJA2C6S

执行配对命令

Bash
UTF-8|1 Line|
openclaw pairing approve feishu NJJA2C6S

验证成功:配对后,机器人将正常响应飞书消息。

场景:飞书群组中的AI团队协作

  1. 创建飞书群组
    • “AI研发部”(包含两个机器人:maindevops-agent
  2. 日常协作流程
    • @main:“读取data.csv文件,生成折线图和趋势分析”
    • @devops-agent:“部署ceic-sh-sso-gateway到生产环境”
  3. 系统响应
    • main Agent处理数据,生成图表
    • devops-agent Agent执行部署命令,返回详细结果
    • 两个Agent在同一个群组中协作,但使用独立工作区

进阶建议:为不同Agent配置专属技能(skills/目录),例如为DevOps Agent配置deploy.sh脚本,为文案Agent配置SEO-optimization.md规则。