实战分享：3小时完成Qwen3-VL:30B私有化部署，通过Clawdbot无缝接入飞书-开发者社区

实战分享：3小时完成Qwen3-VL:30B私有化部署，通过Clawdbot无缝接入飞书

想象一下这个场景：产品经理在飞书群里丢了一张密密麻麻的流程图，@你问：“这个流程里，用户从注册到下单，一共要经过几个关键节点？”你盯着图看了半天，手动数着箭头和方框，生怕漏掉哪个分支。或者，运营同事发来一张活动海报截图，问：“海报上写的活动截止日期是哪天？奖品是什么？”你得放大图片，一个字一个字地辨认。

这些看似简单的“看图说话”任务，在实际工作中却极其耗时，而且容易出错。如果有一个能真正“看懂”图片内容，并能用自然语言和你聊天的AI助手，直接集成在你每天用的飞书里，那该多省事？

今天，我就带你亲手搭建这样一个专属的“图文智能助手”。我们将利用CSDN星图平台，在3小时内完成Qwen3-VL:30B这个顶级多模态大模型的私有化部署，再通过Clawdbot这个轻量级网关，把它无缝接入飞书。整个过程，你不需要写复杂的推理代码，也不需要操心显卡驱动和环境配置，跟着步骤走就行。

上篇我们已经完成了模型在星图平台的部署。本篇，我们将聚焦最关键的一步：如何让这个部署好的“大脑”通过Clawdbot，听懂飞书的话，并给出聪明的回答。

1. 飞书开放平台：创建你的专属机器人应用

要让AI助手在飞书里工作，我们首先需要在飞书的“后台”为它注册一个合法的身份。这个过程就像给你的助手办理一张飞书工作证。

1.1 创建企业自建应用

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

登录后，你会进入开发者后台。在页面左上角，找到并点击“创建企业自建应用”按钮。

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

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

小提示：应用图标可以上传一个你喜欢的图片，这样在飞书里看起来更醒目、更专业。

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

1.2 为应用开启“机器人”能力

创建好的应用就像一个空壳，我们需要给它赋予“说话”和“听指令”的能力。在应用管理页面的左侧菜单栏，找到“添加应用能力”。

点击进入后，你会看到一个能力列表。找到“机器人”这个选项，点击它旁边的“添加”按钮。

添加成功后，你的应用就具备了作为聊天机器人的基础资格。

1.3 获取连接凭证：App ID 和 App Secret

现在，我们需要拿到两个关键的“钥匙”，用来在后续步骤中让Clawdbot和飞书建立安全连接。这两把钥匙就是App ID和App Secret。

在左侧菜单栏，点击进入“凭证与基础信息”页面。

在这个页面，你可以直接看到你的App ID。App Secret默认是隐藏的，点击右侧的“重置”按钮，系统会生成一个新的App Secret并显示出来。

请务必立即将这两个字符串复制并妥善保存到一个文本文件里，比如：

App ID:cli_xxxxxxxxxxxx
App Secret:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

它们非常重要，就像账号密码，后续配置Clawdbot时会用到。一旦关闭页面，App Secret将无法再次查看，只能重置。

注意：为了后续配置能顺利进行，建议你此时在左侧菜单的“版本管理与发布”中，先创建一个最基础的1.0.0版本并提交审核（自建应用审核很快）。这能确保一些配置选项被正确激活。

2. Clawdbot端：安装与配置飞书插件

拿到飞书的“钥匙”后，我们回到CSDN星图平台的服务器终端，给Clawdbot装上能和飞书对话的“耳朵”和“嘴巴”。

2.1 一键安装飞书插件

Clawdbot的强大之处在于其插件化设计。连接飞书，我们只需要安装一个专门的插件。在你的星图实例的Web Terminal中，输入以下命令：

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

命令执行后，你会看到类似下面的输出，表示插件安装成功。

2.2 添加飞书通信渠道

插件装好了，现在需要告诉Clawdbot：“用刚才拿到的飞书钥匙，去和那个叫‘Clawd图文助手’的应用建立连接。”

