三步搞定！Qwen3-VL+飞书打造企业级多模态助手实战

三步搞定！Qwen3-VL+飞书打造企业级多模态助手实战

你是不是也遇到过这样的场景：市场部同事发来一张活动海报截图，问“主视觉有没有违禁词？”；客服团队上传客户投诉的聊天截图，急需快速提取关键诉求；甚至法务同事甩来一份扫描版合同，只说一句：“快看看违约条款在哪一页？”——这些任务，过去全靠人工翻查、比对、总结，耗时又易错。

现在，一个能“看图说话”的AI助手，就藏在你的飞书工作台里。它不依赖公网API，所有图像和文字都在企业内网处理；它不用反复切换窗口，消息一发，答案即回；它不止能读图，还能结合上下文推理、追问、生成摘要——这就是我们用 Qwen3-VL:30B + Clawdbot + 飞书搭建的企业级多模态智能助手。

本文不讲抽象架构，不堆技术参数，全程聚焦“怎么让这个助手今天就在你公司飞书里跑起来”。三步，每步10分钟以内，零代码调试，无需GPU运维经验。你只需要一台已部署好 Qwen3-VL 的星图云服务器（上篇已完成），以及一个有管理员权限的飞书账号。

我们不追求“一步登天”，而是确保你做完这三步后，能在飞书里真实发送一张图片、提一个问题，并亲眼看到模型调用日志滚动、GPU显存跳动、最终回复精准弹出——那种“它真的活了”的确定感，才是落地的第一块基石。

1. 准备工作：确认基础环境就绪，跳过重复配置

1.1 确认 Qwen3-VL:30B 已私有化运行

在开始接入飞书前，请先确认你的底层算力底座已稳定就位。这不是可选步骤，而是整个链路的起点。

打开 CSDN 星图 AI 控制台，找到你上篇部署的实例（名称应类似qwen3-vl-30b-private），检查以下三项状态：

• 运行状态：显示为“运行中”，非“停止”或“异常”
• GPU 显存占用：空闲时维持在 8–12GB（模型加载常驻内存），说明权重已成功载入
• 服务端口监听：终端中可见类似INFO: Uvicorn running on http://0.0.0.0:8000的日志，表示推理 API 已对外暴露

如果你看到显存占用接近 0GB 或服务端口未启动，请返回上篇文档，重点检查clawdbot start命令执行结果及模型路径配置。不要跳过这一步直接进入飞书配置——没有算力底座，飞书只是个漂亮的空壳。

1.2 确认 Clawdbot 网关已预装飞书插件

Clawdbot 并非从零开发的机器人框架，而是一个专为多模态 Agent 设计的轻量级网关。它的核心优势在于“插件即服务”：飞书、QQ、微信等渠道能力，都以独立插件形式存在，且本镜像已预装完毕。

你无需手动执行npm install或下载源码。只需在星图云服务器终端中运行：

clawdbot plugins list

你会看到输出中明确包含这一行：

@m1heng-clawd/feishu installed (v1.2.4)

表示飞书插件已就绪。若显示 或未列出，请执行一次强制重装（极少发生）：

clawdbot plugins uninstall @m1heng-clawd/feishu clawdbot plugins install @m1heng-clawd/feishu

小贴士：为什么镜像要预装？因为飞书 SDK 依赖特定版本的@larksuite/oapi和ws库，手动安装极易因 Node.js 版本冲突失败。预装即验证，省去 90% 的环境踩坑时间。

1.3 确认飞书企业管理员权限可用

本方案需在飞书开放平台创建自建应用并开通权限，操作者必须具备企业超级管理员或“应用管理”权限。

请用你的飞书账号登录 飞书开放平台，点击右上角头像 → “企业信息”，确认当前身份栏显示：

• 企业名称：与你日常使用的飞书组织一致
• 角色：标注为“超级管理员”或“应用管理员”

若显示“普通成员”，请立即联系企业 IT 负责人授权。没有该权限，后续所有配置将卡在“应用发布”环节，无法生效。

2. 第一步：在飞书开放平台创建自建应用（5分钟）

这一步的目标，是为你的多模态助手申请一个“飞书户口”，让它能合法地出现在工作台、接收消息、调用用户数据。

别被“开放平台”四个字吓到——它本质就是一个表单填写流程，所有字段都有明确提示，且我们只启用最核心的几项能力。

2.1 创建应用并命名

登录 飞书开放平台 后，点击左侧导航栏“开发者后台”→“我的应用”→“创建应用”→“创建企业自建应用”。

在弹出的表单中填写：

• 应用名称：建议使用业务导向命名，如Clawd助教、图文智审、Qwen办公助手
  （避免用“机器人”“AI”等泛称，飞书工作台会直接显示此名称，需让用户一眼理解用途）
