前言¶

在飞书群里同时跑多个 AI 机器人时，常见做法是「一个应用、一个机器人」各自进群，但 OpenClaw 侧还要把多个 agent、多套飞书凭据和路由规则对齐：agents.list、channels.feishu.accounts、bindings 和 openclaw-lark 插件缺一不可。手工改 openclaw.json 容易漏绑定或把访问控制写错。

下面介绍 SkillHub 社区 Skill feishu-multi-agent-s（坐标 @user_51c8b977/feishu-multi-agent-s）。它是一份面向 Agent 的配置指南，帮助按步骤完成「多 OpenClaw agent ↔ 多飞书自建应用」的绑定，并在同一群聊场景下说明智能体如何协作。

这是什么¶

feishu-multi-agent-s 归类为 ai-agent，版本 1.0.0，来源为 community，由发布者 user_51c8b977 维护。Skill 包内 frontmatter 中的名称为 feishu-multi-agent，对外 SkillHub 坐标为 feishu-multi-agent-s。

一句话定位：自动配置多智能体绑定多飞书机器人——即指导你为每个 agent 准备独立飞书应用，在 OpenClaw 中完成多账号、多绑定，并说明群聊内 bot 间如何通过 OpenClaw 内部机制协作（而非依赖飞书把机器人消息再投递给其他机器人）。

SkillHub 页面标注标签 requires_api_key=true，对应实际流程中每个飞书自建应用需要的 AppID / AppSecret 等凭据，而非 Skill 安装本身额外收费。

核心功能¶

依据 Skill 包内 SKILL.md 与参考文档，已核实能力如下。

多 agent 与多飞书应用一一对应¶

每个 OpenClaw agent 对应一个飞书自建应用（AppID + AppSecret）。
要求每个应用开启机器人能力、WebSocket 长连接，并加入目标群聊。
依赖已安装的 openclaw-lark 插件。

OpenClaw 四类配置块¶

配置围绕 openclaw.json（或等价配置）中的四部分，详细字段见包内 references/config-template.md：

agents.list：定义每个 agent（id、name、workspace 等）。
channels.feishu.accounts：为每个飞书应用配置 appId、appSecret，并在 default 账号下集中 dmPolicy / groupPolicy 等访问控制。
bindings：用 match.channel: "feishu" 与 match.accountId 把飞书账号路由到对应 agentId。
plugins.entries.openclaw-lark：必须启用该插件。

常用频道项还包括 connectionMode: "websocket"、requireMention（群聊需 @ 才回复）、groups 通配启用等。

智能体间协作方式¶

飞书 WebSocket 不会把其他机器人发出的消息当作事件推送给别的机器人。Skill 明确建议在 OpenClaw 内部使用：

sessions_send(agentId: "xxx", message: "...") — 向另一 agent 发消息并等待回复；
sessions_list — 查看活跃 session；
sessions_spawn — 启动子 agent 处理子任务。

协作规则可写在各 agent 的 SOUL.md 或 AGENTS.md 中。

验证与排障¶

配置完成后执行：

openclaw gateway restart
openclaw doctor

references/troubleshooting.md 覆盖配置 JSON 校验、群消息不回复、访问控制层级、多账号 auth-profiles 路径、WebSocket 断开与 agent 间消息循环等场景。

安装与启用¶

Skill 基于通用 SKILL.md 格式，安装后由 Cursor、Claude Code 等 Agent 读取并照步骤改配置。

1、安装 SkillHub CLI（若尚未安装）¶

command -v skillhub && skillhub --version

未安装时可按 SkillHub 官方说明执行（完整安装示例）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

2、安装本 Skill 到当前 Agent 的 skills 目录¶

安装时必须使用 --dir 指向当前客户端识别的 skills 目录，否则默认落在 ./skills/ 可能不会被加载。

skillhub install feishu-multi-agent-s --namespace user_51c8b977 --dir <你的 skills 目录>

SkillHub 页面亦提供等价提示：根据 https://skillhub.cn/install/skillhub.md 安装 @user_51c8b977/feishu-multi-agent-s。

常见路径（来自 SkillHub 安装文档）：

Cursor：~/.cursor/skills/
Claude Code：~/.claude/skills/
Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装后按你所用客户端要求重启或刷新 Agent，使 Skill 生效。

3、启用前的 OpenClaw 侧准备¶

按 Skill 前置条件：为每个 agent 在飞书开放平台创建应用，开启机器人与所需权限（如 im:message、im:message:send_as_bot、im:chat:readonly），事件订阅 im.message.receive_v1（WebSocket 模式，无需公网回调），并确保 openclaw-lark 已安装。

典型用法¶

下面步骤来自 Skill 包内文档，以两个 agent（main 与 agent-b）为例，可类推至更多智能体。

1、飞书侧：创建 N 个应用¶

每个 agent 一个飞书应用，记录各自的 AppID、AppSecret，并将机器人拉入同一目标群聊。

2、OpenClaw 侧：写入多账号与绑定¶