我们通过一个交互式命令来完成这个配置：

# 启动添加通信渠道的向导 clawdbot channels add

运行命令后，你会进入一个交互式配置界面。根据提示，你需要选择渠道类型。当出现选项时，选择feishu（飞书）。

接下来，系统会提示你输入配置信息。最关键的两步就是填入我们之前保存的“钥匙”：

当提示输入appId时，粘贴你的App ID。
当提示输入appSecret时，粘贴你的App Secret。

其他配置项通常可以直接按回车使用默认值。

配置完成后，Clawdbot会显示添加成功的提示。为了让这个新配置生效，我们需要重启一下Clawdbot的网关服务：

# 重启网关服务，加载新配置 clawdbot gateway

重启后，Clawdbot就具备了和飞书对话的基础能力。

3. 联动配置：让飞书和Clawdbot“握手”

现在两边都准备好了，但还需要最后一步“握手”协议，让飞书知道把消息发给谁，以及允许机器人接收和发送哪些类型的消息。

3.1 建立长连接（WebSocket）

回到飞书开放平台，在你创建的应用管理后台，找到左侧菜单的“事件订阅”。

在事件订阅页面，你会看到“请求地址配置”。这里我们推荐使用“长连接（WebSocket）”模式。这个模式的好处是，不需要你有一个固定的公网IP地址，Clawdbot可以主动和飞书服务器建立一个持续的、双向的通信通道。

通常，当你正确配置了App ID和App Secret，并且Clawdbot网关正在运行，飞书平台会自动检测并显示“长连接已建立”。如果显示“未建立”，请检查：

终端里clawdbot gateway命令是否在运行。
上一步输入的App ID和App Secret是否正确。

3.2 订阅机器人所需的事件

建立了连接，我们还需要告诉飞书：“当用户给机器人发消息时，请通知我们。”这就是事件订阅。

在“事件订阅”页面，点击“添加事件”按钮。在事件列表中，找到与消息相关的核心事件，例如：

im.message.receive_v1（接收用户发送的消息）

勾选你需要的事件，然后保存。这相当于给机器人开通了“收听”频道。

3.3 开通必要的API权限

机器人能“听到”消息了，但它要“回复”消息，以及知道“是谁发的消息”，还需要相应的权限。

点击左侧菜单的“权限管理”。在这里，你需要为机器人申请开通以下关键权限：

权限名称	权限Scope	说明
获取用户基本信息	`contact:user.base:readonly`	让机器人能识别出发消息的用户是谁。
接收与发送消息	`im:message`(以及其下的子权限如`im:message.p2p_msg:readonly`,`im:message:send_as_bot`等)	这是核心功能，允许机器人读取用户发给它的消息，并能够回复消息。

根据你的需求（例如，是希望机器人在群聊还是单聊中工作），勾选对应的权限范围。开通权限后，务必记得回到“版本管理与发布”页面，创建一个新版本（比如1.0.1）并提交审核发布，这样权限才会真正生效。

4. 最终验证：开启你的飞书智能对话

所有配置都完成了，现在就是见证奇迹的时刻。

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

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

点击进入该应用，你会看到一个简单的聊天界面。试着给它发送一条消息，比如“你好！”。

4.2 观察后台联动效果

当你发送消息后，可以立即切换到CSDN星图平台的控制台：

观察模型调用：如果你在终端运行了监控GPU的命令（如watch nvidia-smi），你会看到GPU的利用率瞬间上升，显存占用增加。这证明你的消息成功触发了本地的Qwen3-VL:30B大模型进行推理。
查看Clawdbot日志：在运行clawdbot gateway的终端窗口，你会看到实时的日志滚动，显示它收到了来自飞书的消息，调用了模型，并返回了结果。

几秒钟后，你的飞书聊天界面就会收到来自“Clawd图文助手”的回复。

恭喜！至此，你已经成功打造了一个部署在私有环境、通过飞书便捷访问的多模态AI助手。你可以尝试发送图片给它，体验Qwen3-VL:30B强大的图文理解和对话能力。