当前位置：首页 > news >正文

手把手教你用Clawdbot将Qwen3-VL私有化部署到飞书平台

news 2026/5/12 10:12:41

手把手教你用Clawdbot将Qwen3-VL私有化部署到飞书平台

你是否已经成功在CSDN星图AI云平台上部署了强大的Qwen3-VL多模态大模型，却还在为如何将它无缝融入日常办公流程而发愁？想象一下，如果能让这个“AI大脑”直接接入团队每天都在用的飞书，在群里就能直接对话、分析图片、处理文档，那该多方便。

这正是我们今天要解决的问题。在上一篇文章中，我们已经完成了Qwen3-VL:30B模型的私有化部署，拥有了一个安全、可控的算力底座。现在，我们将通过一个名为Clawdbot的智能体网关，把这个底座正式接入飞书平台，打造一个属于你自己的、企业级的AI助手。

这篇文章将是你实现这个目标的完整路线图。无论你是技术负责人还是开发者，我都会用最直白的语言，带你一步步完成从飞书应用创建、Clawdbot配置到最终联调测试的全过程。学完之后，你就能拥有一个在飞书里随时待命、能看能说、还完全私有的智能同事。

1. 准备工作：理清思路与获取凭证

在开始动手之前，我们先花一分钟理清整个流程的逻辑。这就像搭积木，我们需要三块关键的“积木”：

算力底座：我们已经有了，就是在星图云上私有化部署好的Qwen3-VL模型。
通信网关：这就是Clawdbot，它负责接收飞书的消息，转发给Qwen3-VL处理，再把结果传回飞书。
前端入口：就是我们在飞书上创建的一个“自建应用”，它是用户和AI助手对话的界面。

整个流程就是：用户在飞书应用里发消息 -> 飞书平台将消息推送给Clawdbot -> Clawdbot调用本地的Qwen3-VL模型 -> 模型生成回复 -> Clawdbot将回复发回飞书 -> 用户收到回复。

要实现这个流程，我们需要从飞书开放平台拿到两个关键的“钥匙”：App ID和App Secret。它们相当于Clawdbot接入飞书平台的账号和密码。

1.1 登录飞书开放平台

首先，用你的飞书管理员账号登录飞书开放平台。如果你没有管理员权限，需要先联系公司的飞书管理员。

登录后，你会看到开发者后台的首页。我们的所有操作都将在这里完成。

1.2 创建企业自建应用

在后台首页，找到并点击“创建企业自建应用”按钮。

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

应用名称：给你的AI助手起个名字，比如“Clawd智能助手”。这个名字会显示在飞书的工作台和聊天界面。
应用描述：简单写一下这个应用是做什么的，比如“基于Qwen3-VL的多模态AI办公助手”。

这里有个小建议：可以上传一个有个性的应用图标，这样在飞书里更容易被找到和识别。

填写完成后，点击创建，你的应用就初步建好了。

1.3 开启机器人能力并获取凭证

应用创建后，我们需要给它添加“机器人”能力，这样它才能接收和发送消息。

在应用管理页面的左侧菜单栏，找到“添加应用能力”。
在能力列表中，找到并点击添加“机器人”能力。

添加能力后，为了进行后续配置，我们需要先创建一个初始版本。点击左侧的“版本管理与发布”，然后创建一个1.0.0的基础版本并提交审核（企业内部应用审核很快）。

现在，最关键的一步来了：获取凭证。转到“凭证与基础信息”页面。在这里，你会看到系统自动生成的App ID和App Secret。

请立即将这两串字符复制并妥善保存，我们下一步配置Clawdbot时会立刻用到它们。它们是你的应用在飞书平台的唯一身份标识，非常重要。

好了，飞书这边的“钥匙”我们已经拿到了。接下来，我们要去星图云的服务器上，配置Clawdbot这把“锁”。

2. 配置桥梁：在Clawdbot中接入飞书

现在，我们回到CSDN星图AI云平台，打开你部署了Qwen3-VL和Clawdbot的云服务器终端。接下来的操作都在命令行中进行。

重要提示：本篇教程所使用的镜像已经预置了Clawdbot及飞书插件。因此，本章节提到的安装步骤你可以直接跳过，镜像已经配置好，开箱即用。这里列出步骤是为了让你了解完整的原理。

2.1 （原理了解）安装飞书插件

Clawdbot通过插件系统来扩展对不同平台（如飞书、QQ、微信）的支持。要接入飞书，需要安装对应的飞书插件。

安装命令非常简单：

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

执行后，Clawdbot会自动从插件仓库下载并安装飞书连接器。

2.2 添加飞书通信渠道

插件安装好后，我们需要告诉Clawdbot如何连接到我们刚才在飞书创建的那个应用。这通过添加一个“渠道”(Channel)配置来实现。

