跳到主要内容OpenClaw 飞书机器人配置指南:聊天窗口下达 AI 指令 | 极客日志PythonAI
OpenClaw 飞书机器人配置指南:聊天窗口下达 AI 指令
本教程详解 OpenClaw 与飞书机器人的对接流程,实现聊天窗口下达 AI 指令控制电脑。步骤包括飞书开放平台应用创建、权限批量导入、事件订阅配置及凭证获取。完成设置后,支持通过长连接接收消息,无需公网域名。常见问题涵盖应用发布状态、权限开通及凭证准确性检查,确保自动化任务顺利执行。
心动瞬间12 浏览 前置准备
确保已部署 OpenClaw Windows 端(支持 Win10/Win11),并拥有飞书账号。个人或企业账号均可,企业账号需具备应用开发权限。配置过程中保持 OpenClaw Gateway 在线,无需关闭。
一、登录飞书开放平台
访问飞书开放平台官网,使用飞书账号扫码或密码登录进入开发者后台。首次登录个人账号通常无需额外认证即可直接使用。
二、创建企业自建应用
在开发者后台首页点击'创建应用',选择'企业自建应用'。此类应用仅本企业或个人可使用,无需上架审核,快速生效。
三、填写应用基础信息
按以下要求填写后点击创建:
- 应用名称:自定义(如 OpenClaw 机器人),便于识别。
- 应用描述:简要说明用途,字数不超过 120。
- 应用图标:上传 JPEG/PNG/SVG/BMP 格式图片,分辨率建议≥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"
:
[
]
}
}
- 进入'事件与回调',选择'事件配置'。
- 订阅方式修改为'使用长连接接收事件',无需配置公网域名,保存即可。
- 点击'添加事件',搜索'接收消息',选择'接收消息 v2.0(im.message.receive_v1)'。
- 勾选后点击添加,完成消息订阅配置。
- 进入'版本管理与发布',点击'创建版本'。
- 填写版本号(如 1.0.0)和更新说明。
- 移动端/桌面端默认能力均选择'机器人'。
- 保存并确认发布。个人未认证账号免审核立即生效;企业认证账号需完成应用审核后生效。
- 进入'凭证与基础信息',复制 App ID 和 App Secret(注意不含空格)。
- 打开 OpenClaw 主界面,点击右上角设置,选择左侧'聊天渠道'。
- 找到 Feishu(飞书)入口,将 App ID 和 App Secret 分别粘贴至对应输入框。
- 保存渠道配置,OpenClaw 将自动重启,等待 Gateway 重新在线即完成。
在飞书 PC/手机端搜索创建的应用名称,进入聊天窗口发送测试指令(如'你好')。若机器人正常回复或执行指令,说明配置成功。
- 飞书应用是否已发布且审核通过。
- 权限管理内所有权限是否显示'已开通'。
- App ID/Secret 是否完全一致,有无多余字符。
- OpenClaw 是否已完成重启,Gateway 状态是否为在线。
- 事件订阅方式是否确认为'长连接'。
配置成功后,可在飞书聊天窗口直接发送自然语言指令,AI 自动操控电脑完成操作:
- 办公类:帮我打开 Excel,制作一份本周工作汇报表格,保存到 D 盘
- 文件类:整理 D 盘下载文件夹,按文件类型分类创建文件夹
- 浏览器类:打开浏览器,搜索 2026 年 AI 智能体发展趋势,整理成文档
- 消息类:帮我给飞书备注同事 A 发送消息,内容是工作汇报已发至你邮箱
相关免费在线工具
- 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