• 应用描述：一句话说明价值，例如自动解析图片中的文字、表格与图表，支持多轮图文问答
• 应用图标：上传一张 120×120 像素的 PNG 图标（推荐使用公司 logo 或简洁的 Qwen 字母图标）

点击“创建”，应用即生成。此时你已拥有一个专属 App ID，但还不能使用。

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

在新创建的应用管理页，左侧菜单选择“添加应用能力”→ 点击“机器人”卡片 → 点击“添加”。

添加成功后，左侧菜单会出现“机器人”选项。点击进入，再点击顶部的“凭证与基础信息”标签页。

这里你会看到两个关键字符串：

• App ID：一长串以cli_开头的字母数字组合（如cli_a1b2c3d4e5f67890）
• App Secret：一长串随机字符（如gHjKlMnOpQrStUvWxYz1234567890AbC）

请立即将这两串字符复制保存到本地文本文件中。它们是 Clawdbot 连接飞书的唯一钥匙，飞书后台不会再次明文显示 Secret。

为什么需要这两个值？
App ID 是你的助手在飞书生态里的“身份证号”，App Secret 则是“密码”。Clawdbot 每次向飞书发送请求时，都会用 Secret 对请求签名，飞书通过 ID 找到对应应用并用 Secret 验证签名真伪——这是 OAuth2 认证的标准流程，保障通信安全。

2.3 提交初始版本（关键动作，不可跳过）

很多用户卡在这一步：填完凭证，却始终无法收到消息。原因往往是缺少一个“触发点”。

在“凭证与基础信息”页面底部，找到“版本管理”区域，点击“新建版本”。

• 版本号：输入1.0.0（固定格式，无需修改）
• 版本描述：填写初始配置，启用机器人基础能力
• 点击“提交”

提交成功后，页面会显示“版本 1.0.0 已创建”。这一步看似简单，实则是飞书后台初始化应用元数据的必要操作。没有它，后续的事件订阅和权限配置将无法关联到有效版本。

3. 第二步：在 Clawdbot 中绑定飞书渠道（3分钟）

现在，你手握飞书的“身份证”和“密码”，接下来就是把它们交给 Clawdbot，让它成为飞书认证的正式成员。

这一步完全在命令行中完成，无图形界面，但交互极其友好——它会一步步引导你输入，输错还能回退。

3.1 运行渠道添加命令

回到星图云服务器终端（SSH 连接），确保 Clawdbot 正在运行（clawdbot status应显示 active）。然后执行：

clawdbot channels add

你会看到清晰的交互提示：

? 请选择渠道类型: (Use arrow keys) ❯ feishu - 飞书机器人 wecom - 企业微信 dingtalk - 钉钉

按方向键选择feishu，回车。

3.2 填写飞书凭证（粘贴即可）

接下来，系统会依次询问：

? 请输入 App ID: ? 请输入 App Secret: ? 请输入加密密钥（可选，留空则自动生成）:

• 在App ID后，直接粘贴你刚保存的 App ID 字符串
• 在App Secret后，直接粘贴你刚保存的 App Secret 字符串
• 加密密钥留空，按回车（Clawdbot 会自动生成强随机密钥用于本地数据加密）

几秒后，终端显示：

飞书渠道 'feishu-1' 添加成功！ 下一步：请前往飞书开放平台配置事件订阅与权限。

此时，Clawdbot 已将凭证写入本地配置文件（路径通常为~/.clawdbot/channels/feishu-1.json），并完成内部初始化。

验证小技巧：
运行clawdbot channels list，输出中应包含：

feishu-1 enabled (App ID: cli_a1b2...)

4. 第三步：在飞书后台完成事件订阅与权限开通（7分钟）

这是最后也是最关键的一步：告诉飞书“允许这个应用做什么”，并建立双向通信通道。完成后，你的助手才算真正“上岗”。

4.1 配置事件订阅（WebSocket 长连接）

在飞书开放平台，进入你的应用 → 左侧菜单“事件订阅”→ 点击“开启事件订阅”。

• 订阅模式：选择“长连接（WebSocket）”（强烈推荐！无需公网 IP，适配星图云内网环境）
• 回调地址：系统会自动填充一个wss://开头的地址（如wss://gateway.clawd.ai/v1/ws）

  这正是 Clawdbot 网关监听的 WebSocket 地址，无需修改。

点击“保存”。如果提示“未建立长连接”，请立即检查：

• 星图服务器终端中，clawdbot gateway是否正在运行？（运行clawdbot status确认）
• 终端日志中是否出现WebSocket server started on wss://0.0.0.0:8080类似行？
• 防火墙是否放行了 8080 端口？（星图平台默认已开放）

待状态变为“已开启”，说明飞书与 Clawdbot 的心跳通道已打通。

4.2 订阅核心事件（仅需勾选两项）

