【小白易懂版】OpenClaw 飞书机器人绑定配置详细教程（含安装包）

OpenClaw 绑定飞书完整教程

OpenClaw 是一款 AI 聊天网关一键部署平台，支持对接多模型与多渠道接入。本文详细说明 Windows 端飞书机器人创建、权限配置、事件订阅及 OpenClaw 接入全流程。

一、前置准备

• 安装包下载：https://xiake.yun/api/download/package/12?promoCode=IV4E9B04A80C
• 软件版本：OpenClaw Windows (虾壳云) v2.6.6
• 运行状态：确保 Gateway 显示在线
• 账号准备：已登录飞书开放平台，拥有可用的飞书组织 / 企业空间
• 企业账号注意：发布应用可能需要管理员审核

二、飞书开放平台配置步骤

步骤 1：创建企业自建应用

1. 打开飞书开放平台：https://open.feishu.cn/app
2. 进入开发者后台，选择创建企业自建应用
3. 选择从空白开始创建应用

步骤 2：完善应用基础信息

1. 填写应用名称、描述、机器人名称与描述
2. 上传符合要求的应用图标（2MB 以内，≥240×240px）
3. 点击创建完成应用建立

步骤 3：添加机器人能力

1. 进入应用后台，点击左侧添加应用能力
2. 在能力列表中找到机器人并点击添加

步骤 4：配置事件与回调

1. 左侧进入事件与回调
2. 点击订阅方式右侧编辑按钮

步骤 5：选择长连接接收事件

1. 选择使用长连接接收事件（无需配置公网回调地址）
2. 点击保存完成订阅方式设置

步骤 6：添加接收消息事件

1. 点击添加事件
2. 搜索并勾选接收消息 v2.0（im.message.receive_v1）
3. 点击添加完成事件订阅

步骤 7：开通关联权限

1. 弹出权限推荐窗口时，点击确认开通权限
2. 回到事件列表，检查所有依赖权限均为已开通状态

步骤 8：批量导入完整权限

1. 左侧进入权限管理 ，点击批量导入 / 导出权限
2. 全选删除默认内容，粘贴完整权限 JSON 配置
3. 点击下一步，确认新增权限

步骤 9：确认数据范围

1. 出现数据范围配置时，保持与应用的可用范围一致
2. 点击确认完成权限导入

步骤 10：创建并发布应用版本

1. 点击创建版本 或进入版本管理与发布
2. 设置版本号（如 1.0.0），移动端与桌面端默认能力选择机器人
3. 填写更新说明，点击保存 →确认发布
4. 个人账号通常免审发布，企业账号需管理员审核通过

步骤 11：复制应用凭证

1. 左侧进入凭证与基础信息
2. 复制App ID 与App Secret备用

三、OpenClaw 飞书渠道配置

1. 打开 OpenClaw v2.6.6，确认Gateway 在线
2. 点击右上角设置 →聊天配置
3. 找到 **Feishu/Lark（飞书）** 渠道
4. 填入复制的App ID 与App Secret
5. 开启渠道开关，点击保存渠道配置

四、接入完成自检清单

• 飞书应用已添加机器人能力
• 事件订阅使用长连接接收事件
• 已添加 im.message.receive_v1 接收消息事件
• 所有关联权限均已开通
• 应用版本已保存并发布
• OpenClaw 已正确填写并保存飞书凭证

五、常见问题排查

1. 机器人无响应

   • 检查应用是否发布成功
   • 确认事件订阅与权限配置完整
   • 重启 OpenClaw Gateway 后重试
   • 核对 App ID 与 App Secret 无多余空格

2. 无需配置回调地址

   • 本教程采用长连接模式，无需填写公网回调地址

3. 权限配置说明

   • 基础对话可仅开通必要权限
   • 需使用多维表格、云文档等功能，建议导入完整权限 JSON

安装包下载：https://xiake.yun/api/download/package/12?promoCode=IV4E9B04A80C