高效办公：Qwen3-VL私有化模型接入飞书的全过程-平芜编程栈

高效办公：Qwen3-VL私有化模型接入飞书的全过程

1. 写在前面：为什么你需要这篇指南

如果你正在寻找一种方法，将强大的多模态AI能力安全、高效地集成到你的日常办公流程中，那么你来对地方了。

想象一下这个场景：你的团队在飞书群里讨论一个产品设计图，有人问“这个按钮的文案是什么？”或者“这个图表的数据趋势怎么样？”。通常，你需要手动打开图片、放大查看、再打字回复。但如果有一个AI助手，能直接“看懂”图片并回答这些问题，是不是效率瞬间拉满？

这就是我们今天要完成的目标：将私有化部署的Qwen3-VL:30B多模态大模型，通过Clawdbot中间件，无缝接入飞书（Lark）平台。整个过程完全在CSDN星图AI云平台上完成，数据不出私域，安全可控。

在上一篇教程中，我们已经完成了Qwen3-VL:30B模型的私有化部署。本篇是实战的下半场，聚焦于“连接”环节——如何让这个强大的AI大脑，通过飞书这个熟悉的界面，为你的团队提供服务。

2. 准备工作：理清整体架构

在开始动手之前，我们先花一分钟理解整个系统的“骨架”。这能帮你明白每一步操作的意义，而不是机械地跟着指令走。

整个接入流程可以概括为三个核心环节：

飞书侧：创建一个企业自建应用（机器人），获取身份凭证（App ID和App Secret）。
Clawdbot侧：在星图云服务器上安装飞书插件，配置通信渠道，将飞书凭证与AI模型连接起来。
联动配置：在飞书后台订阅消息事件、开通必要权限，建立双向通信的“高速公路”。

简单来说，就是飞书提供对话界面和用户，Clawdbot负责消息转发和路由，Qwen3-VL模型提供AI智能。三者协同，构成一个完整的企业级智能助手。

你的硬件环境已经由星图平台提供，具体配置如下：

组件	规格	说明
GPU 驱动	550.90.07	已预装，支持CUDA计算
CUDA 版本	12.4	主流的AI计算框架版本
显存	48GB	足以流畅运行Qwen3-VL:30B模型
CPU	20核心	提供充足的计算资源
内存	240GB	大内存保障多任务稳定
系统盘	50GB	存放系统及运行环境
数据盘	40GB	存放模型文件及数据

环境已经就绪，我们直接从创建飞书应用开始。

3. 第一步：在飞书开放平台创建应用

3.1 创建你的企业自建应用

首先，打开浏览器，访问飞书开放平台，使用你的飞书管理员账号登录。

登录后，你会看到开发者后台的首页。点击页面中央或顶部的“创建企业自建应用”按钮。

接下来，你需要填写应用的基本信息：

应用名称：给你的机器人起个名字，比如“AI设计助手”、“智能客服小Q”。这个名字会显示在飞书的工作台和聊天界面。
应用描述：简单写一下这个机器人的用途，比如“基于Qwen3-VL的多模态办公助手”。

一个小建议：应用头像可以上传一个具有辨识度的图标，这样在飞书里更容易被团队成员找到和记住。

填写完成后，点击“确定”，你的应用就创建成功了。

3.2 开启机器人的“对话”能力

创建的应用初始只是一个空壳，我们需要为它添加“机器人”能力，让它能接收和发送消息。

在应用管理页面的左侧导航栏，找到并点击“添加应用能力”。

在能力列表中，找到“机器人”并点击添加。这样，你的应用就具备了最核心的对话功能。

3.3 获取关键身份凭证：App ID 和 App Secret

要让Clawdbot能够代表你的应用与飞书服务器通信，需要一对“钥匙”——这就是App ID和App Secret。

在左侧导航栏点击“凭证与基础信息”。
在这个页面，你可以直接看到App ID和App Secret。
立即复制并妥善保存它们，下一步配置Clawdbot时会用到。

重要提示：App Secret只显示一次，如果忘记或泄露，需要重新生成。请务必将其保存在安全的地方。

为了后续配置流程更顺畅，建议你此时在“版本管理与发布”中，先创建一个1.0.0的基础版本并提交审核（企业自建应用通常可秒过）。这能确保一些依赖版本初始化的配置项可用。

4. 第二步：配置Clawdbot连接飞书

现在，我们切换到CSDN星图AI云平台的服务器终端。这里已经部署好了Qwen3-VL模型和Clawdbot基础服务。

4.1 安装飞书通信插件

Clawdbot通过插件体系来扩展对不同平台（如飞书、QQ、钉钉）的支持。我们需要安装飞书专用的插件。

