OpenClaw 飞书机器人搭建指南
要在飞书中集成 AI 能力，我们需要先在开发者后台完成应用配置，再通过 OpenClaw 进行对接。整个过程并不复杂，但有几个权限细节需要特别注意。
一、创建企业自建应用
登录飞书开发者后台，进入应用管理页面：
点击创建应用，填写名称和描述即可。系统会自动生成 App ID 和 App Secret，这两个凭证是后续配置的关键，建议先记录下来。
二、添加机器人能力
在应用详情页左侧菜单找到「机器人」选项并添加。添加成功后，该机器人便可在飞书内被搜索和使用。
三、开通消息权限
进入「权限管理」，勾选 im: 相关权限。这里有个经验之谈：建议不要勾选 获取群组中所有消息（im:message.group_msg）。如果开启，机器人会收到并响应群内所有消息，容易造成不必要的干扰。我们通常只需要机器人在被@时响应即可。
四、发布应用 & 事件配置
4.1 创建版本并发布
完成基础设置后，记得创建新版本并发布，否则权限不会生效。
五、配置 OpenClaw
接下来接入 OpenClaw 完成自动化配置。
5.1 选择合适的模型
根据实际业务需求，为机器人选择一个合适的 AI 模型。
5.2 提供凭证信息
将之前记录的 App ID 和 App Secret 填入 OpenClaw。系统会自动写入配置文件并重启网关，无需手动干预。
六、配置飞书事件订阅
网关重启完成后，回到飞书开发者后台配置事件订阅。
6.1 选择长连接方式
推荐使用长连接方式以保证消息实时性。
6.2 添加事件订阅
配置好长连接后，添加对应的事件订阅类型。
七、升级版本并发布
发布新版本后，飞书的「开发者小助手」会发送通知消息，确认状态正常。
八、开始对话
打开飞书，搜索你创建的机器人，直接发起对话测试。如果一切配置无误，AI 助手应该能正常响应了。
至此，一个专属的飞书 AI 机器人就部署完成了。
