需配置飞书开放平台事件订阅、workbuddy webhook地址、自定义审批模板及验证流程,实现审批事件自动推送与解析。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望 WorkBuddy 在飞书审批流中自动响应权限申请事件(例如用户提交「IT 权限开通」审批单),需通过 Webhook 将飞书审批事件实时推送至 WorkBuddy 服务端进行解析与处理。以下是实现该能力的配置步骤:
一、在飞书开放平台启用审批事件订阅
飞书审批事件默认不开放给普通应用,必须在应用权限中显式开启「审批单据状态变更」事件,并完成事件地址注册,才能使审批数据触达 WorkBuddy。
1、登录飞书开放平台(https://open.feishu.cn/),进入已创建的 WorkBuddy 应用详情页。
2、在左侧菜单中依次展开「事件配置」→「订阅方式」,确认已选择「将事件发送至开发者服务器」。
3、点击「添加事件」,在事件类型列表中勾选「审批单据状态变更」(对应权限 scope:approval:approval_instance:readonly)。
4、确保该事件右侧显示「已启用」状态;若为灰色未启用,请返回「权限管理」→「批量导入权限」,补全审批相关权限 JSON 片段。
二、配置审批 Webhook 接收地址
WorkBuddy 客户端需暴露一个专用 HTTP 端点用于接收飞书推送的审批事件,该端点由客户端自动生成并绑定 Claws 远程控制服务,不可手动修改路径结构。
1、启动本地运行的 WorkBuddy 客户端,确保 Claws 远程控制功能处于开启状态。
2、点击右上角个人头像 →「Claw 设置」→「飞书集成」。
3、确认页面底部显示的 Webhook URL 以 https:// 开头,且路径中包含 /webhook/approval 字样。
4、完整复制该 URL,切勿删减末尾斜杠或参数;该地址仅对当前设备有效,重启客户端后可能变更。
三、在飞书审批后台绑定自定义审批模板
飞书原生审批模板不支持直接对接外部 Webhook,必须通过「自定义审批流」创建专属模板,并在其节点中配置 Webhook 触发动作,从而将审批实例数据定向推送给 WorkBuddy。
飞书语音消息发送器。基于 Edge TTS,一键将文字转为语音发送到飞书。 使用场景: - 发送语音通知/提醒到飞书 - 文字转语音自动播报 触发词:飞书语音、语音发送、tts、文字转语音
1、使用企业管理员账号登录飞书管理后台(https://www.feishu.cn/admin),进入「审批」→「审批模板」→「新建模板」。
2、选择「自定义审批流」,填写模板名称如「WorkBuddy 权限申请」,关闭「启用电子签名」等非必要选项。
3、在流程编辑区,拖入一个「Webhook 节点」,点击编辑:
4、在「请求地址」栏粘贴上一步获取的 WorkBuddy Webhook URL。
5、在「请求方法」中选择 POST,在「请求头」中添加 Content-Type: application/json 与 X-Feishu-Signature: {signature}(签名字段由飞书自动生成,无需手动填写)。
6、保存模板并发布,确保目标部门或人员可选用该模板发起权限申请。
四、验证审批事件推送与 WorkBuddy 解析能力
WorkBuddy 收到飞书审批 Webhook 请求后,会自动解析审批单号、申请人、审批状态及表单字段内容,触发预设的权限申请处理逻辑,无需人工干预。
1、在飞书中使用刚发布的「WorkBuddy 权限申请」模板提交一条测试审批单,填写申请人、所需权限类型(如「数据库只读权限」)、有效期等字段。
2、审批单提交成功后,观察 WorkBuddy 客户端右下角是否弹出通知提示「收到新审批:ID-XXXXXX」。
3、打开 WorkBuddy 日志面板(设置 →「调试」→「查看运行日志」),搜索关键词 approval_instance,确认日志中包含完整 JSON 结构的审批事件体。
4、检查本地权限管理系统是否已自动创建待审核记录,且申请人信息、审批单链接、字段值均与飞书端一致。










