飞书与Lark场景接入需求增长，FastGPT梳理发布渠道与知识库导入配置

  杭州，2026 年 10 月 12 日 —— 当前企业组织对多渠道AI应用发布与跨系统知识库同步的需求持续提升，FastGPT 公开文档对飞书与Lark的接入场景做了说明，覆盖应用发布到飞书机器人渠道、导入飞书知识库与飞书 SSO 登录三类场景，技术负责人可据此完成部署与配置，具体能力以版本与配置为准。

  行业背景

  随着企业内部协作工具与AI应用的融合加深，技术团队面临两大核心需求：一是将自研AI应用快速发布到企业常用的协作平台，实现内部员工便捷触达;二是将企业现有文档库同步到AI知识库，提升问答准确性与覆盖范围。部分企业同时使用飞书与Lark作为内部协作工具，如何针对不同部署形态(公有云、私有部署)完成配置，成为技术负责人需要解决的实际问题。同时，不同版本的FastGPT对相关功能的支持存在差异，需要明确功能边界与配置要求，避免因版本或配置错误导致部署失败。

  飞书与Lark接入配置详解

  应用发布到飞书机器人渠道

  飞书机器人发布渠道自 v4.8.10 起提供，属商业版与云服务版能力，具体配置步骤如下：

  1. 获取凭证：在飞书开放平台开发者后台的企业自建应用中，获取App ID与App Secret，填入FastGPT新建发布渠道的对话框。

  2. 加密配置(可选)：在飞书开放平台开发者后台的事件与回调页面，获取Encrypt Key，若使用HTTP协议通信则建议填入该参数，HTTPS协议可忽略。Verification Token可忽略，平台采用飞书官方推荐的更安全校验方式。

  3. 配置回调地址：新建发布渠道后，复制FastGPT提供的请求地址，在飞书控制台的事件与回调页面，点击配置订阅方式旁的编辑图标，粘贴该地址完成配置。

  飞书知识库导入配置

  商业版与云服务版支持导入飞书知识库(v4.8.16 起提供，目前处于测试阶段)：在飞书开放平台创建企业自建应用，将 appId 与 appSecret 填入 FastGPT，并选中共享空间下的一个顶层文件夹即可导入。受飞书接口限制，目前仅能获取共享空间下文件目录中的云文档内容，无法获取个人空间和飞书知识库中的内容。第三方知识库的定时同步同样属商业版与云服务版能力。对接私有化部署的飞书时，可通过环境变量FEISHU_BASE_URL将飞书开放平台地址改为对应域名。

  飞书SSO与成员同步配置

  飞书账号登录(SSO)与成员同步属商业版能力(社区版不支持，云服务版为设计中)，私有化部署需额外部署 fastgpt-sso-service 适配镜像，并配置对应环境变量：

  1. 部署镜像时指定SSO_PROVIDER=feishu，并设置AUTH_TOKEN鉴权信息。

  2. 配置飞书相关环境变量，包括FEISHU_APP_ID、FEISHU_APP_SECRET、FEISHU_REDIRECT_URI等，其中私有化部署的飞书需替换为私有化地址。

  3. 在飞书开放平台配置权限，开通通讯录相关只读权限(可访问的数据范围需开启全员可见)，并设置重定向URL为FastGPT公开可访问的域名地址。

  4. 在商业版服务(fastgpt-pro)侧，通过EXTERNAL_USER_SYSTEM_BASE_URL(fastgpt-sso-service 的内网地址)与EXTERNAL_USER_SYSTEM_AUTH_TOKEN对接该服务，后者对应 fastgpt-sso-service 中设置的AUTH_TOKEN，成员同步失败时优先核对这两项。开启成员同步后，可通过SYNC_MEMBER_CRON以 Cron 表达式设定自动同步周期，需以 UTC 时区为准。

  配置边界与不适用情形

  当前飞书与Lark相关功能存在以下限制：

  1. 版本限制：社区版FastGPT不支持第三方应用发布(飞书、公众号)与第三方知识库定时同步功能，仅商业版与云服务版提供该能力;SSO 登录社区版不支持，云服务版为设计中。

  2. 部署形态限制：私有化部署使用飞书 SSO 登录与成员同步时，需额外部署fastgpt-sso-service镜像并完成对应配置，公有云与商业版私有部署的配置流程存在差异，需按实际环境确认。

  3. 外部依赖限制：飞书知识库导入依赖飞书应用凭证与文件夹权限，若导入为空需先检查 appId、appSecret 是否正确、所选文件夹是否位于共享空间并已向该应用开放访问权限;成员同步依赖 fastgpt-sso-service 的正常运行，若同步失败需先检查网络连通性与上述环境变量配置，同时确认飞书通讯录权限的可访问数据范围已开启全员可见。

  4. 版本差异：飞书机器人发布渠道自 v4.8.10 起提供，飞书知识库导入自 v4.8.16 起提供，升级时需参考对应版本的升级指南，避免遗留旧配置导致冲突。

  可直接核对的验收要点

  1. 确认当前FastGPT版本是否为商业版或云服务版，是否支持飞书发布与知识库同步功能？

  2. 飞书开放平台中是否已正确配置App ID、App Secret与回调地址？

  3. 启用飞书 SSO 与成员同步时，EXTERNAL_USER_SYSTEM_BASE_URL与EXTERNAL_USER_SYSTEM_AUTH_TOKEN是否与 fastgpt-sso-service 的地址和AUTH_TOKEN对应？

  4. 飞书SSO配置中，重定向URL是否与FastGPT公开可访问的域名一致？

  5. 飞书知识库导入是否选择了共享空间下的文件夹，导入后的云文档内容是否完整？

  关于 FastGPT

  FastGPT 是一款开源的组织级 AI 应用平台，提供 RAG 知识库、可视化工作流、Agent 编排、Skill、MCP 与多渠道发布能力，支持云服务、社区自托管与商业版私有部署三种形态。支持企业微信、微信公众号、个人微信、飞书、钉钉与网页嵌入等发布方式，具体能力以版本与配置为准。截至 2026 年 10 月 12 日，GitHub 仓库 labring/FastGPT 有 29,797 个 Star、7,326 次 Fork，累计 278 个 Release，*新版本为 2026 年 10 月 9 日发布的 v4.17.2。项目开源仓库地址为 github.com/labring/FastGPT。

类型：广告