本指南将帮助您在飞书中配置天禧Claw ，让您可以通过飞书与天禧Claw完成互联。

一、前置条件

在开始之前，请确保您已满足以下条件：

• 已在您的主机上配置 天禧Claw

• 拥有一个飞书企业账号（需要有创建应用的权限）

 

二、流程指引

整体流程

在飞书中使用创建企业自建应用 -> 获取App ID 和 App Secret并填入天禧Claw

详细步骤

方式一：

打开飞书开放平台-创建 OpenClaw 飞书机器人 （网址：https://open.feishu.cn/page/openclaw?form=multiAgent），即可一键创建机器人，复制App ID 和 App Secret，填充至天禧Claw即可完成配置。

方式二：

1、在飞书开放平台 中获取App ID 和 App Secret

（1）登录飞书账号（建议登录个人账号，如果是企业账号，后续步骤需要企业管理员审核），登录成功后，点击【创建企业自建应用】

注意：不要用Lark登录

当您尚未创建测试应用时：

当您已创建测试应用：

 

（2）填写应用信息后，提交「创建」，应用创建成功后，会自动跳转到应用详情页面

 

（3）在应用详情页的「添加应用能力」区域，找到「机器人」卡片，点击「添加」。

 

（4）在应用详情页左侧菜单中，点击「权限管理」，然后选择「批量导入 / 导出权限」。

 

（5）在弹出的窗口中：清空输入框中的所有内容，将下方的权限列表完整复制并粘贴进去，点击「下一步，确定新增权限」及「申请开通」。

 

 

注意：

代码如果出现格式错误，确认一下是不是创建成“商店应用”了

等待几秒钟，页面会显示权限已成功添加，点击右下角「确认」。

 

（6）在应用详情页左侧菜单中，点击「凭证与基础信息」。在页面中，即可获取App ID 和 App Secret

 

2、关联飞书与天禧Claw

（1）打开 天禧Claw，Claw管理 - 添加使用成员

（2）按照引导添加使用成员，为该成员的常用的APP选择「飞书」

（3）填入刚才复制的 App ID 和 App Secret，点击「连接」完成绑定

 

3、飞书应用创建版本

注意：

需要与天禧Claw连接成功后，返回飞书创建版本才可以成功实现信息互通~

（1）配置飞书事件回调（需要告诉飞书将消息发送到哪里）：返回飞书开放平台，进入应用详情页，在左侧菜单中，点击「事件与回调」，点击订阅方式旁编辑按钮

 

（2）选择订阅方式为「使用 长连接 接收事件」，再点击「保存」

（3）切换到「回调配置」页签，选择订阅方式为「使用 长连接 接收事件」，再点击「保存」

 

 

（4）点击页面上方的「创建版本」按钮。在弹出的窗口中填写版本号（示例：1.0.0）、版本描述（首次发布），点击「确定」创建版本。

注意：

应用必须发布后才能在飞书中使用。

 

开始使用

（1）飞书列表中「开发者小助手」会推送“应用审批通路，已发布成功”，点击「打开应用」开始使用。

或在飞书的搜索框中，输入刚才创建的机器人名称进行搜索。点击机器人进入对话窗口。

（2）发送一条简单消息（例如“你好”）进行连通测试。如果配置正确，天禧Claw 会接收到消息并在飞书中返回回复。

 

说明：

如果机器人能够正常回复，说明您已成功完成 天禧Claw与飞书的对接🎊

三、常见问题

1、机器人没有响应怎么办？

（1）检查应用状态：确认应用已成功发布

（2）检查天禧Claw：确保主机上的天禧Claw正在运行

（3）检查网络连接：确保主机和飞书能够正常访问网络

2、收不到消息怎么办？

（1）确认已添加「接收消息」事件

（2）确认已配置「卡片回传交互」回调