在同一页面，点击“添加事件”→ 在弹窗中搜索并勾选：

• im.message.receive_v1：接收消息事件（必选！否则收不到用户提问）
• contact.user.add_v2：用户添加事件（可选但推荐，用于欢迎新成员）

为什么只选这两项？
im.message.receive_v1是对话的入口，没有它，助手就是聋子；
contact.user.add_v2能让你在新员工加入时自动推送《助手使用指南》，提升采纳率。
其他事件（如群聊、表情、文件）当前阶段无需启用，避免权限过度申请。

4.3 开通最小必要权限（安全第一）

左侧菜单切换到“权限管理”→ 点击“添加权限”。

勾选以下两项（严格按此范围，不增不减）：

点击“确定”后，页面会提示“权限已添加”。此时，你已授予助手最基础的“看见人”和“说话”权利。

4.4 发布新版本，让配置生效（终极确认）

权限开通后，必须发布新版本，所有配置才会推送到飞书生产环境。

回到左侧菜单“版本管理”→ 点击“新建版本”→ 输入1.1.0→ 描述填写开通消息收发与用户信息权限→ 点击“提交”。

等待约 10 秒，状态变为“审核中” → “已发布”。此时，页面顶部会显示绿色提示：

当前版本 1.1.0 已发布，配置已生效。

至此，所有配置完成。你已打通：飞书前端 ↔ Clawdbot 网关 ↔ Qwen3-VL:30B 算力底座。

5. 端到端验证：发一条消息，亲眼见证链路贯通

理论终须实践检验。现在，请拿出手机或打开飞书桌面端，进行最后一次真实测试。

5.1 在飞书工作台中找到并启动助手

• 打开飞书 → 点击左下角【工作台】
• 在搜索框输入你设置的应用名称（如Clawd助教）
• 点击进入应用卡片 → 点击“开始使用”或直接输入消息框

5.2 发送第一条多模态请求

尝试发送一个混合内容的消息，例如：

• 上传一张清晰的会议纪要截图（含文字和简单表格）
• 在消息框中输入：请提取会议结论和待办事项，分点列出

发送后，观察三个地方：

1. 飞书客户端：3–8 秒内，助手头像旁出现回复气泡，内容为结构化要点
2. 星图云终端：clawdbot日志实时滚动，显示类似：

   [FEISHU] Received message from 张三 (IT部) → forwarding to Qwen3-VL... [QWEN3-VL] Inference started for image_id=abc123... [QWEN3-VL] Response generated (tokens: 142, time: 5.2s) [FEISHU] Sending reply to user...

3. 星图 GPU 监控：nvidia-smi命令输出中，显存占用瞬间从 10GB 跃升至 38GB，数秒后回落

三处同步响应，证明整条链路——从飞书消息触达、Clawdbot 解析路由、Qwen3-VL 多模态推理、再到飞书消息回传——已 100% 贯通。

如果首次测试未成功，请按此顺序排查：
① 飞书工作台是否显示“应用已停用”？→ 去“版本管理”确认 1.1.0 为“已发布”
② 终端日志是否报401 Unauthorized？→ 检查 App ID/Secret 是否粘贴完整，有无多余空格
③ GPU 显存无波动？→ 运行clawdbot status确认qwen3-vl服务进程存活

总结

• 三步极简路径：飞书建应用（5分钟）→ Clawdbot 绑凭证（3分钟）→ 飞书开权限（7分钟），全程无需改一行代码、不碰一个配置文件，所有操作皆为点击与粘贴。
• 真正的私有化闭环：图像与文字全程在企业内网流转，Qwen3-VL:30B 模型权重不离星图服务器，飞书仅作为消息通道，数据主权牢牢掌握在自己手中。
• 开箱即用的多模态能力：不是简单的 OCR 或文字问答，而是能理解图表趋势、分析文档逻辑、跨图对比推理——这才是 Qwen3-VL 作为第三代视觉语言模型的核心价值。
• 企业级就绪设计：Clawdbot 的插件架构让渠道扩展毫无压力，今天接飞书，明天可无缝接入企业微信或钉钉；Qwen3-VL 的 30B 规模，在保证专业级精度的同时，仍能支撑 5–10 人并发的日常办公负载。

你现在拥有的，不再是一个技术 Demo，而是一个可立即投入真实业务场景的生产力工具。下一步，不妨邀请市场、客服、法务三个部门的同事，各自上传一张工作中最常遇到的图片，发起一次“谁的问题最难倒 Qwen3-VL”挑战赛——答案，往往就藏在第一次真实的使用反馈里。

--- > **获取更多AI镜像** > > 想探索更多AI镜像和应用场景？访问 [CSDN星图镜像广场](https://ai.csdn.net/?utm_source=mirror_blog_end)，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。