在配置中同时维护 agent 列表、飞书多账号、bindings 与插件。结构示意（字段含义见 references/config-template.md）：

{
  "agents": {
    "list": [
      { "id": "main", "default": true, "name": "虾头", "workspace": "..." },
      { "id": "agent-b", "name": "小助手", "workspace": "..." }
    ]
  },
  "channels": {
    "feishu": {
      "enabled": true,
      "connectionMode": "websocket",
      "requireMention": true,
      "defaultAccount": "main",
      "accounts": {
        "main": { "appId": "cli_aaaaaaa", "appSecret": "xxxxxx", "name": "虾头" },
        "agent-b": { "appId": "cli_bbbbbbb", "appSecret": "yyyyyy", "name": "小助手" },
        "default": {
          "dmPolicy": "allowlist",
          "allowFrom": ["ou_your_open_id"],
          "groupPolicy": "allowlist",
          "groupAllowFrom": ["ou_your_open_id"]
        }
      },
      "groups": { "*": { "enabled": true } }
    }
  },
  "bindings": [
    { "agentId": "main", "match": { "channel": "feishu", "accountId": "main" } },
    { "agentId": "agent-b", "match": { "channel": "feishu", "accountId": "agent-b" } }
  ],
  "plugins": {
    "entries": { "openclaw-lark": { "enabled": true } },
    "allow": ["openclaw-lark"]
  }
}

绑定路由优先级（高到低）：peer 精确匹配 → accountId（本方案常用）→ channel → agents.list 中 default: true 的 agent。

扩展到第三个 agent 时：新建飞书应用 → 在 agents.list、accounts、bindings 各增一项 → 执行 openclaw gateway restart。

3、群聊内协作¶

用户 @ 不同机器人时，各自 WebSocket 连接按 accountId 区分事件。若要让 agent 互相配合，在 SOUL.md 中约定何时调用 sessions_send，并参考排障文档避免互相 sessions_send 造成循环。

适用场景与注意¶

适合谁

已在用 OpenClaw + openclaw-lark，希望在同一个飞书群里部署多个角色分明的 agent（例如协调者与执行者）。
希望由 Agent 按 checklist 生成/核对 openclaw.json，而不是从零翻官方文档拼字段。

限制与注意

本 Skill 是配置与协作说明，不替代飞书开放平台审批、企业安全策略或 OpenClaw 本身的部署。
openclaw.json 在运行环境中通常为标准 JSON；排障文档指出非法 JSON（误加注释或 emoji 等）会导致 openclaw doctor 报 Config invalid，可用 node -e "JSON.parse(...)" 自检。
groupAllowFrom 填写的是发送者 open_id（ou_xxx），不是群 ID（oc_xxx）；群级开关在 channels.feishu.groups。
每个 agent 的凭据位于 ~/.openclaw/agents/<agentId>/agent/auth-profiles.json，默认不共享；需要共享时需手动复制（见排障文档）。
SkillHub 统计（以抓取资料为准）：评分 100000，下载 724 次；页面数据会变动，以 SkillHub 为准。

结尾¶

feishu-multi-agent-s 把「多飞书机器人 + 多 OpenClaw agent + 同群协作」拆成可执行的配置清单与模板，并交代飞书事件模型下 bot 间应走 OpenClaw 内部会话工具。若你正在搭这类架构，可从 SkillHub 安装该 Skill，再按包内 config-template.md 与 troubleshooting.md 落地。

SkillHub 页面：https://www.skillhub.cn/skills/user_51c8b977/feishu-multi-agent-s
API / 元数据地址：https://api.skillhub.cn/user_51c8b977/feishu-multi-agent-s

feishu-multi-agent-s：在同一飞书群聊中配置多 OpenClaw 智能体

前言¶

这是什么¶

核心功能¶

多 agent 与多飞书应用一一对应¶

OpenClaw 四类配置块¶

智能体间协作方式¶

验证与排障¶

安装与启用¶

1、安装 SkillHub CLI（若尚未安装）¶

2、安装本 Skill 到当前 Agent 的 skills 目录¶

3、启用前的 OpenClaw 侧准备¶

典型用法¶

1、飞书侧：创建 N 个应用¶

2、OpenClaw 侧：写入多账号与绑定¶

3、群聊内协作¶

适用场景与注意¶

结尾¶

精选优惠券

feishu-multi-agent-s：在同一飞书群聊中配置多 OpenClaw 智能体

前言¶

这是什么¶

核心功能¶

多 agent 与多飞书应用一一对应¶

OpenClaw 四类配置块¶

智能体间协作方式¶

验证与排障¶

安装与启用¶

1、安装 SkillHub CLI（若尚未安装）¶

2、安装本 Skill 到当前 Agent 的 skills 目录¶

3、启用前的 OpenClaw 侧准备¶

典型用法¶

1、飞书侧：创建 N 个应用¶

2、OpenClaw 侧：写入多账号与绑定¶

3、群聊内协作¶

适用场景与注意¶

结尾¶

精选优惠券

Related Articles