OpenClaw飞书接入全攻略：私聊与群聊策略深度解析

将OpenClaw智能助手集成到飞书，可以显著提升团队协作与个人工作效率。本指南将详细演示如何在Windows 11的WSL2（Ubuntu 24.04）环境下，完成从飞书应用创建到OpenClaw配置的全链路部署。

一、相关链接

部署前，请确保你已查阅并理解以下核心官方文档：

• 飞书开放平台
• OpenClaw 飞书官方插件使用指南（公开版）

二、飞书新建应用

首先，在飞书开放平台创建一个应用，作为OpenClaw机器人的合法身份。

1、创建企业自建应用

使用个人或企业账号登录飞书开放平台，进入开发者后台。点击“创建企业自建应用”，填写应用名称（如“OpenClaw智能助手”）及功能描述。

2、复制App ID和App Secret备用

应用创建成功后，在“凭证与基础信息”页面，记录下你的 App ID 和 App Secret。这两个凭证是后续所有配置的基石，请妥善保管。

3、权限管理

为保障OpenClaw具备完整的消息收发与信息读取能力，需为其授权。进入“权限管理”页面，选择“批量导入导出权限”，直接导入以下完整的权限配置（非精简版）：

{"scopes": {"tenant": ["contact:contact.base:readonly","docx:document:readonly","im:chat:read","im:chat:update","im:message.group_at_msg:readonly","im:message.p2p_msg:readonly","im:message.pins:read","im:message.pins:write_only","im:message.reactions:read","im:message.reactions:write_only","im:message:readonly","im:message:recall","im:message:send_as_bot","im:message:send_multi_users","im:message:send_sys_msg","im:message:update","im:resource","application:application:self_manage","cardkit:card:write","cardkit:card:read","drive:drive.metadata:readonly","docs:document.comment:create","docs:document.comment:delete","docs:document.comment:read","docs:document.comment:update","docs:document.comment:write_only","docx:document:create","docx:document:readonly","docx:document:write_only","docx:document.block:convert"],"user": ["contact:user.employee_id:readonly","offline_access","base:app:copy","base:field:create","base:field:delete","base:field:read","base:field:update","base:record:create","base:record:delete","base:record:retrieve","base:record:update","base:table:create","base:table:read","base:table:update","base:view:read","base:view:write_only","base:app:create","base:app:update","base:app:read","sheets:spreadsheet.meta:read","sheets:spreadsheet:read","sheets:spreadsheet:create","sheets:spreadsheet:write_only","docs:document:export","docs:document.media:upload","board:whiteboard:node:create","board:whiteboard:node:read","calendar:calendar:read","calendar:calendar.event:create","calendar:calendar.event:read","calendar:calendar.event:reply","calendar:calendar.event:update","calendar:calendar.free_busy:read","contact:contact.base:readonly","contact:user.base:readonly","contact:user:search","docs:document.comment:create","docs:document.comment:read","docs:document.comment:update","docs:document.media:download","docs:document:copy","docx:document:create","docx:document:readonly","docx:document:write_only","drive:drive.metadata:readonly","drive:file:download","drive:file:upload","im:chat.members:read","im:chat:read","im:message","im:message.group_msg:get_as_user","im:message.p2p_msg:get_as_user","im:message:readonly","search:docs:read","search:message","space:document:move","space:document:retrieve","task:comment:read","task:comment:write","task:task:read","task:task:write","task:task:writeonly","task:tasklist:read","task:tasklist:write","wiki:node:copy","wiki:node:create","wiki:node:move","wiki:node:read","wiki:node:retrieve","wiki:space:read","wiki:space:retrieve","wiki:space:write_only","contact:user.basic_profile:readonly"]}}

4、开启机器人能力

导航至“机器人”菜单，点击“开启机器人能力”。此步骤在导入权限后通常自动完成，但建议手动确认状态已激活。

5、事件与回调

配置事件订阅以使机器人能接收消息。进入“事件与回调”页面，选择“事件配置”。
订阅方式选择“使用长连接接收事件”（此模式无需配置复杂的URL验证）。随后，点击“添加事件”，搜索并添加核心事件 im.message.receive_v1，它负责处理所有消息接收。

6、版本管理与发布

最后，进入“版本管理与发布”，创建并发布一个新版本。发布后，你的应用配置即刻生效。

三、OpenClaw配置

完成飞书侧配置后，转向OpenClaw环境进行对接设置。

1、安装飞书官方插件

在你的OpenClaw运行环境中，执行以下命令安装官方飞书插件：

openclaw plugins install @openclaw/feishu

2、添加飞书渠道（交互式配置）

运行添加渠道的命令，并跟随交互式指引完成配置：

openclaw channels add

从支持的渠道列表中选择“Feishu/Lark (飞书)”。系统将引导你输入凭证，请注意输入顺序：先提供 App Secret，再提供 App ID。
配置过程中，需要设定群聊策略：

• Allowlist：仅在指定的群聊ID列表中响应。
• Open：在所有群聊中响应，但通常需要@提及机器人（可配置）。
• Disabled：禁用所有群聊响应。

为便于初期测试，建议选择 Open 策略。待功能验证无误后，可根据安全要求切换至更严格的 Allowlist（白名单）模式。
此配置命令可重复执行，用于更新或修改现有设置。

3、配置文件配置（方式2）

除交互式命令外，亦可直接编辑配置文件。配置文件路径为：

vim ~/.openclaw/openclaw.json

核心配置位于 channels 属性下的 feishu 节点。

群聊策略为 open 的配置示例：

