零代码实战：用Clawdbot在星图平台快速部署Qwen3-VL:30B并接入飞书（保姆级教程）

零代码实战：用Clawdbot在星图平台快速部署Qwen3-VL:30B并接入飞书（保姆级教程）

想象一下这个场景：你在飞书群里发了一张产品设计图，@了一下你的AI助手，它不仅能准确识别图中的元素，还能分析设计风格、给出优化建议，甚至帮你生成一段产品介绍文案。整个过程，你不需要打开任何AI网站，不需要复制粘贴图片，就在你最熟悉的办公软件里，完成了最智能的多模态交互。

这听起来像是未来办公的想象？不，这就是我们今天要实现的现实。

在上一篇教程中，我们已经成功在CSDN星图AI云平台上，一键部署了目前中文能力最强的开源多模态大模型——Qwen3-VL:30B。它拥有300亿参数，能真正理解图片内容，进行深度的图文对话。现在，我们要通过Clawdbot这个轻量级智能体网关，把这个强大的“大脑”接入飞书，让它成为你团队里随时待命的智能同事。

整个流程，你不需要写一行代码，不需要配置复杂的网络环境，甚至不需要懂什么是API接口。跟着这篇保姆级教程，从飞书应用创建到最终对话测试，我们一步步来。

1. 准备工作：理清思路，明确目标

在开始动手之前，我们先花一分钟理清整个流程的思路，这样你才知道每一步在做什么，为什么要这么做。

1.1 整体架构：三部分如何协同工作

整个系统由三个核心部分组成，它们的关系就像一场精心编排的演出：

1. Qwen3-VL:30B（演员）：在星图平台的GPU实例上运行，负责“思考”和“回答”。它能看懂图片，理解文字，进行复杂的推理。这是我们系统的“大脑”。

2. Clawdbot（导演）：运行在同一台服务器上，负责“调度”和“翻译”。它接收来自飞书的消息，转发给Qwen3-VL模型，再把模型的回答翻译成飞书能理解的格式发回去。这是我们系统的“中枢神经”。

3. 飞书机器人（前台）：在飞书开放平台创建的应用，负责“接待”和“展示”。用户通过它发送消息和图片，它也把AI的回答呈现给用户。这是我们系统的“交互界面”。

它们的工作流程很简单：

• 你在飞书里@机器人并发送消息（文字或图片）
• 飞书把消息推送给Clawdbot
• Clawdbot把消息转发给Qwen3-VL模型
• 模型思考后给出回答
• Clawdbot把回答发回飞书
• 你在飞书里看到AI的回复

1.2 你需要准备什么

在开始之前，确保你已经完成了以下准备：

• 星图实例正常运行：按照上篇教程，你的Qwen3-VL:30B实例应该已经在星图平台正常运行，并且可以通过Ollama Web界面进行图文对话测试。
• 飞书企业账号：你需要有一个飞书企业账号（个人版也可以，但企业版功能更完整）。如果没有，可以去飞书官网免费注册。
• 基本的命令行操作能力：只需要会复制粘贴命令、按回车键就行，不需要懂Linux。
• 大约30分钟时间：整个配置过程如果顺利，30分钟内就能完成。

如果你还没有部署Qwen3-VL模型，建议先完成上篇教程。本篇的所有操作都基于模型已经正常运行的假设。

2. 飞书端配置：创建你的专属AI助手

现在我们从零开始，在飞书开放平台创建一个企业自建应用，这将成为你的AI助手在飞书里的“身份”。

2.1 第一步：创建应用，给AI助手一个“工牌”

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

登录后你会看到开发者后台的首页，这里是你管理所有应用的地方。点击页面上的“创建企业自建应用”按钮。

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

• 应用名称：给你的AI助手起个名字，比如“Clawd智能助手”、“多模态AI同事”、“图文分析小助手”等。这个名字会显示在飞书的工作台和聊天界面，建议起一个容易识别的名字。
• 应用描述：简单描述这个应用是做什么的，比如“基于Qwen3-VL多模态模型的智能办公助手，支持图文对话和分析”。
• 应用头像：上传一个图标，建议尺寸至少72x72像素。这个图标会成为AI助手在飞书里的头像。

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

小提示：应用名称和头像很重要，因为这就是你的AI助手在飞书里的“形象”。团队成员会通过这个名称和头像来识别和使用它，建议选择一个专业又亲切的设计。

2.2 第二步：开启机器人能力，让应用能“说话”

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

在能力列表中，找到“机器人”这个选项，点击右侧的“添加”按钮。这个操作相当于给你的应用安装了一个“嘴巴”和“耳朵”，让它能够接收用户的消息，也能发送回复。

添加成功后，你会看到机器人能力已经启用。这时候你的应用已经具备了基本的对话能力，但还需要一些配置才能正常工作。

