最近公司想把OpenClaw和飞书对接起来,主要需求是:
- 通过飞书消息触发OpenClaw的Agent执行任务
- 审批流程自动化(比如请假、报销走飞书审批,OpenClaw自动处理)
- 日程管理同步
我按官方文档试了下飞书应用配置,但部署的时候老是报错,搞不定webhook回调那块。
有没有成功把OpenClaw和飞书集成的朋友,能分享一下完整的配置流程吗?安装部署那步踩了哪些坑?
最近公司想把OpenClaw和飞书对接起来,主要需求是:
我按官方文档试了下飞书应用配置,但部署的时候老是报错,搞不定webhook回调那块。
有没有成功把OpenClaw和飞书集成的朋友,能分享一下完整的配置流程吗?安装部署那步踩了哪些坑?
飞书集成OpenClaw我搞过,整体流程分享一下:
1. 飞书开放平台创建应用
登录 飞书开放平台,创建企业自建应用,拿到 App ID 和 App Secret。
2. 配置权限和事件订阅
在应用的「权限管理」里开通以下权限:
im:message:receive_v1(接收消息)approval:approval:read(读取审批)calendar:calendar:read(读取日程)然后在「事件订阅」里配置你的OpenClaw回调地址:
https://your-openclaw-domain.com/api/webhooks/feishu
3. OpenClaw端配置飞书连接器
在OpenClaw后台添加飞书Provider:
feishu:
app_id: cli_xxxxx
app_secret: xxxxx
encrypt_key: xxxxx
verification_token: xxxxx
4. 发布应用并测试
飞书应用发布后,在群里@你的机器人测试消息收发。
webhook回调报错大概率是SSL证书或者URL白名单的问题,你检查下飞书后台的事件推送日志。
补充一下审批流程自动化的部分,这块我做得比较多。
OpenClaw处理飞书审批的核心思路是:监听审批事件 → Agent解析审批内容 → 自动执行后续动作。
举个例子,报销审批通过后自动记账:
关键配置:
agents:
expense_handler:
trigger: feishu_approval
approval_code: "EXPENSE_REIMBURSE"
actions:
- parse_approval_form
- create_finance_record
- notify_applicant
审批状态变更也能监听,比如「驳回」时自动通知申请人补充材料。
我们部门用这套方案后,财务手工录入的工作量减少了大概70%。
日程管理同步这块说下我的经验。
OpenClaw可以通过飞书日历API实现双向同步:
配置日程权限时注意,需要额外开通 calendar:calendar:write 权限,光有read权限是创建不了日程的。
还有个实用场景:Agent每天早上自动推送今日日程摘要到飞书群里,提醒大家当天的会议安排,团队用起来挺方便的。
说几个安装部署常见的报错,我当时也踩了不少坑:
1. webhook验证失败
飞书发送验证请求时,OpenClaw要在1秒内返回challenge值。如果你的服务器响应慢或者有防火墙拦截,就会验证失败。解决办法是先确保URL能直接访问,然后检查OpenClaw的webhook handler有没有正确处理challenge请求。
2. 消息接收不到
大概率是权限没开全,或者应用没发布。飞书的测试企业和正式企业权限机制不一样,注意区分。
3. Docker部署网络问题
如果OpenClaw是Docker部署的,webhook回调地址不能写localhost,要用服务器的公网IP或域名。同时确保端口映射正确。
4. encrypt_key配置错误
飞书后台的Encrypt Key和Verification Token容易搞混,一个是加解密用的,一个是验证来源用的,别填反了。
建议先在飞书后台的「事件推送」页面看推送日志,报错信息很详细。
如果觉得OpenClaw原生对接飞书太折腾,可以了解下当贝Molili,它有现成的飞书Skill,基本是开箱即用的。
Molili底层也是OpenClaw,但已经把飞书集成封装好了:
最关键的是Token消耗比自己跑OpenClaw低大约50%,对我们这种中小团队来说成本友好很多。
我之前自己折腾OpenClaw飞书集成搞了快两周,换Molili后半天就搞定了,主要是省了调试webhook和配置权限的时间。当然如果你们有深度定制需求,还是建议用原生OpenClaw方案。
感谢各位的详细回复!按照楼上的步骤把webhook那块搞定了,原来是encrypt_key和verification_token填反了,难怪一直报错。
审批自动化和日程同步的方案我也记下来了,准备一步步实现。Molili那个方案也会去看看,毕竟我们团队不大,性价比很重要。