OpenClaw（原Moltbot、Clawdbot）集成飞书

3.1 创建飞书应用

1. 访问飞书开放平台，单击创建企业自建应用，填写应用名称和描述，选择应用图标，单击创建。

2. 左侧导航栏单击凭证与基础信息 页面，复制App ID（格式如 cli_xxx）和App Secret。

3. 左侧导航栏单击 权限管理 页面，点击批量导入/导出权限 按钮，粘贴以下 JSON 配置，单击下一步，确认新增权限，单击申请开通。

   JSON配置文件内容

   {
     "scopes": {
       "tenant": [
         "aily:file:read",
         "aily:file:write",
         "application:application.app_message_stats.overview:readonly",
         "application:application:self_manage",
         "application:bot.menu:write",
         "cardkit:card:write",
         "contact:user.employee_id:readonly",
         "corehr:file:download",
         "docs:document.content:read",
         "event:ip_list",
         "im:chat",
         "im:chat.access_event.bot_p2p_chat:read",
         "im:chat.members:bot_access",
         "im:message",
         "im:message.group_at_msg:readonly",
         "im:message.group_msg",
         "im:message.p2p_msg:readonly",
         "im:message:readonly",
         "im:message:send_as_bot",
         "im:resource",
         "sheets:spreadsheet",
         "wiki:wiki:readonly"
       ],
       "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
     }
   }

4. 左侧导航栏中单击添加应用能力， 选择按能力添加页签，找到机器人卡片，单击配置。

   

5. 配置事件订阅。

   1. 在轻量应用服务器控制台，进入目标实例详情页，在应用详情 > 通道配置 > 飞书区域，填入之前获取的App ID和App Secret，并单击应用。

   2. 在飞书开放平台左侧导航栏单击事件与回调，在事件配置页签中单击订阅方式，选择使用 长连接 接收事件，单击保存。

   3. 在事件配置页面，单击添加事件，搜索事件im.message.receive_v1（接收消息），单击确认添加。

6. 在 版本管理与发布 页面创建版本，填写应用版本号和更新说明，单击保存，提交审核并发布。

3.2 配置机器人

可以创建群聊或在已有群聊中添加机器人，在钉钉群中@机器人进行对话，或通过搜索的方式与机器人私聊进行测试。

若需在外部群中使用机器人，可参考配置文档机器人支持外部群和外部用户单聊。

1. 按照添加路径添加机器人：··· > 设置 > 群机器人 > 添加机器人 。

2. 单击机器人头像，单击发送消息，可向机器人私发一条消息，机器人会回复一个配对码。

   @机器人可在群中向机器人发送消息。

   

3. 在WebUI页面输入openclaw pairing approve feishu 配对码完成配对。

   配对码是上一步机器人回复的配对码。

   

   重要

   如出现“目前没有待处理的配对请求”的报错，请参考如何通过终端命令将OpenClaw与飞书配对。

3.1 创建并配置应用

1. 登录飞书开发者后台，点击创建企业自建应用，填写应用信息后单击创建。

2. 在左侧导航栏中单击添加应用能力， 选择按能力添加页签，找到机器人卡片，点击添加。

3. 在左侧导航栏中单击权限管理，单击开通权限，搜索并添加以下 API 权限：

   权限代码	用途说明	注意事项
   im:message:send_as_bot	允许机器人以应用身份发送消息。	必需权限。
   contact:user.employee_id:readonly	获取用户 user ID。	必需权限。
   im:message.group_at_msg:readonly	允许机器人接收群聊中@它的消息。	核心交互权限。
   im:message.p2p_msg:readonly	允许机器人读取用户私聊发给它的消息。	单聊场景下必需。
   im:message.group_msg	允许机器人获取所在群组的所有消息。	敏感权限。

4. 收集集成所需的凭证。后续配置 AppFlow 连接时需要使用这些信息。

   • 在左侧导航栏进入凭证与基础信息页面，查看并复制 App ID 和 App Secret。

   • 在左侧导航栏进入事件与回调页面，找到加密策略页签。复制 Encrypt Key 和 Verification Token。

     若当前Encrypt Key 为空，可点击重置生成一个新Encrypt Key。

3.2 创建飞书连接流

1. 访问通过飞书使用MoltBot(ClawdBot)——多模态，并单击立即使用。

   需要图片理解的场景下还需参考如何更改OpenClaw调用的模型？将模型更换为对应业务场景的多模态模型。

2. 点击添加飞书鉴权凭证，填写凭证名称，及参考下图填入步骤三获取的信息。填写完成后单击确定并在下拉框中选中创建好的凭证。

3. 创建Moltbot鉴权凭证。填入步骤二获取的凭证，填写完成后单击确定并在下拉框中选中创建好的凭证。

4. 点击下一步，前往服务器详情页获取服务器公网地址并按页面提示填入您的公网IP：端口号，端口号默认为18789。

   

5. 配置完成后点击发布，复制并保存您的WebhookUrl。

   

3.3 配置飞书机器人

1. 返回飞书开发者后台，在左侧导航栏单击事件与回调，在事件配置页签，单击按钮配置订阅方式。

2. 选择将事件发送至开发者服务器，并填写上一步复制的WebhookUrl，单击保存。

3. 在事件配置页签的已添加事件区域，单击添加事件，搜索并添加接收消息事件。

4. 填写完成后，在左侧导航栏点击版本管理与发布，创建版本或点击最新编辑的版本，填写完成相关信息后保存并提交审批。

   

3.4 方案验证

配置完成后，用户可以把机器人添加到某个群里，从而实现机器人和群内成员的互动。

目前仅支持在飞书电脑端添加机器人。若需在外部群中使用机器人，可参考配置文档机器人支持外部群和外部用户单聊。

1. 按照添加路径添加机器人：··· > 设置 > 群机器人 > 添加机器人 。

2. @机器人发送消息即可实现对话。