【小白易懂版】OpenClaw 飞书机器人绑定配置详细教程（含安装包）
OpenClaw 绑定飞书完整教程
OpenClaw 是一款 AI 聊天网关一键部署平台，支持对接多模型与多渠道接入。本文详细说明 Windows 端飞书机器人创建、权限配置、事件订阅及 OpenClaw 接入全流程。
一、前置准备
- 安装包下载：https://xiake.yun/api/download/package/12?promoCode=IV4E9B04A80C
- 软件版本：OpenClaw Windows (虾壳云) v2.6.6
- 运行状态：确保 Gateway 显示在线
- 账号准备：已登录飞书开放平台，拥有可用的飞书组织 / 企业空间
- 企业账号注意：发布应用可能需要管理员审核
二、飞书开放平台配置步骤
步骤 1：创建企业自建应用
- 打开飞书开放平台：https://open.feishu.cn/app
- 进入开发者后台，选择创建企业自建应用
- 选择从空白开始创建应用
步骤 2：完善应用基础信息
- 填写应用名称、描述、机器人名称与描述
- 上传符合要求的应用图标（2MB 以内，≥240×240px）
- 点击创建完成应用建立
步骤 3：添加机器人能力
- 进入应用后台，点击左侧添加应用能力
- 在能力列表中找到机器人并点击添加
步骤 4：配置事件与回调
- 左侧进入事件与回调
- 点击订阅方式右侧编辑按钮
步骤 5：选择长连接接收事件
- 选择使用长连接接收事件（无需配置公网回调地址）
- 点击保存完成订阅方式设置
步骤 6：添加接收消息事件
- 点击添加事件
- 搜索并勾选接收消息 v2.0（im.message.receive_v1）
- 点击添加完成事件订阅
步骤 7：开通关联权限
- 弹出权限推荐窗口时，点击确认开通权限
- 回到事件列表，检查所有依赖权限均为已开通状态
步骤 8：批量导入完整权限
- 左侧进入权限管理，点击批量导入 / 导出权限
- 全选删除默认内容，粘贴完整权限 JSON 配置
- 点击下一步，确认新增权限
步骤 9：确认数据范围
- 出现数据范围配置时，保持与应用的可用范围一致
- 点击确认完成权限导入
步骤 10：创建并发布应用版本
- 点击创建版本或进入版本管理与发布
- 设置版本号（如 1.0.0），移动端与桌面端默认能力选择机器人
- 填写更新说明，点击保存→确认发布
- 个人账号通常免审发布，企业账号需管理员审核通过
步骤 11：复制应用凭证
- 左侧进入凭证与基础信息
- 复制App ID与App Secret备用
三、OpenClaw 飞书渠道配置
- 打开 OpenClaw v2.6.6，确认Gateway 在线
- 点击右上角设置→聊天配置
- 找到 **Feishu/Lark（飞书）** 渠道
- 填入复制的App ID与App Secret
- 开启渠道开关，点击保存渠道配置
四、接入完成自检清单
- 飞书应用已添加机器人能力
- 事件订阅使用长连接接收事件
- 已添加 im.message.receive_v1 接收消息事件
- 所有关联权限均已开通
- 应用版本已保存并发布
- OpenClaw 已正确填写并保存飞书凭证
五、常见问题排查
机器人无响应
- 检查应用是否发布成功
- 确认事件订阅与权限配置完整
- 重启 OpenClaw Gateway 后重试
- 核对 App ID 与 App Secret 无多余空格
无需配置回调地址
- 本教程采用长连接模式，无需填写公网回调地址
权限配置说明
- 基础对话可仅开通必要权限
- 需使用多维表格、云文档等功能，建议导入完整权限 JSON
安装包下载：https://xiake.yun/api/download/package/12?promoCode=IV4E9B04A80C