【含最新安装包】OpenClaw 2.6.2 对接飞书机器人完整配置步骤

用户3106670290415
0 阅读4分钟

​

 OpenClaw 飞书机器人配置教程｜对接飞书，聊天下达 AI 指令

适配版本：OpenClaw v2.6.2

前置要求：已部署 OpenClaw Windows 端（Win10/Win11），未部署可先下载一键部署包安装核心效果：飞书聊天窗口直接发指令，OpenClaw 自动拆解任务、操控电脑，实现远程 AI 任务执行

OpenClaw Windows 一键部署包下载地址：

openclaw.ikidi.top/api/downloa…

免配置、免命令行、解压即用，内置全部运行依赖，部署完成后再进行飞书配置

一、配置前必看

  1. 需飞书账号（个人 / 企业均可），企业账号需具备应用开发权限
  2. OpenClaw 保持正常运行（Gateway 在线），配置过程无需关闭
  3. 权限导入、事件订阅必须完整操作，缺一不可，否则机器人无响应
  4. 配置完成后重启 OpenClaw，确保凭证生效

二、第一步：登录飞书开放平台开发者后台

  1. 打开飞书开放平台：open.feishu.cn/
  2. 扫码 / 密码登录，进入开发者后台

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

  1. 后台首页点击「创建应用」
  2. 应用类型选择「企业自建应用」
  3. 进入应用创建页面

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

  • 应用名称：自定义（如：OpenClaw 机器人）
  • 应用描述：简要说明（≤120 字）
  • 应用图标：JPEG/PNG/SVG/BMP，2MB 内，≥240*240px填写完成点击「创建」

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

  1. 应用配置页点击左侧「添加应用能力」
  2. 选择「机器人」，点击「添加」
  3. 左侧出现机器人配置项，即添加成功

六、第五步：批量导入核心权限（关键）

  1. 进入「权限管理」→「批量导入 / 导出权限」
  2. 选择「应用身份权限」，粘贴下方 JSON 代码
  3. 点击「格式化 JSON」→「下一步，确认新增权限」→「申请开通」（个人账号立即生效，企业账号需管理员审核）

完整权限 JSON 代码

plaintext

{
    "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）」并添加

八、第七步：发布应用

  1. 进入「版本管理与发布」→「创建版本」
  2. 填写版本号、更新说明，移动端 / 桌面端默认能力选择「机器人」
  3. 点击「保存」→「确认发布」（个人账号免审核，企业账号需完成应用审核）

九、第八步：获取凭证并配置到 OpenClaw

  1. 进入「凭证与基础信息」，复制 App ID、App Secret
  2. 打开 OpenClaw → 右上角「设置」→「聊天渠道」→ 选择 Feishu（飞书）
  3. 粘贴凭证，点击「保存渠道配置」，OpenClaw 自动重启

十、第九步：飞书端使用机器人

  1. 飞书搜索应用名称，进入聊天窗口
  2. 发送测试指令，正常响应即配置成功

十一、常见问题排查

  1. 应用未发布：返回飞书开放平台完成发布与审核
  2. 权限未开通：重新导入 JSON 并申请权限
  3. 凭证错误：核对 App ID、App Secret，去除空格
  4. 未重启：手动重启 OpenClaw Gateway
  5. 长连接失效：重新保存事件订阅配置
  6. OpenClaw 离线：重新运行启动程序

十二、常用指令示例

  • 办公：帮我打开 Excel，制作本周工作汇报表格，保存到 D 盘
  • 文件：整理 D 盘下载文件夹，按文件类型分类
  • 浏览器：打开浏览器，搜索 2026 年 AI 智能体发展趋势并整理成文档
  • 消息：帮我给飞书备注 “同事 A” 发消息：工作汇报已发至你邮箱

再次附上下载地址：

openclaw.ikidi.top/api/downloa…

​

avatar
文章
阅读
粉丝