跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PythonSaaSAI

OpenClaw 飞书机器人配置教程

OpenClaw 飞书机器人配置指南。通过飞书开放平台创建企业自建应用,添加机器人能力并批量导入权限。配置事件订阅使用长连接接收消息,发布应用后获取 App ID 和 Secret 填入 OpenClaw 聊天渠道设置。完成重启后即可在飞书发送自然语言指令,由 OpenClaw 自动拆解任务操控电脑执行办公、文件整理及浏览器操作。常见问题包括未发布、权限未开通或凭证错误。

不羁发布于 2026/4/9更新于 2026/5/2314 浏览
OpenClaw 飞书机器人配置教程

适配版本:OpenClaw v2.3.12/v2.4.1(小龙虾)

前置要求:已部署 OpenClaw Windows 端(Win10/Win11 均可),未部署可先下载一键部署包完成安装

核心效果:配置完成后,可在飞书聊天窗口直接向机器人发送自然语言指令,OpenClaw 自动拆解任务、操控电脑完成操作,实现飞书远程下达 AI 任务

一、配置前必看

  1. 需拥有飞书账号,个人 / 企业账号均可,企业账号需确保有应用开发权限
  2. OpenClaw 需保持正常运行(Gateway 在线),配置过程中无需关闭
  3. 飞书开放平台操作全程按步骤执行,权限导入、事件订阅缺一不可,否则机器人无法响应
  4. 配置完成后需重启 OpenClaw,确保凭证生效

二、第一步:进入飞书开放平台并登录开发者后台

  1. 打开飞书开放平台官方地址:https://open.feishu.cn/

使用飞书账号扫码 / 密码登录,进入开发者后台(首次登录无需额外认证,个人账号可直接使用)

[图片:飞书开放平台登录界面]

三、第二步:创建企业自建应用

  1. 在开发者后台首页,点击创建应用按钮
  2. 应用类型选择企业自建应用(仅本企业 / 个人可使用,无需上架审核,快速生效)

进入应用创建页面,准备填写基础信息

[图片:创建应用入口]

四、第三步:填写应用基础信息

按要求填写以下信息,填写完成后点击创建:

  • 应用名称:自定义(如:OpenClaw 机器人、小龙虾 AI、虾壳云),建议便于识别
  • 应用描述:简要说明(如:OpenClaw AI 智能体,飞书聊天下达指令),字数≤120
  • 应用图标:自定义上传(JPEG/PNG/SVG/BMP 格式,2MB 以内,分辨率≥240*240px),可使用 OpenClaw 龙虾 Logo,便于飞书内识别

注:信息可后续修改,创建后进入应用配置主界面

[图片:应用基础信息填写]

五、第四步:为应用添加「机器人」能力

  1. 进入应用配置页,左侧菜单栏找到添加应用能力选项并点击
  2. 在能力列表中选择机器人,点击右侧添加按钮

添加完成后,左侧菜单栏会出现「机器人」相关配置项,说明能力添加成功

[图片:添加机器人能力]

六、第五步:批量导入机器人核心权限(关键步骤)

OpenClaw 需调用飞书消息、文档、表格等接口,需提前开通对应权限,批量导入可一次性完成,避免手动添加遗漏

  1. 左侧菜单栏进入权限管理,找到批量导入 / 导出权限按钮并点击
  2. 选择应用身份权限,将以下 JSON 代码完整粘贴至输入框,点击格式化 JSON(避免格式错误)
  3. 点击下一步,确认新增权限,再点击申请开通,等待权限开通成功(个人账号免审核,立即生效;企业账号需管理员审核)
完整权限 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. 左侧菜单栏进入事件与回调,选择事件配置
  2. 订阅方式修改为:使用长连接接收事件(推荐,无需配置公网域名,个人账号首选),点击保存
  3. 点击添加事件,在搜索框输入接收消息,选择接收消息 v2.0(im.message.receive_v1)

勾选事件后点击添加,完成消息订阅配置(飞书发送的消息将通过长连接推送给 OpenClaw)

[图片:事件订阅配置]

八、第七步:发布应用,使所有配置生效

  1. 左侧菜单栏进入版本管理与发布,点击创建版本
  2. 填写版本信息:
    • 应用版本号:自定义(如:1.0.0,按常规版本号填写即可)
    • 更新说明:简要填写(如:OpenClaw 飞书机器人初始配置)
    • 移动端 / 桌面端默认能力:均选择机器人

滑动至页面底部,点击保存,再点击确认发布

注:个人未认证账号发布后免审核,立即生效;企业认证账号需进入飞书管理后台完成应用审核后生效

[图片:版本发布流程]

