title: OpenClaw接入飞书机器人完整配置指南
OpenClaw接入飞书机器人完整配置指南
用了一个月OpenClaw之后，我觉得最实用的功能就是接入飞书。毕竟大部分人不会天天开着终端，但飞书是每天必开的工具。把OpenClaw接到飞书上，等于随时随地都有一个AI助手在旁边。
今天把完整的配置过程分享出来，踩过的坑也一并记录。
为什么选飞书？
对比了几个IM平台：
| 平台 | 优势 | 劣势 |
|---|---|---|
| 飞书 | 机器人API成熟、富文本支持好 | 需要企业版 |
| 钉钉 | 用户基数大 | Webhook限制多 |
| 微信 | 日常使用频率最高 | 官方不支持机器人，需要hack |
| Telegram | API最开放 | 国内网络问题 |
飞书的机器人API是最规范的，支持卡片消息、交互按钮、文件传输，体验最完整。
配置步骤
第一步：创建飞书应用
- 登录飞书开放平台（open.feishu.cn）
- 创建企业自建应用
- 开启机器人能力
- 配置事件订阅URL（就是你OpenClaw服务器的地址）
这里有个坑：事件订阅URL必须是HTTPS的。如果你的服务器没有SSL证书，可以用Cloudflare套一层。
第二步：配置OpenClaw
在OpenClaw的配置文件里加入飞书相关的配置：
- App ID和App Secret（从飞书后台获取）
- Verification Token
- 事件加密Key
第三步：配置消息通道
OpenClaw支持多种消息通道，飞书是其中之一。你需要在OpenClaw的channel配置里指定使用飞书通道。
第四步：测试连通性
在飞书里找到你的机器人，发一条消息测试。如果一切正常，OpenClaw会在几秒内回复。
踩坑记录
坑1：消息重复处理
飞书有消息重试机制，如果你的服务器响应慢（超过3秒），飞书会重发消息。导致OpenClaw收到重复消息，回复两遍。解决方案：先快速返回200，然后异步处理消息。
坑2：长消息被截断
飞书的文本消息有长度限制，如果OpenClaw的回复太长，会被截断。解决方案：用卡片消息格式，或者自动分段发送。
坑3：Token过期
飞书的access_token有效期是2小时，需要定时刷新。OpenClaw的飞书插件一般会自动处理，但如果你自己写的对接代码，别忘了这一点。
坑4：权限问题
一开始机器人只能在群里被@才回复，不能私聊。需要在飞书后台给应用加上"接收消息"的权限，并且发布上线。
进阶玩法
配通之后，可以做很多有意思的事情：
- 每日早报：定时让OpenClaw汇总新闻、天气、日程，每天早上自动发到飞书群
- 会议纪要：会议结束后把录音转文字丢给OpenClaw，自动生成纪要并发到群里
- 值班告警：把监控告警接入OpenClaw，让它先做初步分析再通知人
- 知识问答：把公司文档灌进去，新人有问题直接问机器人
资源消耗
实测在2C2G的腾讯云轻量服务器上，OpenClaw+飞书通道跑起来大概占用500MB内存，日常CPU使用率5%以下。如果不跑本地模型，这个配置完全够用。
你们有接入飞书或其他IM的经验吗？遇到过什么奇怪的问题？评论区交流一下。