如果你的 OpenClaw 已完成初始部署、WebUI 可正常收发回复,现在想接入飞书机器人,这篇教程会带你从创建机器人到配置完成,一步到位。
相信你在部署 OpenClaw 时已经踩过不少坑,这篇文章会帮你尽量避开飞书对接中的常见问题,少走弯路。废话不多说,教程正式开始!原文地址
内置飞书插件
如果您使用的是最新版本的 OpenClaw那么已经内置了 Feishu 插件,通常不需要让我们单独进行安装。
如果您使用的是之前比较旧的版本,或者是没有内置的 Feishu 的插件,可以手动进行安装,执行下方命令:
创建飞书机器人
我们先来创建飞书的应用,我们可以复制下方地址进行一键直达
创建企业自建应用
打开后,我们点击【创建企业自建应用】,如果您还没有飞书账号的话,请先注册飞书的账号后再进行创建应用

我们创建企业自建应用然后输入应用名称和应用描述,还有应用图标,我们都可以自定义进行上传,或者选择其他照片当作应用图标。输入完之后我们点击创建

获取 AppID 和 AppSecret
我们点击凭证与基础信息一栏查看我们的App ID 和 App Secret,我们可以复制下来到文本记录一下,后面我们需要用到:
-
App ID (格式如:cli_xxx)
-
App Secret
⚠️重要:请妥善保管自己的 App Secret,不要分享给任何人!


配置权限管理
然后我们在左侧菜单栏找到【权限管理】,并点击后找到【批量导入或导出】找到并点击他,然后我们选择【导入】把下方的JSON 代码复制到自己的JSON配置中

输入完成后,我们点击下一步确认新增权限,然后会提示我们确认导入的权限,我们点击右下角的申请开通按钮即可完成

添加机器人
然后我们在左侧的菜单栏找到【添加应用能力】,然后我们添加机器人

这里我们配置一下机器人。
需要注意的是:菜单状态,如果无法以关闭状态进行保存的话,那么我们就使用开启状态进行完成保存,后期我们可以进行关闭,当然如果自己能用到菜单功能的话,可以进行开启。

事件与回调
在左侧菜单栏找到【事件与回调】点击【订阅方式】选择【使用长连接接收事件】→ 添加事件

选择【消息与群组】→ 勾选【接收消息】 → 点击添加

版本发布
点击【创建版本】

输入应用版本号 → 更新说明 → 点击保存 → 最后确认发布


通过命令行进行添加
如果你已经完成了初始安装,可以用与下面命令添加飞书渠道。复制下方命令到自己的终端中执行即可
下方它会询问我们是否现在配置聊天频道,我们选择yes

这里我们用键盘中的方向键进行上下选择选中我们需要配置的飞书频道,然后按回车键

这里它会询问我们是否需要安装飞书插件,这里它有三个选项
-
Download from npm(从 npm 中进行下载)
-
Use local plugin path(使用本地插件路径)
-
Skip for now (跳过)
这里我的版本是3.12我直接选择的是使用本地插件路径,也就是第二个,然后我们按回车键

这里我们选择【Enter App Secret】按回车键后输入自己飞书的 App Secret
-
输入完 AppSecret 后按回车键;
-
然后要求输入我们的 AppID,我依旧复制我从飞书凭证中复制的 AppID 进行粘贴后按回车键即可



这里我们务必要选择 websocket,然后按回车键

然后它让我们选择域名,这里首先自己要知道自己使用的是国内版飞书还是国际版飞书,国内版飞书我们就选择.cn 的域名,国际版就选择 Lark 也就是.com的域名

这里有三个选项,让我们选择是否仅在特定群组中回复还是公开,或者是禁用
-
仅在特定群组中回复
-
公开 - 在所有群组中回复(需要提及)
-
禁用 - 不在群组中回复
如果您不想在群组中回复的话,那么就选择禁用,或者选择仅在特定群组中回复,这里我选择的是禁用

完成后,它又会让我们进行配置新的频道,如果您有其它的频道进行配置的话,那么继续操作即可。如果没有的其它频道进行配置的话,我们选择完成即可

剩余的就根据下方进行选择即可
-
【feishu account name】这个是自定义的,你想输入什么都没有关系。
-
【Bind configured channel accounts to agents now?】现在将配置好的渠道账户绑定到代理?这里我们直接选择 Yes
-
【Route feishu account "default" to agent / 将飞书账户"default"路由到代理】这里我们依旧选择 Yes

现在,我们就完成了 OpenClaw 接入飞书频道的配置流程了,现在我们可以输入以下命令管理网关:
-
openclaw gateway status- 查看网关运行状态 -
openclaw gateway restart- 重启网关以应用新配置 -
openclaw logs --follow- 查看实时日志
测试飞书机器人
打开飞书客户端或者网页版,找到自己创建的应用并打开

在创建的机器人聊天窗口输入/start 会出现需要发送给OpenClaw 的配对码

打开终端输入给出的配对码进行回车发送即可


然后我们在创建的机器人中回复一条消息,它确实给出我们回应了。因为之前使用过飞书机器人所以之前的记录 OpenClaw 是保留着的。