九、第八步:获取应用凭证,配置至 OpenClaw

  1. 左侧菜单栏进入凭证与基础信息,找到应用凭证板块
  2. 复制 App ID 和 App Secret(需完整复制,不含空格,建议手动复制避免粘贴错误)
  3. 打开已运行的 OpenClaw 主界面,点击右上角设置,选择左侧聊天渠道
  4. 在渠道列表中找到 Feishu(飞书),点击进入配置页
  5. 将复制的 App ID 和 App Secret 分别粘贴至对应输入框

点击页面底部保存渠道配置,OpenClaw 将自动重启,等待 Gateway 重新在线即配置完成

[图片:凭证配置]

十、第九步:飞书端使用 OpenClaw 机器人(最终步骤)

  1. 打开飞书 PC / 手机端,在顶部搜索栏输入你创建的应用名称(如:OpenClaw 机器人)
  2. 点击进入机器人聊天窗口,发送任意测试指令(如:'你好'、'帮我整理桌面文件')

若机器人正常回复 / 执行指令,说明配置成功;若无响应,按下方问题排查检查

[图片:飞书机器人测试]

十一、常见问题排查(机器人无响应 / 指令执行失败)

  1. 飞书应用未发布:返回飞书开放平台,确认版本已发布且审核通过(个人账号检查是否点击'确认发布')
  2. 权限未开通:进入权限管理,检查是否所有权限均显示'已开通',未开通则重新批量导入并申请
  3. App ID/Secret 复制错误:检查 OpenClaw 飞书配置页的凭证是否与飞书开放平台一致,有无多字 / 少字 / 空格
  4. OpenClaw 未重启:配置完成后需确保 OpenClaw 自动重启,若未重启,手动点击右上角重启 Gateway
  5. 长连接未生效:返回飞书事件与回调,确认订阅方式为'长连接',重新保存后再测试
  6. OpenClaw 未正常部署:检查 Gateway 是否显示'在线',若离线,重新运行 OpenClaw 一键启动程序

十二、附:OpenClaw 飞书机器人常用指令示例

配置成功后,可在飞书聊天窗口直接发送以下指令,AI 自动操控电脑完成:

  • 办公类:「帮我打开 Excel,制作一份本周工作汇报表格,保存到 D 盘」
  • 文件类:「整理 D 盘下载文件夹,按文件类型分类创建文件夹」
  • 浏览器类:「打开浏览器,搜索 2026 年 AI 智能体发展趋势,整理成文档」
  • 消息类:「帮我给飞书备注'同事 A'发送消息,内容是'工作汇报已发至你邮箱'」

目录

  1. 一、配置前必看
  2. 二、第一步:进入飞书开放平台并登录开发者后台
  3. 三、第二步:创建企业自建应用
  4. 四、第三步:填写应用基础信息
  5. 五、第四步:为应用添加「机器人」能力
  6. 六、第五步:批量导入机器人核心权限(关键步骤)
  7. 完整权限 JSON 代码(直接复制)
  8. 七、第六步:配置事件订阅,实现飞书消息接收
  9. 八、第七步:发布应用,使所有配置生效
  10. 九、第八步:获取应用凭证,配置至 OpenClaw
  11. 十、第九步:飞书端使用 OpenClaw 机器人(最终步骤)
  12. 十一、常见问题排查(机器人无响应 / 指令执行失败)
  13. 十二、附:OpenClaw 飞书机器人常用指令示例
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • WebRTC 远程屏幕共享:零配置实现浏览器直连桌面
  • YOLO 训练数据去重:使用 GPU 加速哈希比对
  • Qlib:AI 导向量化投资平台入门指南
  • AI Coding 提效实战:从工具到思维的全面升级
  • SVD 奇异值分解原理、推导及应用实例
  • JavaScript 表格处理指南:数据流转到动态可视化
  • AI 普及时代,个人如何构建核心竞争力?
  • AI 时代如何脱颖而出:商业认知与行动指南
  • 使用 Trae 插件 Builder 模式开发端午包粽子小游戏
  • Python 3.12 安装库报错:pkgutil.ImpImporter 缺失
  • STL 转 STEP 工具 stltostp 使用指南
  • OpenClaw 接入飞书机器人与 Kimi2.5 配置指南
  • OpenClaw 部署环境要求:CPU、内存与系统配置清单
  • 鸿蒙操作系统开发实战:技术突破与生态共建指南
  • 规范驱动编程:AI 工具 Kiro 前端验证及调整实测
  • MCP Document Reader:AI 助手读取本地文档工具
  • Android Studio 集成 GitHub Copilot GPT-4o:AI 辅助开发实战与避坑指南
  • Ψ0 人形全身 VLA:基于人类视频预训练与 MM-DiT 后训练方案
  • C++ 测试与调试实战:保障代码质量与稳定性
  • vscode copilot 的配置文件提示警告

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online