Jack.Shang的技术博客

一、落地架构与企业选型思路（核心落地理念）

Openclaw作为企业员工个人助手最优落地方案：全公司只维护 1 个正式对外的飞书机器人（default 产品经理 Bot），全公司所有业务群统一拉入这一个机器人，飞书侧零配置、零新增飞书应用；仅在 OpenClaw 配置层做群 ID→Agent 路由分发。

落地优势

1. 飞书端零运维：业务人员新建飞书业务群，只需在群设置→添加机器人，搜索机器人名称拉入即可使用 AI 能力，不用开发、不用申请飞书应用、不用配置权限；
2. 能力全局共享：OpenClaw 所有 Skill 技能全局共用，平台迭代新增工具、插件、知识库后，全公司所有飞书群立刻同步享用新能力；
3. 灵活精细化隔离：
   1. 同类型业务群（日常咨询、通用答疑）：多个群复用同一个 Agent，共用一套 Prompt 与技能；
   2. 业务差异大、领域完全割裂的专属群（项目专项群、财务群、研发故障群）：OpenClaw 管理员新建独立 Agent（独立 workspace 工作目录、独立对话记忆、可单独配置专属 Skill / 专属角色 Prompt），在 bindings 新增一条路由，把该群定向绑定到新建 Agent；
      
4. 运维集中化：全部配置收敛在 OpenClaw 服务端，仅 OpenClaw 管理员维护配置，业务侧无任何配置成本，规模化落地效率极高。

关键避坑：几十个业务群共用同一个 Agent 工作目录，多群上下文混杂、历史聊天记忆互相干扰，极易造成 AI 注意力混乱、答非所问，建议业务跨度大的群组一律单独新建专属 Agent 隔离会话空间。

⚠️ 重要前置安全提醒（企业落地必看）： OpenClaw 官方明确：项目仅限个人学习、非商用场景使用，不推荐企业直接投产商用。 企业若基于本文方案落地试用，硬性规范：

1. 部署环境物理隔离：单独搭建独立测试环境，严禁对接企业生产业务系统、核心业务数据库、涉密数据、财务 / 人事敏感信息；
2. 数据管控：禁止群内同步企业机密、合同、客户隐私、核心技术资料等敏感内容；
3. 边界区分：仅用作内部闲聊、通用辅助答疑试用，不嵌入企业正式生产流程，规避数据泄露、合规、业务稳定性安全翻车风险。

二、飞书开放平台前置配置（全局统一 Bot）

1. 应用身份权限清单（必开）

应用→权限管理→应用身份开通以下权限：

im:message

im:message:send_as_bot

im:message.group_msg          # 全群消息接收，无需@即可触发

im:message.group_at_msg:readonly

im:message.p2p_msg:readonly

im:chat:readonly              # 获取群信息，规避99991672无权限报错

⚠️ 重要：权限勾选后页面 “修改已发布” 仅开发环境生效，必须创建新版本发布，线上权限才生效。

2. 事件配置

事件与回调→事件配置：接入方式 WebSocket，订阅事件im.message.receive_v1，和 OpenClaw connectionMode”:”websocket”匹配。

3. 机器人可被全公司搜索添加（跨部门 / 外部群）

1. 个人创建的飞书机器人，必须完成个人实名认证，发布页面开启对外共享时附带实名跳转链接；
2. 应用发布→创建新版本→可用范围编辑→勾选【允许外部租户用户添加到外部群和单聊】，保存发布；
3. 群添加机器人路径：飞书群→群设置→添加机器人→搜索机器人名称添加。

4. 飞书群 ID 获取方法

机器人入群→群内任意发消息→查看 OpenClaw 网关日志，日志中oc_开头字符串即为群组 ID。

三、openclaw.json 渠道配置

json