2.3 第三步：获取关键凭证，这是应用的“身份证”

要让Clawdbot能够和飞书应用通信，我们需要两个关键的凭证：App ID和App Secret。你可以把它们理解为应用的“用户名”和“密码”。

在应用管理页面的左侧菜单中，找到“凭证与基础信息”，点击进入。

在这个页面，你会看到两个重要的信息：

• App ID：一串由数字和字母组成的标识符，比如“cli_xxxxxx”
• App Secret：一串更长的密钥，需要点击“显示”才能看到

请立即把这两个信息复制保存到记事本或文本文件中，我们稍后在配置Clawdbot时会用到。特别是App Secret，一旦关闭页面就看不到了，如果忘记只能重新生成。

重要提醒：App Secret就像密码一样重要，不要泄露给他人。如果怀疑泄露，可以在飞书后台重新生成新的Secret。

2.4 第四步：创建版本，让配置“生效”

在飞书开放平台，很多配置需要发布版本后才能生效。虽然我们现在还没有完全配置好，但可以先创建一个基础版本。

在左侧菜单中找到“版本管理与发布”，点击进入后选择“创建版本”。

填写版本信息：

• 版本号：填写“1.0.0”或“0.1.0”都可以
• 更新说明：简单写一下，比如“初始版本，实现基础机器人功能”
• 可用性：选择“全公司”或“部分成员”，根据你的测试需要决定

点击“保存”，版本就创建好了。注意，现在先不要点击“申请发布”，等我们完成所有配置后再发布。

到这里，飞书端的初步配置就完成了。我们创建了一个应用，开启了机器人能力，拿到了通信凭证。接下来，我们要回到星图平台，配置Clawdbot来连接这个应用。

3. Clawdbot配置：连接飞书与AI模型

现在回到星图平台的终端界面。如果你已经按照上篇教程部署了Qwen3-VL模型，那么Clawdbot应该已经安装好了。如果没有，请先参考上篇教程完成Clawdbot的安装。

3.1 安装飞书插件，让Clawdbot“会说飞书语言”

Clawdbot本身支持多种通信渠道，比如微信、QQ、Telegram等。要让它能和飞书对话，我们需要安装飞书专用的插件。

打开星图平台的Web终端（点击实例右侧的“SSH连接”按钮），输入以下命令：

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

这个命令会从npm仓库下载飞书插件并自动安装。安装过程大概需要10-20秒，取决于网络速度。你会看到类似下面的输出：

正在安装插件 @m1heng-clawd/feishu... 下载中... 100% 插件安装成功！

安装完成后，Clawdbot就具备了和飞书通信的能力。你可以把它想象成给Clawdbot安装了一个“飞书翻译器”，现在它能听懂飞书的消息格式，也能用飞书能理解的格式回复了。

3.2 添加飞书通信渠道，建立“专用电话线”

插件安装好了，但Clawdbot还不知道要连接哪个飞书应用。我们需要告诉它：“嘿，你要连接的是我们刚才创建的那个应用，这是它的身份证（App ID和App Secret）。”

在终端中输入以下命令，进入交互式配置模式：

# 添加通信渠道 clawdbot channels add

系统会提示你选择要添加的渠道类型。用方向键选择“feishu”（飞书），然后按回车。

接下来，系统会依次询问几个配置项：

1. Channel name：给这个渠道起个名字，比如“my-feishu-bot”，直接按回车使用默认值也可以。
2. App ID：粘贴你刚才从飞书后台复制的App ID。
3. App Secret：粘贴你刚才从飞书后台复制的App Secret。
4. Encryption Key和Verification Token：这两个暂时不需要，直接按回车跳过。

配置完成后，你会看到类似下面的确认信息：

飞书渠道配置成功！ 渠道名称：my-feishu-bot 状态：已启用

这意味着Clawdbot已经记住了你的飞书应用信息，随时准备建立连接。

3.3 重启网关服务，让配置“加载生效”

配置完成后，我们需要重启Clawdbot的网关服务，让新的飞书插件和渠道配置生效。

在终端中输入：

# 重启网关服务 clawdbot gateway --restart

或者如果你之前已经运行了Clawdbot，可以先按Ctrl+C停止，然后重新启动：

# 停止当前服务（如果正在运行） Ctrl+C # 重新启动 clawdbot gateway

重启后，你会看到Clawdbot正常启动的日志，其中应该包含飞书插件加载成功的信息。

现在Clawdbot端的工作就完成了。它已经装备了飞书插件，配置了你的飞书应用信息，正在等待飞书那边的“握手”信号。

4. 飞书深度配置：建立双向通信通道

Clawdbot准备好了，现在我们需要回到飞书后台，完成最后的联动配置。这一步就像是给两个设备“配对”，让它们能够互相找到对方并开始通信。

