零基础实战：将私有化Qwen3-VL:30B接入飞书，打造专属智能助手

芦苇毛

160人浏览 · 2026-03-06 01:10:21

芦苇毛 · 2026-03-06 01:10:21 发布

零基础实战：将私有化Qwen3-VL:30B接入飞书，打造专属智能助手

1. 引言：为什么你的团队需要一个“看得懂图”的本地飞书助手？

想象一下这个场景：产品经理在飞书群里丢了一张手绘的原型草图，问“这个交互流程怎么样？”；市场同事发来一张竞品海报截图，问“他们的设计亮点是什么？”；或者，财务发来一张密密麻麻的表格截图，问“这个季度的趋势能总结一下吗？”

在过去，处理这些需求可能需要你：1）保存图片，2）打开某个AI工具上传，3）手动输入问题，4）等待回复，5）再把结果复制回飞书。流程繁琐，效率低下，更关键的是，敏感的业务图片可能因此流向外网。

现在，有一个更优雅的解决方案：将一个强大的、能“看懂”图片和文字的AI大脑——Qwen3-VL:30B，私有化部署在你完全掌控的云服务器上，并通过 Clawdbot 这个智能网关，无缝接入你每天使用的飞书。从此，在飞书里@一下你的机器人，它就能直接分析群里的图片、回答复杂问题，所有数据都在你的服务器内部闭环处理。

在上一篇教程中，我们已经在CSDN星图AI云平台上完成了Qwen3-VL:30B模型的私有化部署。本篇，我们将完成最后、也是最激动人心的一步：将这个强大的多模态模型，通过Clawdbot正式接入飞书，打造一个真正属于你或你团队的企业级智能助手。

2. 环境与准备：确认你的“作战平台”已就绪

在开始飞书配置之前，请确保你已经完成了上篇教程的所有步骤，并达到了以下状态：

模型服务在线：在CSDN星图AI平台，你的Qwen3-VL:30B实例处于“运行中”状态，并且能通过Ollama Web界面或API正常对话。
Clawdbot网关就绪：Clawdbot服务已成功启动，并且你能通过 https://你的实例地址-18789.web.gpu.csdn.net 这个链接，使用令牌 csdn 正常登录其Web控制台。
模型绑定成功：在Clawdbot的配置中，已经将模型供应商指向本地的Ollama服务（http://127.0.0.1:11434/v1），并将 qwen3-vl:30b 设为了默认的AI代理模型。

如果你对以上任何一点不确定，建议先回顾上篇内容。我们的目标是将一个已经能“思考”的AI大脑，连接到飞书这个“嘴巴”和“耳朵”。

3. 第一步：在飞书开放平台创建你的机器人应用

要让Clawdbot能和飞书对话，我们首先需要在飞书的官方平台注册一个“机器人”应用，并拿到唯一的身份凭证。

3.1 创建企业自建应用

访问并登录 飞书开放平台。
在首页或开发者后台，点击 “创建企业自建应用”。
填写应用信息：
- 应用名称：给你的机器人起个名字，例如“AI办公助手”、“多模态小Q”。这个名字会显示在飞书的工作台和聊天界面。
- 应用描述：简单描述一下应用的功能，比如“基于大模型的智能问答与图片分析助手”。
- 应用图标：上传一个醒目的图标，增加辨识度。
点击创建，你的应用就初步建成了。

3.2 为应用添加“机器人”能力

创建应用后，你会进入应用的管理页面。在左侧导航栏找到 “添加应用能力”，点击进入。

在能力列表中，找到并添加 “机器人” 能力。这相当于给你的应用装上了可以接收和发送消息的“核心器官”。

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

机器人能力添加后，我们需要获取两个最重要的信息，它们相当于机器人的“账号”和“密码”，Clawdbot需要用它来向飞书证明“我是我”。

在左侧导航栏进入 “凭证与基础信息” 页面。
在这里，你可以看到 App ID 和 App Secret。请立即将它们妥善保存（例如复制到记事本），后续配置Clawdbot时会用到。

安全提示：App Secret 非常重要，一旦泄露他人可能冒充你的应用。请勿分享到公开场合。

小技巧：为了后续配置事件订阅等高级功能，建议先在 “版本管理与发布” 中创建一个最基础的1.0.0版本并提交审核（自建应用审核很快）。这能确保一些依赖版本的功能可用。

至此，飞书端的“户口”已经注册完成。接下来，我们要告诉Clawdbot这个“户口”的信息。

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

