OpenClaw(小龙虾)飞书机器人配置教程 远程下达AI任务

举报
yd_251508888 发表于 2026/05/12 09:20:39 2026/05/12
【摘要】 本文适配OpenClaw v2.3.12/v2.4.1版本,前置需部署其Windows端,核心实现飞书聊天窗口远程下达自然语言指令,让AI操控电脑完成任务。教程详细讲解从飞书开放平台登录、企业自建应用创建、权限导入、事件订阅,到应用发布、凭证配置及飞书端使用的全流程,附权限JSON代码、常见问题排查及常用指令,步骤清晰,适配小白,全程可快速完成配置。
适配版本:OpenClaw v2.3.12/v2.4.1(小龙虾)
前置要求:已部署 OpenClaw Windows 端(Win10/Win11 均可),未部署可先下载一键部署包完成安装
核心效果:配置完成后,可在飞书聊天窗口直接向机器人发送自然语言指令,OpenClaw 自动拆解任务、操控电脑完成操作,实现飞书远程下达 AI 任务
📌 一键部署包下载地址

ff1397f876566f13258b093caf813363.png


✅ 免配置、免命令行、解压即用,内置所有运行依赖,部署完成后再进行飞书配置即可
(此教程配合这个安装包使用)

一、配置前必看

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

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

  1. 打开飞书开放平台官方地址:https://open.feishu.cn
  2. 使用飞书账号扫码 / 密码登录,进入开发者后台(第一次登录无需额外认证,个人账号可直接使用)

20260323042452382_e46bb1c2088a480b9593aa7b75b1c301.png

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

  1. 在开发者后台首页,点击创建应用按钮
  2. 应用类型选择企业自建应用(仅本企业 / 个人可使用,无需上架审核,快速生效)
  3. 进入应用创建页面,准备填写基础信息

20260323042436428_bbfaeb62280b4433a3f331298a472373.png

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

按要求填写以下信息,填写完成后点击创建:
  • • 应用名称:自定义(如:OpenClaw 机器人、小龙虾 AI、虾壳云),建议便于识别
  • • 应用描述:简要说明(如:OpenClaw AI 智能体,飞书聊天下达指令),字数≤120
  • • 应用图标:自定义上传(JPEG/PNG/SVG/BMP 格式,2MB 以内,分辨率≥240*240px),可使用 OpenClaw 龙虾 Logo,便于飞书内识别
✅ 注:信息可后续修改,创建后进入应用配置主界面

20260323042509119_c0015a149c24440dbd8c7d0607a064ab.png

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

  1. 进入应用配置页,左侧菜单栏找到添加应用能力选项并点击
  2. 在能力列表中选择机器人,点击右侧添加按钮
  3. 添加完成后,左侧菜单栏会出现「机器人」相关配置项,说明能力添加成功

20260323042553787_194fbf2a233e4da6b88fb79747bf4bb2.png

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

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)
  4. 勾选事件后点击添加,完成消息订阅配置(飞书发送的消息将通过长连接推送给 OpenClaw)


20260323042804208_a4ea7db91bcc4d778b1da50194e5a7f7.png

20260323042817659_f7ab510845e0492b9e2b46defec9c391.png

20260323042826702_279de6de69d8451a8c8f23a76318bc23.png

20260323042900323_7a2146439ba44c2c9d04ce75972fb179.png

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

  1. 左侧菜单栏进入版本管理与发布,点击创建版本
  2. 填写版本信息:
    1. ◦ 应用版本号:自定义(如:1.0.0,按常规版本号填写即可)
    2. ◦ 更新说明:简要填写(如:OpenClaw 飞书机器人初始配置)
    3. ◦ 移动端 / 桌面端默认能力:均选择机器人
  3. 滑动至页面底部,点击保存,再点击确认发布
✅ 注:个人未认证账号发布后免审核,立即生效;企业认证账号需进入飞书管理后台完成应用审核后生效


20260323042915160_f1d414acb855442882cb0db77de3e2cf.png

20260323042926097_b9325502265c4b07bfb76a9a855eeec6.png

20260323042938112_863d43130554420b93f4bce4fffc43f7.png

20260323042946036_1c45c54e35634a9790a107699ba537ce.png

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

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


20260323042959209_3993bd6499784e6287f3db25acdd11c2.png

20260323043022991_6b989fc63a5f47b4859d608254fb669b.png

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

  1. 打开飞书 PC / 手机端,在顶部搜索栏输入你创建的应用名称(如:OpenClaw 机器人)
  2. 点击进入机器人聊天窗口,发送任意测试指令(如:“你好”、“帮我整理桌面文件”)
  3. 若机器人正常回复 / 执行指令,说明配置成功;若无响应,按下方问题排查检查

20260323043033510_803eeed021c14e31a3e8626c2706eaee.png

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

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

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

配置成功后,可在飞书聊天窗口直接发送以下指令,AI 自动操控电脑完成:
  • • 办公类:「帮我打开 Excel,制作一份本周工作汇报表格,保存到 D 盘」
  • • 文件类:「整理 D 盘下载文件夹,按文件类型分类创建文件夹」
  • • 浏览器类:「打开浏览器,搜索 2026 年 AI 智能体发展趋势,整理成文档」
  • • 消息类:「帮我给飞书备注 “同事 A” 发送消息,内容是 “工作汇报已发至你邮箱”」
📌 再次附上 OpenClaw Windows 一键部署包下载地址
🔗 

ff1397f876566f13258b093caf813363.png

✅ 未部署的用户先下载安装,部署完成后按本教程配置,全程 10 分钟即可实现飞书对接 OpenClaw!
转载请注明出处,后续将更新 OpenClaw 微信 / 钉钉等渠道对接教程,持续关注获取更多干货!

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。