当前位置： 首页 > news >正文

【几分钟搞定】OpenClaw 聊天渠道配置 飞书对接方法（包含安装包）

news 2026/6/1 9:27:52

OpenClaw 绑定飞书详细教程

OpenClaw 连接飞书图文教程，结合飞书开放平台最新页面与 OpenClaw Windows 配置流程整理，适用于先在飞书开放平台创建企业自建应用，再将 App ID 与 App Secret 填入 OpenClaw 完成接入的流程。

核心说明：OpenClaw 飞书渠道仅需填写App ID与App Secret两个参数；飞书侧建议选择长连接接收事件，依次完成应用创建、机器人能力添加、事件订阅、权限开通、版本发布五个关键环节。

前置准备

  • 已安装并可正常启动 OpenClaw Windows 客户端
  • 已登录飞书开放平台并进入开发者后台
  • 拥有可使用的飞书组织 / 企业空间
  • 企业账号发布应用需经企业管理员审核

详细配置步骤

步骤 1：打开飞书开放平台并创建企业自建应用

访问飞书开放平台：https://open.feishu.cn/app进入页面后点击右上角开发者后台，选择创建企业自建应用。

步骤 2：填写应用基础信息

设置应用名称、描述、头像（JPEG/PNG/SVG/BMP 格式，2MB 以内，尺寸≥240×240px），完成后点击创建。

步骤 3：添加机器人应用能力

进入应用管理页，点击左侧添加应用能力，在列表中找到机器人并点击添加。

步骤 4：进入事件与回调配置

左侧菜单栏选择事件与回调，在事件配置区域点击订阅方式右侧编辑按钮。

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

请勿选择 “将事件发送至开发者服务器”，直接勾选使用长连接接收事件并保存，该模式无需配置公网回调地址。

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

保存订阅方式后，在已添加事件区域点击添加事件，搜索并勾选接收消息 v2.0（im.message.receive_v1），点击添加。

步骤 7：开通事件关联权限

飞书弹出推荐开通权限提示时，点击确认开通权限，确保消息接收功能正常。

步骤 8：检查权限开通状态

返回事件列表，展开权限说明，确认所有依赖权限均为已开通状态，未开通权限点击名称手动补开。

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

  1. 左侧进入权限管理，点击批量导入 / 导出权限
  2. 清空默认内容，粘贴以下完整权限 JSON：

json

{ "scopes": { "tenant": [ "aily:message:read", "aily:message:write", "base:app:copy", "base:app:create", "base:app:read", "base:app:update", "base:collaborator:create", "base:collaborator:delete", "base:collaborator:read", "base:dashboard:copy", "base:dashboard:read", "base:field:create", "base:field:delete", "base:field:read", "base:field:update", "base:form:read", "base:form:update", "base:record:create", "base:record:delete", "base:record:read", "base:record:retrieve", "base:record:update", "base:role:create", "base:role:delete", "base:role:read", "base:role:update", "base:table:create", "base:table:delete", "base:table:read", "base:table:update", "base:view:read", "base:view:write_only", "bitable:app", "bitable:app:readonly", "board:whiteboard:node:create", "board:whiteboard:node:delete", "board:whiteboard:node:read", "board:whiteboard:node:update", "cardkit:card:write", "contact:contact.base:readonly", "contact:user.base:readonly", "contact:user.employee_id:readonly", "contact:user.employee_number:read", "contact:user.id:readonly", "docs:doc", "docs:doc:readonly", "docs:document.comment:create", "docs:document.comment:read", "docs:document.comment:update", "docs:document.comment:write_only", "docs:document.content:read", "docs:document.media:download", "docs:document.media:upload", "docs:document.subscription", "docs:document.subscription:read", "docs:document:copy", "docs:document:export", "docs:document:import", "docs:event.document_deleted:read", "docs:event.document_edited:read", "docs:event.document_opened:read", "docs:event:subscribe", "docs:permission.member", "docs:permission.member:auth", "docs:permission.member:create", "docs:permission.member:delete", "docs:permission.member:readonly", "docs:permission.member:retrieve", "docs:permission.member:transfer", "docs:permission.member:update", "docs:permission.setting", "docs:permission.setting:read", "docs:permission.setting:readonly", "docs:permission.setting:write_only", "docx:document", "docx:document.block:convert", "docx:document:create", "docx:document:readonly", "drive:drive", "drive:drive.metadata:readonly", "drive:drive.search:readonly", "drive:drive:readonly", "drive:drive:version", "drive:drive:version:readonly", "drive:export:readonly", "drive:file", "drive:file.like:readonly", "drive:file.meta.sec_label.read_only", "drive:file:download", "drive:file:readonly", "drive:file:upload", "drive:file:view_record:readonly", "event:ip_list", "im:app_feed_card:write", "im:chat", "im:chat.members:read", "im:chat:read", "im:message", "im:message.group_msg", "im:message:send_as_bot", "im:message:readonly", "im:message:update", "sheets:spreadsheet", "sheets:spreadsheet:create", "sheets:spreadsheet:read", "space:folder:create", "wiki:node:create", "wiki:node:read", "wiki:node:update", "wiki:space:read" ], "user": [] } }
  1. 点击下一步，确认新增权限

