OpenClaw飞书机器人配置全流程:飞书聊天下达AI指令,远程操控电脑

前言
OpenClaw(小龙虾)v2.4.1版本支持飞书机器人对接,完成配置后,可直接在飞书聊天窗口向机器人发送自然语言指令,由OpenClaw自动拆解任务、操控电脑执行操作,实现飞书端远程下达AI任务的效果。
本文适配OpenClaw Windows端(Win10/Win11 系统均可),需先完成OpenClaw的部署,其Windows一键部署包内置所有运行依赖,解压即可使用,部署完成后可按照本文步骤进行飞书机器人的配置。
📌 OpenClaw Windows 一键部署包下载地址🔗 https://xiake.yun/api/download/package/2?promoCode=IV4B6E03CE39
✅ 免配置、免命令行 、解压即用,内置所有运行依赖,部署完成后再进行飞书配置即可(此教程配合这个安装包 使用)

配置前必看要点
• 需拥有飞书个人或企业账号,企业账号需确保具备应用开发相关权限;
• 配置过程中OpenClaw需保持正常运行,确保Gateway处于在线状态,无需关闭;
• 飞书开放平台操作需按步骤完成,权限导入、事件订阅两个环节缺一不可,否则机器人无法正常响应指令;
• 所有配置步骤完成后,需重启OpenClaw,确保相关凭证生效。

第一步:登录飞书开放平台开发者后台

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

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

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

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

按页面要求填写信息,完成后点击创建即可,信息支持后续修改,创建成功后将进入应用配置主界面,填写要求如下:

  1. 应用名称:自定义设置,建议便于识别,例如OpenClaw机器人、小龙虾AI、虾壳云等;
  2. 应用描述:简要说明应用功能,字数不超过120字,例如OpenClaw AI智能体,飞书聊天下达指令实现电脑远程操控;
  3. 应用图标:自定义上传,支持JPEG/PNG/SVG/BMP格式,文件大小2MB以内,分辨率≥240*240px,可使用OpenClaw龙虾Logo,方便在飞书内快速识别。
    飞书3

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

  1. 进入应用配置页面,在左侧菜单栏找到添加应用能力选项并点击;
  2. 在展示的能力列表中选择机器人,点击右侧添加按钮;
  3. 添加成功后,左侧菜单栏将出现「机器人」相关配置项,可确认能力添加完成。
    飞书4

第五步:批量导入机器人核心权限

OpenClaw需调用飞书消息、文档、表格等多个接口,需提前开通对应权限,通过批量导入方式可一次性完成配置,避免手动添加出现遗漏,步骤如下:

  1. 在左侧菜单栏进入权限管理板块,找到批量导入/导出权限按钮并点击;
  2. 选择应用身份权限,将下方完整的JSON代码粘贴至输入框,点击格式化JSON,避免因格式错误导致配置失败;
  3. 点击下一步,确认新增权限后,点击申请开通,等待权限开通成功(个人账号免审核,权限立即生效;企业账号需由管理员审核后生效)。
        "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,是机器人响应指令的关键环节,操作如下:

  1. 在左侧菜单栏进入事件与回调,选择事件配置;
  2. 将订阅方式修改为使用长连接接收事件,点击保存(该方式无需配置公网域名,适合个人账号使用);
  3. 点击添加事件,在搜索框输入接收消息,选择接收消息v2.0(im.message.receive_v1);
  4. 勾选该事件后点击添加,完成消息订阅配置。
    飞书5
    飞书6
    飞书7
    飞书8

第七步:发布应用,使配置生效

所有应用配置完成后,需发布应用才能让权限、事件订阅等设置正式生效,步骤如下:

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

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

将飞书开放平台的应用凭证配置到OpenClaw,完成双方的对接,操作如下:

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

第九步:飞书端使用OpenClaw机器人

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

常见问题排查
若出现机器人无响应、指令执行失败的情况,可按以下方向逐一排查问题:

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

OpenClaw飞书机器人常用指令示例

配置成功后,可在飞书聊天窗口发送自然语言指令,AI将自动操控电脑完成对应操作,以下为不同场景的常用指令示例,可参考格式自定义指令:

  1. 办公类:帮我打开Excel,制作一份本周工作汇报表格,保存到D盘;
  2. 文件类:整理D盘下载文件夹,按文件类型分类创建文件夹;
  3. 浏览器类:打开浏览器,搜索2026年AI智能体发展趋势,整理成文档;
  4. 消息类:帮我给飞书备注“同事A”发送消息,内容是“工作汇报已发至你邮箱”。
    🔗再次附上 OpenClaw 最新版下载地址(怕你找不到)https://xiake.yun/api/download/package/2?promoCode=IV4B6E03CE39
    觉得本教程实用的话,麻烦点赞 + 收藏 + 关注!
posted @ 2026-04-01 10:31  17753637827  阅读(179)  评论(0)    收藏  举报