跳到主要内容编程语言SaaSAI
OpenClaw 飞书机器人配置:通过聊天窗口下达 AI 指令
OpenClaw 飞书机器人配置指南。步骤涵盖飞书开放平台登录、企业自建应用创建、权限批量导入、事件订阅配置及应用发布。获取 App ID 与 Secret 后填入 OpenClaw 设置即可启用。支持在飞书聊天窗口发送自然语言指令,系统自动拆解任务并操控电脑执行。文末附带常见问题排查及办公、文件等场景指令示例。
HadoopMan17 浏览 OpenClaw 飞书机器人配置指南
本教程基于 OpenClaw v2.3.12/v2.4.1(小龙虾)版本,适用于 Windows 端(Win10/Win11)。配置完成后,你可在飞书聊天窗口直接向机器人发送自然语言指令,OpenClaw 会自动拆解任务并操控电脑完成操作。
配置前须知
- 需拥有飞书账号(个人/企业均可),企业账号请确保有应用开发权限。
- OpenClaw 需保持正常运行(Gateway 在线),配置过程中无需关闭。
- 飞书开放平台操作全程按步骤执行,权限导入、事件订阅缺一不可。
- 配置完成后建议重启 OpenClaw,确保凭证生效。
登录飞书开放平台
打开飞书开放平台官网,使用飞书账号扫码或密码登录进入开发者后台。首次登录个人账号可直接使用,无需额外认证。
![截图]
创建企业自建应用
在开发者后台首页点击创建应用按钮,选择企业自建应用。此类应用仅本企业或个人可使用,无需上架审核,快速生效。
进入应用创建页面后,按要求填写基础信息:
- 应用名称:自定义(如:OpenClaw 机器人),便于识别。
- 应用描述:简要说明(如:OpenClaw AI 智能体,飞书聊天下达指令),字数≤120。
- 应用图标:上传 Logo(JPEG/PNG/SVG/BMP 格式,2MB 以内,分辨率≥240*240px)。
信息可后续修改,填写完成后点击创建进入主界面。
![截图]
添加机器人能力
进入应用配置页,左侧菜单栏找到添加应用能力选项,在列表中选择机器人并点击右侧添加按钮。添加成功后,左侧菜单会出现「机器人」相关配置项。
![截图]
批量导入核心权限
OpenClaw 需调用飞书消息、文档、表格等接口,建议一次性导入所有核心权限,避免手动遗漏。
- 左侧菜单进入权限管理,找到批量导入 / 导出权限按钮。
- 选择应用身份权限,将以下 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"
:
[
]
}
}
配置事件订阅
为了让 OpenClaw 能接收飞书消息,我们需要配置回调。
- 左侧菜单进入事件与回调,选择事件配置。
- 订阅方式修改为:使用长连接接收事件(推荐,无需公网域名,个人账号首选),点击保存。
- 点击添加事件,搜索接收消息,选择接收消息 v2.0(im.message.receive_v1)。
- 勾选后点击添加,完成配置。
此时飞书发送的消息将通过长连接推送给 OpenClaw。
发布应用
- 左侧菜单进入版本管理与发布,点击创建版本。
- 填写版本号(如 1.0.0)和更新说明(如:OpenClaw 飞书机器人初始配置)。
- 移动端/桌面端默认能力均选择机器人。
- 滑动到底部点击保存,再点击确认发布。
提示:个人未认证账号发布后免审核立即生效;企业认证账号需进入管理后台完成应用审核。
获取凭证并配置 OpenClaw
最后一步是将飞书应用的凭证填入 OpenClaw。
- 左侧菜单进入凭证与基础信息,找到应用凭证板块。
- 复制App ID和App Secret(建议手动复制,避免空格错误)。
- 打开已运行的 OpenClaw 主界面,点击右上角设置,选择左侧聊天渠道。
- 在列表中找到Feishu(飞书),点击进入配置页。
- 将复制的App ID和App Secret分别粘贴至对应输入框。
- 点击底部保存渠道配置,OpenClaw 将自动重启,等待 Gateway 重新在线即完成。
测试与常见问题
测试流程
- 打开飞书 PC/手机端,顶部搜索栏输入你创建的应用名称。
- 点击进入机器人聊天窗口,发送任意测试指令(如:'你好'、'帮我整理桌面文件')。
- 若机器人正常回复或执行指令,说明配置成功。
排查无响应问题
- 应用未发布:返回开放平台确认版本已发布且审核通过。
- 权限未开通:检查权限管理是否显示'已开通',未开通则重新申请。
- 凭证错误:核对 OpenClaw 配置页的 App ID/Secret 是否与开放平台一致。
- 未重启:配置完成后确保 OpenClaw 自动重启,若未重启可手动点击右上角重启 Gateway。
- 长连接失效:返回事件与回调确认订阅方式为'长连接',重新保存后再测。
- 部署异常:检查 Gateway 是否显示'在线',若离线请重新运行一键启动程序。
常用指令示例
配置成功后,可在飞书聊天窗口直接发送以下指令,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