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

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

news 2026/5/30 17:59:28

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.zskr.cn/news/1429037.html

相关文章：

  • 2026年阿拉善左旗TOP4高性价比电器门店，哪家才是真正最低价？
  • 从BEV检测实战出发：深入理解Nuscenes与Argoverse数据集的坐标系‘基因’差异
  • 苏州做 GEO 效果怎么样？2026年行业实践解析 - 品牌排行榜
  • go swagger慢
  • 如何在Windows上高效安装安卓应用：APK安装器完整指南
  • 如何通过APKMirror安全获取安卓应用？这款开源客户端为你提供官方商店外的可靠选择
  • 2026年石家庄GEO优化权威排名：调研AI核心数据于深度解析指南优化避坑指南 - 资讯纵览
  • OBS-Multi-RTMP：一键开启多平台直播推流的终极解决方案
  • Inkscape光线追踪扩展终极指南：5分钟创建专业光学图表
  • 2026年锡林浩特哪些电器门店值得放心？看这份TOP5榜单
  • 终极免费视频下载助手：VideoDownloadHelper Chrome插件完全指南
  • NX二次开发避坑实录：多线程调用UF函数时，为什么我的程序总崩溃？
  • 上海哪个区注册公司最划算 - 资讯纵览
  • 【五分钟完成】Windows 本地部署 Hermes 一键快速搭建教程（包含安装包）
  • 多格式文件解析：JSONL / SQLite / Event Stream
  • 2026年泸州白酒OEM定制代工全景拆解：源头酒厂如何为B端客户构建专属供应链 - 优质企业观察收录
  • 告别SIFT的复杂计算：用Python+OpenCV实战SURF特征点检测（保姆级代码解析）
  • 随身wifi哪种好推荐一下，2026高口碑品牌实测零风险 - 资讯纵览
  • 2026年压力机/挤压机/轮辐旋压机/复合材料压机/粉末成形压机厂家权威推荐：多维度实力与高精度成形技术深度解析 - 品牌企业推荐师（官方）
  • G-Helper深度解析：华硕笔记本性能调优与硬件控制的终极开源方案
  • AMD新平台装CentOS 7.9翻车实录：从Kernel Panic到换Rocky Linux 9.2的完整避坑指南
  • 终极指南：5个简单步骤用Ice打造清爽macOS菜单栏
  • Tauri 2.x 踩坑记：用Vue3+Element Plus做自定义标题栏，data-tauri-drag-region不生效怎么办？
  • 2026 光伏储能公司推荐，新政配储并网避坑指南，筛选资质齐全靠谱供货合作厂家 - 品牌榜中榜
  • 国信中业—飞秒瞬态吸收光谱（TAs）系统
  • DRV8833 电机驱动芯片配套电机选型指南：JGB37-520 深度匹配与应用实战
  • 微服务架构下生日祝福功能的设计与实现：从事件驱动到容错处理
  • AIOps智能运维实战：从数据治理到算法落地的渐进式指南
  • 左连接 LEFT JOIN｜工作使用率最高，实战场景详解（避坑重点）
  • 2026年泸州白酒OEM定制全产业链服务商深度解析：源头酒厂如何成为B端供应链的核心锚点 - 优质企业观察收录