在终端中，执行以下命令：

# 安装飞书专用插件 clawdbot plugins install @m1heng-clawd/feishu

命令执行后，你会看到插件下载和安装成功的提示。这个过程通常很快。

4.2 添加飞书通信渠道

插件安装好后，我们需要创建一个“渠道”（Channel），将刚才从飞书获取的凭证配置进去。

在终端中执行：

# 添加通信渠道 clawdbot channels add

这是一个交互式命令。执行后，系统会提示你：

选择渠道类型：使用上下箭头选择feishu（飞书）。
输入配置信息：根据提示，依次粘贴你保存的App ID和App Secret。

配置完成后，Clawdbot会生成一个该渠道的唯一标识。到此，Clawdbot端的基础配置就完成了。

为了让新的配置生效，我们需要重启Clawdbot的网关服务：

# 重启网关服务 clawdbot gateway

看到服务成功启动并监听的日志，说明Clawdbot已经准备就绪，等待与飞书建立连接。

5. 第三步：在飞书后台完成联动配置

Clawdbot配置好了，现在需要告诉飞书：“请把发给机器人的消息，转发到Clawdbot这里来。” 这需要在飞书后台进行事件订阅和权限配置。

5.1 建立长连接（WebSocket）

回到飞书开放平台，在你的应用管理页面，找到左侧的“事件订阅”。

这里推荐使用“长连接（WebSocket）”模式。它的好处是，你不需要为Clawdbot所在的星图云服务器申请公网IP或配置复杂的域名映射，就能实现飞书与Clawdbot之间的实时、双向通信。

确保终端里的clawdbot gateway正在运行，然后在飞书后台点击“启用长连接”。如果一切正常，你会看到“长连接已建立”的成功提示。

如果提示“未建立长链接”：请检查终端中Clawdbot是否在运行，以及上一步输入的App ID和App Secret是否正确。

5.2 订阅消息接收事件

建立了连接通道，还需要明确告诉飞书：哪些类型的事件需要通知我们。

在“事件订阅”页面，点击“添加事件”。为了让机器人能正常对话，我们至少需要订阅以下核心事件：

im.message.receive_v1：接收用户发送给机器人的消息。

在事件列表中找到它并勾选添加。订阅事件后，飞书才会在用户给机器人发消息时，主动通知我们的Clawdbot服务。

5.3 开通必要的API权限

订阅了事件，只代表飞书会“通知”我们。要让机器人能“回复”消息，甚至获取发送者的基本信息，还需要开通相应的API调用权限。

切换到“权限管理”页面，找到并开通以下权限：

权限名称	权限Scope	为什么需要它？
获取基础用户信息	`contact:user.base:readonly`	识别是谁发送了消息，便于个性化回复或权限校验。
接收与发送消息	`im:message`(勾选全部子项)	这是机器人最核心的能力，没有它就无法回复用户。

勾选这些权限后，飞书会提示你需要发布一个新版本。这是因为权限变更是敏感操作，需要经过“发布”这个流程来生效。

前往“版本管理与发布”，基于之前的基础版本创建一个新版本（如1.0.1），提交并等待审核通过（企业自建应用通常自动通过）。

6. 第四步：全流程测试与效果验证

所有配置完成后，激动人心的时刻到了——进行端到端的测试。

6.1 在飞书中找到你的机器人

打开你的飞书（手机App或电脑客户端），进入“工作台”。你应该能在应用列表里找到你刚刚创建并发布的应用（比如“AI设计助手”）。

点击进入应用，你会看到一个类似单聊的界面。尝试给它发送一条消息，比如“你好！”或者上传一张图片并提问“描述一下这张图片”。

6.2 观察后台的联动效果

发送消息后，请同时观察两个地方：

飞书聊天窗口：你应该能在几秒内收到来自机器人的回复。如果是文字提问，它会生成文字回答；如果上传了图片，Qwen3-VL模型会发挥多模态能力，对图片进行描述、分析或回答问题。
CSDN星图AI云平台终端：这里会滚动Clawdbot的实时日志。你会看到类似这样的信息：
- [INFO] 收到来自飞书用户[xxx]的消息
- [INFO] 调用Qwen3-VL模型进行推理...
- [INFO] 模型推理完成，耗时xx秒
- [INFO] 消息已成功回复至飞书

同时，你可以在星图平台的控制台查看GPU监控，会发现发送请求时，部署Qwen3-VL模型的GPU显存占用率会有明显的动态波动，这直观地证明了你的请求确实触发了本地私有模型的推理计算。

当你在飞书收到智能回复，并且在后台看到完整的请求-推理-回复日志链时，恭喜你！你已经成功打造了一个私有化、企业级的多模态AI助手。