跳到主要内容
编程语言 AI
OpenClaw 飞书机器人配置教程：实现聊天下达 AI 指令 配置 OpenClaw 飞书机器人需先在飞书开放平台创建企业自建应用，添加机器人能力并批量导入消息、文档等核心权限。随后配置事件订阅为长连接接收模式并发布应用，获取 App ID 和 Secret 填入 OpenClaw 聊天渠道设置中。重启服务后，用户可在飞书聊天窗口发送自然语言指令，系统自动拆解任务并操控电脑执行。若遇无响应，需检查应用发布状态、权限开通情况及凭证准确性。
适配版本 ：OpenClaw v2.3.12/v2.4.1（小龙虾）前置要求 ：已部署 OpenClaw Windows 端（Win10/Win11 均可），未部署可先下载一键部署包完成安装核心效果 ：配置完成后，可在飞书聊天窗口直接向机器人发送自然语言指令，OpenClaw 自动拆解任务、操控电脑完成操作，实现飞书远程下达 AI 任务
一、配置前必看
需拥有飞书账号，个人 / 企业账号均可，企业账号需确保有应用开发权限
OpenClaw 需保持正常运行（Gateway 在线），配置过程中无需关闭
飞书开放平台操作全程按步骤执行，权限导入、事件订阅缺一不可，否则机器人无法响应
配置完成后需重启 OpenClaw，确保凭证生效
二、第一步：进入飞书开放平台并登录开发者后台
打开飞书开放平台官方地址：https://open.feishu.cn/
使用飞书账号扫码 / 密码登录，进入开发者后台（首次登录无需额外认证，个人账号可直接使用）
三、第二步：创建企业自建应用
在开发者后台首页，点击创建应用按钮
应用类型选择企业自建应用（仅本企业 / 个人可使用，无需上架审核，快速生效）
进入应用创建页面，准备填写基础信息
四、第三步：填写应用基础信息
按要求填写以下信息，填写完成后点击创建：
应用名称 ：自定义（如：OpenClaw 机器人、小龙虾 AI、虾壳云），建议便于识别应用描述 ：简要说明（如：OpenClaw AI 智能体，飞书聊天下达指令），字数≤120
应用图标 ：自定义上传（JPEG/PNG/SVG/BMP 格式，2MB 以内，分辨率≥240*240px），可使用 OpenClaw 龙虾 Logo，便于飞书内识别
✅ 注：信息可后续修改，创建后进入应用配置主界面
五、第四步：为应用添加「机器人」能力
进入应用配置页，左侧菜单栏找到添加应用能力选项并点击
在能力列表中选择机器人，点击右侧添加按钮
添加完成后，左侧菜单栏会出现「机器人」相关配置项，说明能力添加成功
六、第五步：批量导入机器人核心权限（关键步骤）
OpenClaw 需调用飞书消息、文档、表格等接口，需提前开通对应权限，批量导入可一次性完成，避免手动添加遗漏
左侧菜单栏进入权限管理，找到批量导入 / 导出权限按钮并点击
选择应用身份权限，将以下 JSON 代码完整粘贴至输入框，点击格式化 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"
:
[
]
}
}
七、第六步：配置事件订阅，实现飞书消息接收
左侧菜单栏进入事件与回调，选择事件配置
订阅方式修改为：使用长连接接收事件（推荐，无需配置公网域名，个人账号首选），点击保存
点击添加事件，在搜索框输入接收消息，选择接收消息 v2.0（im.message.receive_v1）
勾选事件后点击添加，完成消息订阅配置（飞书发送的消息将通过长连接推送给 OpenClaw）
八、第七步：发布应用，使所有配置生效
左侧菜单栏进入版本管理与发布，点击创建版本
填写版本信息：
应用版本号 ：自定义（如：1.0.0，按常规版本号填写即可）更新说明 ：简要填写（如：OpenClaw 飞书机器人初始配置）移动端 / 桌面端默认能力 ：均选择机器人
✅ 注：个人未认证账号发布后免审核，立即生效；企业认证账号需进入飞书管理后台完成应用审核后生效
九、第八步：获取应用凭证，配置至 OpenClaw
左侧菜单栏进入凭证与基础信息，找到应用凭证板块
复制 App ID 和 App Secret（需完整复制，不含空格，建议手动复制避免粘贴错误）
打开已运行的 OpenClaw 主界面，点击右上角设置，选择左侧聊天渠道
在渠道列表中找到 Feishu（飞书），点击进入配置页
将复制的 App ID 和 App Secret 分别粘贴至对应输入框
点击页面底部保存渠道配置，OpenClaw 将自动重启，等待 Gateway 重新在线即配置完成
十、第九步：飞书端使用 OpenClaw 机器人（最终步骤）
打开飞书 PC / 手机端，在顶部搜索栏输入你创建的应用名称（如：OpenClaw 机器人）
点击进入机器人聊天窗口，发送任意测试指令（如：'你好'、'帮我整理桌面文件'）
若机器人正常回复 / 执行指令，说明配置成功；若无响应，按下方问题排查检查
十一、常见问题排查（机器人无响应 / 指令执行失败）
飞书应用未发布 ：返回飞书开放平台，确认版本已发布且审核通过（个人账号检查是否点击'确认发布'）权限未开通 ：进入权限管理，检查是否所有权限均显示'已开通'，未开通则重新批量导入并申请App ID/Secret 复制错误 ：检查 OpenClaw 飞书配置页的凭证是否与飞书开放平台一致，有无多字 / 少字 / 空格OpenClaw 未重启 ：配置完成后需确保 OpenClaw 自动重启，若未重启，手动点击右上角重启 Gateway长连接未生效 ：返回飞书事件与回调，确认订阅方式为'长连接'，重新保存后再测试OpenClaw 未正常部署 ：检查 Gateway 是否显示'在线'，若离线，重新运行 OpenClaw 一键启动程序
十二、附：OpenClaw 飞书机器人常用指令示例 配置成功后，可在飞书聊天窗口直接发送以下指令，AI 自动操控电脑完成：
办公类：「帮我打开 Excel，制作一份本周工作汇报表格，保存到 D 盘」
文件类：「整理 D 盘下载文件夹，按文件类型分类创建文件夹」
浏览器类：「打开浏览器，搜索 2026 年 AI 智能体发展趋势，整理成文档」
消息类：「帮我给飞书备注'同事 A'发送消息，内容是'工作汇报已发至你邮箱'」
相关免费在线工具 RSA密钥对生成器 生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
Mermaid 预览与可视化编辑 基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
随机西班牙地址生成器 随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。 在线工具，随机西班牙地址生成器在线工具，online
Base64 字符串编码/解码 将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
Base64 文件转换器 将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
Markdown转HTML 将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