4.1 配置事件订阅，让飞书“知道该通知谁”

在飞书应用管理页面，找到左侧菜单的“事件订阅”，点击进入。

这里有两种通信方式可选：

• HTTP回调：需要公网IP，配置相对复杂
• 长连接（WebSocket）：无需公网IP，配置简单，推荐选择

我们选择“长连接（WebSocket）”模式，然后点击“保存”。

重要提示：如果点击保存时提示“未建立长链接”，不要慌。这通常是因为Clawdbot的网关服务没有正常运行，或者飞书插件没有正确加载。请回到终端检查Clawdbot是否正在运行，日志是否有错误信息。

4.2 添加消息事件，让机器人“能听会说”

保存长连接配置后，我们需要告诉飞书：“当用户给机器人发消息时，请通知我们的Clawdbot。”

点击“添加事件”按钮，在事件列表中找到以下几个关键事件：

1. im.message.receive_v1（接收消息事件）：当用户给机器人发送消息时触发
2. im.message.message_read_v1（消息已读事件）：当用户阅读了机器人的消息时触发
3. im.message.reaction.created_v1（添加表情回复事件）：当用户给消息添加表情回复时触发

至少需要勾选第一个“接收消息事件”，这是机器人工作的基础。其他事件可以根据需要选择。

添加完成后，事件列表应该显示这些事件已经订阅。

4.3 开通必要权限，让机器人“有权访问”

事件订阅只是告诉飞书“什么时候通知”，我们还需要给机器人开通相应的权限，让它“能做什么”。

在左侧菜单中找到“权限管理”，点击进入。

这里有很多权限选项，我们需要开通两个核心权限：

1. 获取用户基础信息（contact:user.base:readonly）

   • 作用：让机器人知道是谁在跟它说话
   • 为什么需要：没有这个权限，机器人收到消息但不知道是谁发的，无法个性化回复

2. 接收与发送消息（im:message下的所有子权限）

   • 作用：让机器人能接收消息和回复消息
   • 为什么需要：这是机器人最核心的功能，没有这个权限它就是个“哑巴”

找到这两个权限，勾选前面的复选框，然后点击页面底部的“批量开通”按钮。

权限开通后，飞书会提示需要重新发布版本才能生效。

4.4 发布新版本，让所有配置“正式生效”

回到“版本管理与发布”页面，你会看到我们之前创建的1.0.0版本。由于我们修改了权限配置，需要创建一个新版本。

点击“创建版本”，版本号可以填“1.0.1”，更新说明写“开通消息权限，完善机器人功能”，然后点击“保存”。

保存后，在版本列表中找到这个新版本，点击右侧的“申请发布”。

系统会提示你选择发布范围。如果是测试，可以选择“仅管理员可用”；如果希望全公司都能用，选择“全公司”。选择后点击“确认发布”。

发布申请提交后，需要飞书管理员审核（如果是企业自建应用，通常自己就是管理员）。审核通过后，版本状态会变为“已发布”。

至此，飞书端的所有配置都完成了。你的应用现在：

• 有了唯一的身份标识（App ID和App Secret）
• 开启了机器人能力
• 订阅了消息事件
• 开通了必要的权限
• 发布了新版本

万事俱备，只差最后的测试验证了。

5. 端到端测试：见证AI助手在飞书里“活过来”

这是最激动人心的时刻——我们将进行完整的端到端测试，从飞书发送消息，经过Clawdbot转发给Qwen3-VL模型，再把AI的回答显示在飞书中。

5.1 在飞书中找到你的AI助手

打开飞书（手机App或电脑客户端都可以），进入工作台。在工作台的应用列表中，找到你刚才创建的应用（比如“Clawd智能助手”）。

点击进入应用，你会看到一个简单的聊天界面。这就是你的AI助手的“房间”，你可以在这里和它对话。

5.2 发送第一条测试消息

在输入框中发送一条简单的文字消息，比如：

你好，我是测试用户，请介绍一下你自己。

点击发送后，观察几秒钟。如果一切配置正确，你应该会收到AI助手的回复。

如果收到了回复，恭喜你！这意味着：

• 飞书成功将消息发送给了Clawdbot
• Clawdbot成功将消息转发给了Qwen3-VL模型
• 模型成功处理并生成了回复
• Clawdbot成功将回复发回飞书
• 飞书成功显示了回复

整个链路完全打通了！

5.3 进行图文对话测试

现在测试核心功能——图文对话。点击输入框旁边的“+”号或图片图标，选择一张图片上传。可以是一张产品图、一个截图、或者任何你想让AI分析的图片。

上传图片后，输入一个问题，比如：

请描述这张图片的主要内容，并分析它的设计风格。

点击发送。这次等待时间可能会稍长一些（5-10秒），因为Qwen3-VL模型需要处理图片信息。