在终端中输入以下命令：

# 添加通信渠道 clawdbot channels add

命令执行后，会进入一个交互式配置界面。你需要根据提示输入信息：

选择渠道类型：从列表中选择feishu（飞书）。
输入渠道名称：给你这个飞书连接起个名字，比如my_feishu_bot。
输入App ID：粘贴你从飞书后台保存的App ID。
输入App Secret：粘贴你从飞书后台保存的App Secret。

配置过程大致如下图所示：

配置完成后，Clawdbot就记住了如何联系你的飞书应用。为了让这个配置生效，我们需要重启Clawdbot的核心网关服务。

# 重启网关服务 clawdbot gateway

重启后，Clawdbot会加载新的飞书配置，并尝试与飞书平台建立连接。到此为止，Clawdbot端的配置就完成了。接下来，我们需要回到飞书后台，完成最后的“握手”设置。

3. 完成握手：在飞书后台配置事件与权限

Clawdbot已经准备就绪，现在需要飞书平台“点头同意”建立连接，并授予机器人必要的权限。

3.1 配置事件订阅（建立长连接）

在飞书开放平台，进入你创建的应用，找到左侧的“事件订阅”页面。

这里有一个关键选择：连接方式。我们强烈推荐选择“长连接（WebSocket）”模式。它的好处是，不需要你有一台具备公网固定IP的服务器，Clawdbot可以主动与飞书建立稳定、双向的通信通道，非常适合云服务器环境。

在“长连接”配置区域，你应该能看到一个“长连接状态”的提示。如果Clawdbot网关正在运行且密钥（App ID/Secret）填写正确，这里通常会显示“已建立”或类似的成功状态。

如果显示“未建立长链接”，请检查：

终端里的clawdbot gateway服务是否在正常运行。
你在Clawdbot中配置的App ID和App Secret是否与飞书后台的完全一致。

3.2 订阅机器人所需事件

光有连接还不够，我们需要明确告诉飞书：当用户对机器人做某些操作时（比如发消息），请通知我们。

点击事件订阅页面上的“添加事件”按钮。我们需要订阅最核心的一个事件：

接收消息：im.message.receive_v1

这个事件意味着，当用户在飞书中向你的机器人应用发送消息时，飞书会把这个消息事件通过长连接推送给Clawdbot。

3.3 开通必要的API权限

订阅了事件，相当于飞书答应“有事会通知你”。但机器人要回复消息，还需要获得相应的“操作许可”。

转到“权限管理”页面。在这里，你需要搜索并开通以下两个关键权限：

权限名称	权限Scope	说明
获取基础用户信息	`contact:user.base:readonly`	让机器人能知道是谁发了消息，以便个性化回复。
接收与发送消息	`im:message`(需勾选其下的子权限，如`im:message.p2p_msg:readonly`等)	这是机器人工作的核心，没有它就无法收发消息。

找到这些权限后，勾选并点击“申请开通”。对于企业自建应用，开通通常是即刻生效的。

最后且关键的一步：所有配置修改后，都必须发布一个新版本才能生效。再次进入“版本管理与发布”页面，基于刚才的修改创建一个新版本（例如1.0.1），提交并等待发布完成。

至此，飞书平台和Clawdbot之间的所有配置和“握手”流程都已全部完成。激动人心的测试时刻到了！

4. 最终验证：启动你的飞书AI助手

现在，让我们从端到端完整地体验一下这个刚刚诞生的AI助手。

4.1 在飞书中找到并对话

打开你的飞书（手机端或电脑端均可）。

进入“工作台”。
在工作台的应用列表中，找到你刚刚创建并发布的应用（例如“Clawd智能助手”）。如果没找到，可以尝试搜索应用名称。
点击进入应用。你会看到一个简单的聊天界面。
尝试发送一条消息！比如：“你好，请介绍一下你自己。”

4.2 观察后台联动效果

当你发送消息后，两个地方会发生有趣的变化：

飞书聊天窗口：稍等几秒，你应该会收到一条来自机器人的回复。这条回复的内容，正是由你私有化部署在星图云上的Qwen3-VL:30B大模型实时生成的！
星图云服务器终端：打开你运行clawdbot gateway的终端窗口。你会看到实时的日志在滚动，清晰地显示了消息接收、模型调用、回复发送的完整流程。同时，你也可以在星图AI平台的控制台看到，Qwen3-VL模型的GPU显存占用出现了波动，这证明模型确实被成功调用了。

恭喜你！看到飞书里传来的AI回复，意味着你已经成功搭建了一条从飞书前端到私有化大模型底座的完整链路。

你可以进一步尝试它的多模态能力，比如向它发送一张图片并提问：“请描述一下这张图片里的内容。” 体验Qwen3-VL强大的图文理解能力是如何通过飞书这个便捷的入口为你服务的。