"channels": {
  "feishu": {
    "enabled": true,
    "appId": "cli_***",
    "appSecret": "******",
    "connectionMode": "websocket",
    "domain": "feishu",
    "groupPolicy": "open"
  }
},
"bindings": [{
  "agentId": "main",
  "match": {
    "channel": "feishu",
    "accountId": "default"
  }
}]

群聊策略为 allowlist 的配置示例：

"channels": {
  "feishu": {
    "enabled": true,
    "appId": "cli_***",
    "appSecret": "******",
    "connectionMode": "websocket",
    "domain": "feishu",
    "groupPolicy": "allowlist",
    "groupAllowFrom": ["oc_******"]
  }
}

其中 groupAllowFrom 数组用于填入允许机器人响应的群聊会话ID。

四、私聊配对

配置完成后，需完成私聊配对以激活机器人与你的单点通信。

1、飞书

在飞书中搜索你创建的机器人应用（如“OpenClaw助手”），并向其发送任意消息，例如“测试”。
机器人将回复一条包含你的用户ID（ou_***）、一个配对码及配对命令的消息，格式如：openclaw pairing approve feishu <配对码>。

2、OpenClaw

返回OpenClaw命令行环境。可先查看当前待处理的配对请求：

openclaw pairing list feishu

随后，执行机器人提供的配对命令完成授权：

openclaw pairing approve feishu XXXXXXXX

配对成功后，系统会返回确认信息及用户ID，建议记录该ID以备后用。

3、配对成功验证

再次于飞书中向OpenClaw助手发送消息，若收到正常回复，则表明私聊通道已成功建立。

五、群聊配置

私聊验证通过后，即可配置群聊交互。

1、新建群组

在飞书中创建一个新群组。一个便捷的特性是：作为应用创建者，机器人会自动以群主身份加入该新群。

2、添加机器人

若需在现有群聊中添加机器人，进入群聊“设置” -> “添加机器人”，搜索你的应用名称（如“OpenClaw助手”）并添加。

3、群聊测试

若OpenClaw的群聊策略设置为 open，现在在群内@OpenClaw助手，它应能正常响应你的消息。

4、查看群里ID

若计划采用更安全的 allowlist（白名单）模式，需获取目标群聊的ID。进入群聊“设置”，滚动至页面底部，复制“会话 ID”（格式为 oc_***）。
将此ID填入OpenClaw配置文件的 groupAllowFrom 数组内。

六、命令方式修改群聊策略

除直接编辑配置文件外，也可通过命令行动态调整配置。

首先，设置机器人是否仅在群聊中被@时才回复（此为常见安全设置）：

openclaw config set channels.feishu.requireMention true

1、设置群聊策略为开放

openclaw config set channels.feishu.groupPolicy open

2、设置群聊策略为白名单

openclaw config set channels.feishu.groupPolicy allowlist

设置具体的群聊白名单（多个群ID用逗号分隔的JSON数组格式）：

openclaw config set --json channels.feishu.groupAllowFrom '["oc_xxx","oc_yyy"]'

七、OpenClaw给飞书发消息

OpenClaw支持主动向飞书用户或群组发送消息。

1、给用户发消息

openclaw message send --channel feishu --target "open_id:你复制的ou_开头用户ID" --message "你要发送的消息内容"

2、给群聊发消息

openclaw message send --channel feishu --target "chat:你复制的oc_开头群聊ID" --message "你要发送的群聊消息"

八、OpenClaw查看群聊ID

若需查询机器人已加入的所有群组及其ID，可使用以下命令：

openclaw directory groups list --channel feishu

九、私聊策略

除群聊外，私聊（Direct Message）也具备独立的访问控制策略。

1、参数说明

• dmPolicy: 私聊策略，用于控制未知用户的私聊访问。
  • pairing (默认): 未知用户将收到配对码，需管理员手动批准。
  • allowlist: 仅允许 allowFrom 白名单中指定的用户ID发起私聊。
  • open: 允许所有人私聊，但必须同步设置 "allowFrom": ["*"]。
  • disabled: 完全禁用私聊功能。
• allowFrom: 用户ID白名单。当 dmPolicy 设置为 allowlist 时生效，用于指定有权私聊机器人的飞书用户（通过 open_id 或 Union ID 标识）。

2、openclaw channels add 修改

运行 openclaw channels add 命令时，当提示 Configure DM access policies now? 时选择 Yes，即可进入私聊策略的交互式配置流程。

3、命令行修改

通过命令行将私聊策略改为白名单模式，并指定允许的用户：

openclaw config set channels.feishu.dmPolicy "allowlist"
openclaw config set channels.feishu.allowFrom --json '["ou_b7d53616e10741f5daf1bed3f2efc5c8", "ou_user2"]'

4、配置文件修改

也可直接在配置文件中调整私聊策略：

{
  channels: {
    feishu: {
      enabled: true,
      // 连接模式：使用长连接（默认就是 websocket，可省略）
      connectionMode: "websocket",
      // 私聊策略：允许指定用户（用 open_id）；或者改成 "open" 允许所有人
      dmPolicy: "allowlist",
      allowFrom: ["ou_你的飞书_open_id"],
      // 群聊策略：允许所有群
      groupPolicy: "open",
      // 如果只想在群里 @ 才回复：
      requireMention: true
    }
  }
}

至此，OpenClaw与飞书的深度集成配置全部完成。你可以根据团队的实际安全规范与协作场景，灵活调整私聊与群聊策略，从而最大化发挥智能助手的效能。

来源：互联网