如果AI能够准确描述图片内容并给出分析，说明多模态功能完全正常！

5.4 观察后台运行状态

在测试的同时，你可以打开星图平台的控制台，观察后台的运行状态：

1. GPU使用情况：在终端运行nvidia-smi命令，你会看到当AI处理消息时，GPU显存使用率明显上升，这说明模型确实在运行，不是简单的文本回复。

2. Clawdbot日志：在运行Clawdbot的终端中，你会看到实时的日志输出，包括收到消息、转发消息、收到回复等完整流程。

3. 模型响应时间：注意观察从发送消息到收到回复的总时间。首次响应可能稍慢（需要加载模型），后续响应应该更快。

5.5 常见问题排查

如果测试不成功，不要着急，按照以下步骤排查：

问题1：发送消息后没有任何回复

• 检查Clawdbot是否正在运行（终端是否有日志输出）
• 检查飞书应用版本是否已发布（状态应为“已发布”）
• 检查飞书事件订阅是否配置正确（应有im.message.receive_v1事件）

问题2：收到回复但内容错误或乱码

• 检查Clawdbot的模型配置是否正确指向Qwen3-VL
• 检查Ollama服务是否正常运行（可以访问Ollama Web界面测试）
• 检查网络连接是否正常

问题3：图片上传后AI无法识别

• 检查图片格式是否支持（JPG、PNG等常见格式都支持）
• 检查图片大小是否过大（建议不超过10MB）
• 检查模型是否正常加载（可以尝试纯文本对话测试）

大多数问题都可以通过查看Clawdbot的日志找到原因。日志会详细记录每一步的执行情况，是排查问题的宝贵工具。

6. 总结：从零到一的完整旅程

回顾我们完成的整个流程，其实可以概括为三个关键步骤：

6.1 我们完成了什么

1. 在飞书创建了AI助手的“身份”

   • 创建企业自建应用，获得唯一的App ID和App Secret
   • 开启机器人能力，让应用能够收发消息
   • 配置事件订阅和权限，建立完整的通信链路

2. 在Clawdbot配置了“翻译官”

   • 安装飞书专用插件，让Clawdbot能理解飞书的语言
   • 添加飞书通信渠道，绑定具体的应用凭证
   • 重启服务让配置生效，建立待机状态

3. 完成了端到端的“握手测试”

   • 从飞书发送消息，验证整个链路畅通
   • 测试图文对话，验证多模态能力正常
   • 观察后台状态，确认GPU实际在工作

6.2 这个方案的价值在哪里

你可能想问：市面上有很多AI对话产品，为什么还要自己搭建这么一套系统？

数据安全：所有对话数据都在你自己的服务器上处理，不会上传到第三方。对于企业敏感信息、设计图纸、内部文档等，这是最重要的保障。

定制化能力：你可以根据业务需求，训练或微调专属的模型。比如针对电商行业的商品识别、针对教育行业的题目讲解、针对医疗行业的报告分析等。

成本可控：一次部署，长期使用。不需要按使用量付费，适合高频使用的场景。

无缝集成：直接集成到团队日常使用的飞书中，无需切换应用，提升工作效率。

技术自主：完全掌握核心技术栈，可以根据需求随时升级模型、调整配置、扩展功能。

6.3 下一步可以做什么

现在你的AI助手已经基本就绪，但还有很多可以优化和扩展的方向：

功能扩展：

• 添加文件上传功能，让AI能处理PDF、Word、Excel等文档
• 实现多轮对话记忆，让AI能记住之前的聊天内容
• 添加语音输入输出，支持语音对话

性能优化：

• 调整模型参数，平衡响应速度和质量
• 配置缓存机制，提升高频问题的响应速度
• 设置使用频率限制，防止资源滥用

业务集成：

• 连接企业数据库，让AI能查询业务数据
• 集成工作流，自动处理特定类型的任务
• 开发专属插件，解决业务特定问题

团队推广：

• 将应用发布给更多团队成员使用
• 收集使用反馈，持续优化体验
• 建立使用规范，确保有效利用

6.4 最后的建议

如果你是第一次完成这样的集成，可能会觉得步骤有点多。但请记住，这已经是最简化、最零代码的方案了。传统的AI系统集成需要开发API接口、处理消息队列、管理会话状态、处理异常情况……而我们用Clawdbot这个工具，把所有这些复杂的工作都封装好了。

你现在拥有的，不仅仅是一个能看图说话的AI助手，更是一套完整的企业级AI能力底座。基于这个底座，你可以快速扩展更多功能，对接更多系统，创造更多价值。

技术的价值不在于它有多复杂，而在于它能让复杂的事情变简单。现在，你只需要在飞书里@你的AI助手，它就能帮你分析图片、解答问题、生成内容——这就是技术应该有的样子。

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。