步骤 10：确认数据访问范围

出现数据范围配置时，保持默认与应用的可用范围一致，点击确认。

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

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

步骤 12：复制应用凭证

左侧进入凭证与基础信息，复制App ID与App Secret。

步骤 13：OpenClaw 端配置

  1. 启动 OpenClaw Windows（v2.7.8），点击右上角设置→聊天配置
  2. 找到Feishu/Lark（飞书）配置项，填入复制的 App ID 与 App Secret
  3. 打开右侧启用开关，点击保存渠道配置

接入完成自检清单

  1. 飞书应用已添加机器人能力
  2. 事件与回调使用长连接接收事件
  3. 已添加 im.message.receive_v1 接收消息事件
  4. 所有关联权限均已开通
  5. 应用版本已保存并发布
  6. App ID 与 App Secret 正确填入 OpenClaw
  7. OpenClaw 已保存渠道配置

常见问题排查

  1. OpenClaw 配置后飞书机器人无响应

    • 确认飞书应用已发布成功
    • 检查事件是否为 im.message.receive_v1
    • 确认订阅方式为长连接接收事件
    • 重启 OpenClaw Gateway 服务
    • 核对 App ID/App Secret 无多余空格

  2. 无需配置公网回调地址本流程采用飞书官方长连接模式，仅需 App ID 与 App Secret，无需手动配置 webhook URL。

  3. 权限是否必须完整导入仅测试消息收发可只开通基础权限；需使用文档、多维表格等扩展能力，建议完整导入权限 JSON。

打开下载最新版的openclaw链接：https://xiake.yun/api/download/package/17?promoCode=IV4E9B04A80C点击页面对应按钮，直接获取最新版安装包下载完成后，在浏览器下载文件夹 / 桌面找到压缩包（文件大小约 45.8MB，建议用浏览器自带下载 / 迅雷，避免中断）

http://www.jsqmd.com/news/917720/

相关文章：

  • 机器人基础模型：从预训练到部署的技术演进与应用挑战
  • 终极指南：如何为Minecraft MASA模组全家桶安装完整中文汉化包
  • 基于Arduino与PID控制的自平衡机器人设计与实现
  • 告别‘天书’公式：用动画和Tanner图轻松理解LDPC码的译码原理
  • 告别‘黑盒’探索：用Hindsight Experience Replay (HER) 手把手教你搞定分层强化学习里的非平稳难题
  • TinkerCAD仿真入门：三按钮控制RGB LED混色电路设计与实践
  • 2026年上海家装十大品牌靠谱榜单，多维测评优选本地装企 - 商业新知
  • 基于树莓派与MagicMirror²打造智能镜子：从硬件选型到软件部署全攻略
  • 2026年阿拉善左旗TOP4高性价比电器门店，哪家才是真正最低价？
  • 告别闭集检测：用Open-Vocabulary Detection（OVD）让YOLO也能识别训练集外的物体
  • 微信小程序里H5地图导航的坑，我帮你踩完了（附wx.openLocation返回web-view的终极方案）
  • 算力拉满，GPU 却在摸鱼：深度学习里的访存瓶颈
  • 从BEV检测实战出发：深入理解Nuscenes与Argoverse数据集的坐标系‘基因’差异
  • 重邮802数据结构130分魔咒怎么破？我用Python和C++双版本代码带你实战新大纲考点
  • 从RAII设计模式看C++11锁管理：手把手教你实现一个简易版的lock_guard
  • 苏州做 GEO 效果怎么样？2026年行业实践解析 - 品牌排行榜
  • Gemini多模态对齐失效诊断与修复（工业级部署避坑指南）
  • 如何在电脑上畅玩Switch游戏：yuzu模拟器完整入门指南
  • 全品类宠品售卖｜活体猫狗、品牌粮品、用品玩具一站式配齐 - 余生黄金回收
  • 如何在Windows上高效安装安卓应用：APK安装器完整指南
  • go swagger慢
  • 如何通过APKMirror安全获取安卓应用？这款开源客户端为你提供官方商店外的可靠选择
  • 2026年石家庄GEO优化权威排名：调研AI核心数据于深度解析指南优化避坑指南 - 资讯纵览
  • 2018技术趋势盘点：AI伦理、数据隐私与平台治理的反思与应对
  • 前端性能优化：打包优化策略完全指南
  • OBS-Multi-RTMP：一键开启多平台直播推流的终极解决方案
  • 用Python的Pulp库搞定NDDF模型：一个环境经济学研究生的效率测算实战笔记
  • 如何用ZonyLrcToolsX一键解决音乐库的歌词缺失难题：3步完成智能匹配
  • beweb目录结构审视
  • APKMirror：你的安卓应用安全下载管家，告别官方商店的三大痛点