飞书接入指南

最近更新：2026年3月20日

本指南将帮助您在飞书中配置 QClaw ，让您可以通过飞书与 QClaw 完成互联。

一、前置条件

在开始之前，请确保您已满足以下条件：

已在电脑上安装 QClaw
拥有一个飞书企业账号（需要有创建应用的权限）

二、流程指引

整体流程

在飞书中使用创建企业自建应用 -> 获取App ID 和 App Secret并填入QClaw

详细步骤

1、在飞书开放平台中获取App ID 和 App Secret

（1）登录飞书账号（建议登录个人账号，如果是企业账号，后续步骤需要企业管理员审核），登录成功后，点击【创建企业自建应用】

注意：不要用Lark登录

（2）填写应用信息后，提交「创建」，应用创建成功后，会自动跳转到应用详情页面

（3）在应用详情页的「添加应用能力」区域，找到「机器人」卡片，点击「添加」。

（4）在应用详情页左侧菜单中，点击「权限管理」，然后选择「批量导入 / 导出权限」。

（5）在弹出的窗口中：清空输入框中的所有内容，将下方的权限列表完整复制并粘贴进去，点击「下一步，确定新增权限」及「申请开通」。

{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",
      "docx:document:readonly",
      "im:chat:read",
      "im:chat:update",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message.pins:read",
      "im:message.pins:write_only",
      "im:message.reactions:read",
      "im:message.reactions:write_only",
      "im:message:readonly",
      "im:message:recall",
      "im:message:send_as_bot",
      "im:message:send_multi_users",
      "im:message:send_sys_msg",
      "im:message:update",
      "im:resource",
      "application:application:self_manage",
      "cardkit:card:write",
      "cardkit:card:read"
    ],
    "user": [
      "contact:user.employee_id:readonly",
      "offline_access",
      "base:app:copy",
      "base:field:create",
      "base:field:delete",
      "base:field:read",
      "base:field:update",
      "base:record:create",
      "base:record:delete",
      "base:record:retrieve",
      "base:record:update",
      "base:table:create",
      "base:table:delete",
      "base:table:read",
      "base:table:update",
      "base:view:read",
      "base:view:write_only",
      "base:app:create",
      "base:app:update",
      "base:app:read",
      "board:whiteboard:node:create",
      "board:whiteboard:node:read",
      "calendar:calendar:read",
      "calendar:calendar.event:create",
      "calendar:calendar.event:delete",
      "calendar:calendar.event:read",
      "calendar:calendar.event:reply",
      "calendar:calendar.event:update",
      "calendar:calendar.free_busy:read",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "contact:user:search",
      "docs:document.comment:create",
      "docs:document.comment:read",
      "docs:document.comment:update",
      "docs:document.media:download",
      "docs:document:copy",
      "docx:document:create",
      "docx:document:readonly",
      "docx:document:write_only",
      "drive:drive.metadata:readonly",
      "drive:file:download",
      "drive:file:upload",
      "im:chat.members:read",
      "im:chat:read",
      "im:message",
      "im:message.group_msg:get_as_user",
      "im:message.p2p_msg:get_as_user",
      "im:message:readonly",
      "search:docs:read",
      "search:message",
      "space:document:delete",
      "space:document:move",
      "space:document:retrieve",
      "task:comment:read",
      "task:comment:write",
      "task:task:read",
      "task:task:write",
      "task:task:writeonly",
      "task:tasklist:read",
      "task:tasklist:write",
      "wiki:node:copy",
      "wiki:node:create",
      "wiki:node:move",
      "wiki:node:read",
      "wiki:node:retrieve",
      "wiki:space:read",
      "wiki:space:retrieve",
      "wiki:space:write_only"
    ]
  }
}