OpenClaw 飞书接入教程，企业协作机器人配置指南

根据官方飞书文档，飞书渠道已经是生产就绪状态，支持机器人私聊和群组，默认使用 WebSocket 长连接接收消息，不需要为了接收事件额外暴露公网 Webhook。

先理解飞书在 OpenClaw 里的定位#

飞书更适合：

• 团队协作
• 企业办公沟通
• 需要把智能体接入组织内部聊天环境

相比 Telegram 或 WhatsApp，它通常不是最适合的新手第一渠道，但一旦你的基础链路已经跑通，飞书会是非常重要的团队入口。

插件要不要单独安装#

官方文档说明：

• 当前版本通常已内置飞书插件
• 只有较旧版本或没有内置插件的自定义安装，才需要手动安装

手动安装命令：

openclaw plugins install @openclaw/feishu

推荐接入方式#

官方给出两种方式：

方式一：通过向导接入

openclaw onboard

适合：

• 刚安装完 OpenClaw
• 还没完成初始配置

方式二：通过 CLI 增加渠道

openclaw channels add

选择 Feishu，然后输入：

• App ID
• App Secret

第一步：创建飞书应用#

根据官方文档，你需要在飞书开放平台完成这些动作：

1. 打开飞书开放平台
2. 创建企业应用
3. 填写名称、描述和图标
4. 在“凭证与基础信息”里复制：
   • App ID，格式通常是 cli_xxx
   • App Secret
5. 启用机器人能力
6. 配置事件订阅
7. 发布应用

如果你使用的是 Lark 国际版，官方还特别提醒应改用：

• Lark 平台
• 并在配置里设置 domain: "lark"

第二步：配置 OpenClaw#

通过配置文件配置

官方配置示例：

{
  channels: {
    feishu: {
      enabled: true,
      dmPolicy: "pairing",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          botName: "我的AI助手",
        },
      },
    },
  },
}

这里最重要的几项是：

• dmPolicy: "pairing"：默认私聊采用配对模式
• accounts.main.appId
• accounts.main.appSecret

WebSocket 和 Webhook 的区别#

官方默认是：

• connectionMode: "websocket"

也就是说，大多数情况下你不需要暴露公网 Webhook。

只有在明确需要 Webhook 模式时，才要配置：

• verificationToken
• webhookPath
• webhookHost
• webhookPort

第三步：启动并测试#

启动 Gateway：

openclaw gateway

然后在飞书里：

1. 找到你的机器人
2. 发送一条测试消息

默认配对流程#

官方文档说明，飞书私聊默认采用：

dmPolicy: "pairing"

也就是说，陌生用户第一次发消息时，机器人会返回配对码。

批准方式：

openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

批准之后，才能正常对话。

群组消息默认怎么处理#

飞书群组默认有两个关键边界：

1. groupPolicy
2. requireMention

官方文档给出的默认思路是：

• 群组策略默认允许
• 但通常默认要求 @提及

也就是：

• 机器人可以在群里存在
• 但不会因为任何一句普通消息都自动响应

常见群组策略#

允许所有群组，但默认必须 @

这是官方默认推荐思路。

允许所有群组且不需要 @

适合你明确知道这个群就是专门给机器人工作的。

只允许指定群组

更适合正式团队环境。官方文档里使用：

• groupPolicy: "allowlist"
• groupAllowFrom

如何获取群组和用户 ID#

官方给出的推荐方法是：

获取群组 ID（chat_id）

1. 启动 Gateway
2. 在群里 @机器人
3. 执行：

openclaw logs --follow

然后在日志里找：

• chat_id

获取用户 ID（open_id）

1. 给机器人发私信
2. 运行：

openclaw logs --follow

然后在日志里找：

• open_id

什么时候飞书值得优先接#

如果你已经：

• 跑通了 Gateway
• 跑通了至少一个基础渠道
• 理解了配对和群组权限

那飞书就很值得接入。

如果你还在第一阶段摸索，我仍然建议先 Telegram / WhatsApp，再回头接飞书，这样排障边界更清楚。