“channels”: {

  “feishu”: {

    “enabled”: true,

    “connectionMode”: “websocket”,

    “domain”: “feishu”,

    “accounts”: {

      “h0assistant-personal”: {

        “appId”: “cli_xxxx”,

        “appSecret”: “xxxx”,

        “name”: “H0-总助-个人”

      },

      “h0devmanager-personal”: {

        “appId”: “cli_xxxx”,

        “appSecret”: “xxxx”,

        “name”: “H0-项目开发经理-个人”

      },

      “default”: {

        “appId”: “cli_xxxx”,

        “appSecret”: “xxxx”,

        “name”: “H0-产品经理-个人”,

        “webhookPath”: “/feishu/events”,

        “dmPolicy”: “pairing”,

        “groupPolicy”: “open”,

        “groupAllowFrom”: [

          “ou_xxxx部门ID”,

          “oc_dc29b559b3******************”

        ]

      }

    }

  }}

实测结论：groupPolicy”:”open”即可实现免 @触发消息，无需额外配置 requireMention:false；禁止填写groupPolicy”:”all”（参数无效，强制 @机器人）；groupAllowFrom配置白名单，不在名单的群组消息直接拦截。

四、bindings 路由核心配置（企业多群分流关键）

配置规则说明

1. 前两项：存量历史独立 Bot 全量消息绑定原有 Agent（历史存量兼容保留）；
2. 从 default 配置开始：同一个全局 Bot + 单群 ID → 绑定独立 Agent，实现一 Bot 多群、分群隔离会话。

json

“bindings”: [

  {

    “agentId”: “h0assistant”,

    “match”: {

      “channel”: “feishu”,

      “accountId”: “h0assistant-personal”

    }

  },

  {

    “agentId”: “h0devmanager”,

    “match”: {

      “channel”: “feishu”,

      “accountId”: “h0devmanager-personal”

    }

  },

  // 产品专项群：独立Agent、独立记忆

  {

    “agentId”: “h0prdmanager”,

    “match”: {

      “channel”: “feishu”,

      “accountId”: “default”,

      “peer”: {

        “kind”: “group”,

        “id”: “oc_dc29b559b3******************”

      }

    }

  },

  // 通用咨询群：复用公共通用Agent

  {

    “agentId”: “common-help”,

    “match”: {

      “channel”: “feishu”,

      “accountId”: “default”,

      “peer”: {

        “kind”: “group”,

        “id”: “oc_xxxx通用群ID”

      }

    }

  }]

新增业务群标准模板

拿到新群 oc_群 ID 后，追加配置即可：

json

{

  “agentId”: “新群专属AgentID”,

  “match”: {

    “channel”: “feishu”,

    “accountId”: “default”,

    “peer”: {

      “kind”: “group”,

      “id”: “oc_新群组ID”

    }

  }}

五、新建独立 Agent（群组业务隔离操作）

业务跨度大的专属群，新建独立 Agent，生成隔离工作目录：

bash

运行

openclaw agents add 自定义AgentID –workspace ~/.openclaw/workspace-自定义AgentID

• 独立 workspace：群聊天记忆、上下文完全隔离，不会和其他群互相污染；
• 可单独配置专属 Prompt、按需启停专属技能，公共 Skill 默认全 Agent 共享。

六、上线验证步骤

1. 飞书配置变更后发布版本，等待 1~3min 权限同步；
2. 修改 openclaw.json 后重启 OpenClaw 网关；
3. 群发消息校验：
   1. 无did not mention bot日志 = 免 @生效；
   2. 无99991672 getChatInfo failed = 群信息权限正常；
   3. 日志 dispatch 指向对应 agentId = 路由配置生效。

七、踩坑汇总

1. 权限已勾选但 99991672 报错：未发布新版本；
2. 消息收到提示 did not mention bot：groupPolicy 填 all，改为 open；
3. 机器人搜不到无法加群：未实名、未开启对外共享；
4. 群组收不到消息：群 ID 未写入 groupAllowFrom 白名单。

八、企业规模化落地总结

1. 轻量化落地：全公司共用一个飞书 Bot，业务建群只拉机器人即用，落地成本最低；
2. 灵活隔离：普通通用群复用公共 Agent，垂直专项群新建独立 Agent，兼顾易用性与上下文稳定性；
3. 能力统一迭代：OpenClaw 侧更新技能、知识库后全公司所有群同步受益；
4. 合规底线重申：遵循官方使用约定，仅限个人学习、企业内部隔离环境试用，严禁接入生产系统、存储企业敏感数据用于正式商用。