现在，我们回到CSDN星图平台的服务器终端，让Clawdbot安装飞书插件并绑定我们刚创建的应用。

4.1 安装飞书官方插件

Clawdbot通过插件系统来扩展对不同平台（如飞书、钉钉、QQ）的支持。安装飞书插件只需一行命令：

clawdbot plugins install @m1heng-clawd/feishu

执行后，你会看到插件下载和安装成功的提示。

4.2 添加飞书通信渠道

插件安装好后，我们需要添加一个具体的“渠道”（Channel），将飞书应用和Clawdbot关联起来。

在终端运行添加渠道的命令：
```
clawdbot channels add
```
命令会进入交互式配置向导。当提示选择平台类型时，选择 feishu（飞书）。
根据提示，输入你在 3.3 步骤中保存的 App ID 和 App Secret。
继续完成其他配置项，如渠道名称（可自定义，如my-feishu-bot）等。对于不太确定的选项，通常可以直接按回车使用默认值。
配置完成后，Clawdbot会显示渠道添加成功。

关键一步：为了让新的飞书渠道配置生效，我们需要重启Clawdbot网关服务：

clawdbot gateway --restart

重启后，Clawdbot就会加载并启用飞书插件。

5. 第三步：配置飞书事件与权限，打通双向通信

现在Clawdbot已经知道了飞书应用是谁，但飞书还不知道如何把消息“推送”给Clawdbot。我们需要在飞书后台进行“事件订阅”配置，建立一条稳定的通信链路。

5.1 启用长连接（WebSocket）模式

飞书提供了两种方式将消息事件推送给我们的服务器：Webhook（需要公网IP）和 WebSocket 长连接。对于我们在云服务器上的部署，强烈推荐使用 WebSocket 长连接，它无需你拥有固定的公网IP地址，配置更简单。

在飞书开放平台，进入你的应用管理页面，找到左侧 “事件订阅”。
在事件订阅设置页面，找到“请求方式配置”，选择 “长连接（WebSocket）” 模式。
点击“保存”。如果保存时提示“未建立长链接”，请返回终端确认 clawdbot gateway 服务正在运行，并且上一步的 App ID 和 App Secret 填写正确，然后重试。

5.2 订阅机器人接收消息事件

建立了连接方式，我们还需要告诉飞书：“当有人给机器人发消息时，请通知我。”

在“事件订阅”页面，点击 “添加事件”。
在事件列表中，找到并订阅以下核心事件：
- im.message.receive_v1 （接收用户发送的消息）
添加事件后，飞书可能会要求你输入一些验证信息。请确保Clawdbot服务正在运行，通常它会自动处理这些验证。

5.3 开通必要的API权限

订阅了事件，就像申请了“监听许可证”。但我们还需要“操作许可证”，即API调用权限，机器人才能获取消息详情、回复消息。

进入 “权限管理” 页面。
在权限列表中，找到并开通以下关键权限：
- 获取基础用户信息 (contact:user.base:readonly): 用于识别是谁发送了消息。
- 接收与发送消息 (im:message): 务必勾选其下的所有子权限，这是机器人对话的核心。
至关重要：权限开通后，必须回到 “版本管理与发布” 页面，点击 “创建新版本” 并提交审核，让这些权限配置生效。

飞书对企业自建应用的审核通常是秒过的。发布成功后，你的应用就具备了完整的接收和响应消息的能力。

6. 第四步：全链路测试，见证智能诞生

所有配置已经完成，是时候进行最终的“点火测试”了。

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

打开你的飞书（手机端或PC端均可）。
进入 “工作台”，你应该能看到你刚刚创建并发布的应用（例如“AI办公助手”）。
点击进入应用，这会打开一个与机器人的单聊窗口。
尝试发送一条消息，比如：“你好，介绍一下你自己”。

6.2 在星图平台观察“大脑”的运转

当你在飞书发送消息后，立即切换到CSDN星图AI平台的控制台：

观察模型调用：通过终端命令 nvidia-smi 查看GPU状态。你会看到 Volatile GPU-Util（GPU利用率）瞬间飙升，Used Memory（显存使用量）大幅增加，这表明你私有化部署的 Qwen3-VL:30B 模型正在被调用，进行推理计算。
查看Clawdbot日志：在运行 clawdbot gateway 的终端里，你会看到实时的日志滚动，显示它收到了飞书的消息，转发给了Qwen3-VL模型，并收到了模型的回复。
回到飞书：几秒后，你的飞书聊天窗口就会收到一条来自机器人的、由Qwen3-VL:30B生成的回复。