零基础教程：在星图平台快速搭建Qwen3-VL飞书智能助手

1. 你能学会什么？——小白友好型入门指南

你不需要懂模型训练，也不用会写API网关代码。只要你会打开浏览器、复制粘贴App ID，就能在30分钟内，把一个30B参数的多模态大模型，变成你公司飞书里的专属AI助手。

这篇教程专为零基础用户设计：

• 零编程门槛：所有操作通过命令行交互完成，系统会一步步提示你填什么
• 零网络配置焦虑：不用申请公网IP、不用配Nginx反代、不用搞SSL证书
• 零环境冲突担忧：镜像已预装Clawdbot、Qwen3-VL:30B、飞书插件及全部依赖
• 零试错成本：每一步都有截图指引，填错可随时重来，不影响已有服务

我们最终要达成的效果是：你在飞书工作台点开“Clawd助教”，发一句“帮我总结这份会议纪要”，它就能立刻调用本地部署的Qwen3-VL模型，读取你上传的PDF或图片中的文字内容，生成结构化摘要并返回——整个过程数据不出企业内网，响应延迟低于2秒。

如果你正面临这些场景，这篇教程就是为你准备的：

• 行政同事每天要处理几十份扫描件，手动录入太耗时
• 技术团队想让飞书机器人自动解析架构图、流程图并生成说明文档
• 客服部门需要快速从产品手册截图中提取参数对比表
• 教育机构希望用AI辅助批改学生手写作业照片

别担心“30B”听起来很吓人——它已经打包进镜像里，你只需要告诉它“连上飞书”，剩下的事，交给Clawdbot自动完成。

---

2. 前置准备：三样东西，5分钟搞定

在开始之前，请确认你已具备以下三项基础条件。它们都不需要技术背景，就像注册一个新App一样简单：

2.1 你有一台已在CSDN星图平台运行的Qwen3-VL:30B实例

这是本教程的“上篇”成果。如果你还没完成私有化部署，请先阅读《星图平台快速搭建Qwen3-VL:30B（上篇）》。
不需要你重新部署模型，也不需要你登录GPU服务器敲CUDA命令——镜像已预装好全部算力底座。

2.2 你有飞书企业管理员权限（或能联系到管理员）

你需要能登录 飞书开放平台 并创建应用。普通员工账号无法开通机器人能力，但你可以请IT同事花2分钟帮你创建一个自建应用，并把App ID和App Secret发给你。

小贴士：飞书应用名称建议叫“Clawd助教”或“Qwen办公助手”，头像选个简洁蓝白图标，后续在飞书里一眼就能认出。

2.3 你有一台能访问星图云服务器终端的电脑（Mac/Windows/Linux均可）

不需要安装任何开发工具。只需：

• 打开浏览器，登录CSDN星图控制台
• 找到你的Qwen3-VL实例，点击“连接终端”
• 粘贴几条命令，回车执行

整个过程就像远程登录一台Linux电脑，没有图形界面，全是绿色文字滚动——但每一步都有明确提示，你只管照着填就行。

---

3. 第一步：在飞书开放平台创建你的AI助手身份

这一步相当于给你的AI助手办一张“飞书工作证”。它不涉及代码，纯网页操作，平均耗时3分钟。

3.1 登录并新建应用

1. 打开 飞书开放平台
2. 点击右上角“开发者后台” → “创建企业自建应用”
3. 填写应用信息：
   • 应用名称：Clawd助教（建议保持一致，方便后续识别）
   • 应用描述：基于Qwen3-VL的多模态办公助手（可自由填写）
   • 上传图标：任意PNG格式，尺寸建议256×256像素

注意：这个名称和图标，会直接出现在飞书工作台和群聊中。不要写“test”或“demo”，否则同事会以为是测试号。

3.2 开启机器人能力

在应用管理页左侧菜单，点击 “添加应用能力” → 搜索“机器人” → 点击“添加”。

此时页面会提示“请先创建一个版本”，这是飞书的强制流程，我们马上处理。

3.3 创建初始版本并获取凭证

1. 点击左侧 “凭证与基础信息”
2. 向下滚动，找到 “创建版本” 区域
3. 填写版本号 1.0.0，点击“提交”
4. 提交后，页面自动刷新，你会看到两个关键字段：
   • App ID：一长串以 cli_ 开头的字母数字组合
   • App Secret：一长串随机字符（点击小眼睛图标可显示）

请立即复制这两项，并保存在安全位置（如本地记事本）。它们是Clawdbot连接飞书的唯一钥匙，泄露会导致他人冒充你的AI助手。

---

4. 第二步：在星图服务器上启用飞书通道

现在回到CSDN星图控制台，打开你的Qwen3-VL实例终端。这里所有命令都已预装，无需pip install、无需git clone，真正开箱即用。

4.1 安装飞书专用插件

在终端中输入以下命令（注意空格和符号）：

clawdbot plugins install @m1heng-clawd/feishu

你会看到类似这样的输出：

✔ Plugin @m1heng-clawd/feishu installed successfully
→ Version: 1.2.4
→ Commands available: clawdbot feishu:setup

这表示飞书连接器已就绪。Clawdbot不是通用框架，而是为Qwen3-VL深度定制的轻量级网关，插件体积仅127KB，安装耗时不到3秒。

4.2 绑定飞书应用凭证

接下来，把刚才复制的App ID和App Secret填入Clawdbot：

clawdbot channels add

系统会依次提示你：

• Channel type? → 输入 feishu（按Tab键可自动补全）
• App ID? → 粘贴你保存的App ID
• App Secret? → 粘贴你保存的App Secret
• Channel name? → 直接回车，默认为 feishu-main

提示：如果输错了，可以按 Ctrl+C 中断，重新执行 clawdbot channels add 即可，不会覆盖旧配置。

执行完成后，你会看到：

✔ Channel 'feishu-main' added successfully
→ Status: enabled
→ Endpoint: /api/v1/channels/feishu-main

这意味着Clawdbot已准备好接收飞书发来的消息。

---

5. 第三步：在飞书后台完成双向通信配置

这一步是让飞书“认识”你的Clawdbot，也是最容易卡住的环节。我们采用最简路径——长连接模式（WebSocket），完全规避公网IP、域名、HTTPS等传统难题。

5.1 启动Clawdbot网关服务

在星图终端中执行：

clawdbot gateway

你会看到日志开始滚动，其中包含一行关键信息：

[INFO] WebSocket server listening on ws://localhost:8080

这表示Clawdbot网关已启动，并在本地监听WebSocket连接。注意：它监听的是 localhost，不是公网地址——这正是我们能绕过复杂网络配置的核心原因。

5.2 在飞书后台配置长连接回调

1. 回到飞书开放平台 → 进入你的“Clawd助教”应用
2. 左侧菜单选择 “事件订阅”
3. 点击 “开启事件订阅” → 选择 “长连接（WebSocket）”
4. 在“WebSocket地址”栏，粘贴以下地址（注意：直接复制，不要修改）：

   ws://localhost:8080
   

5. 点击“保存”

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

• 星图终端中 clawdbot gateway 是否仍在运行（不要关闭窗口）
• App ID和App Secret是否填错（大小写敏感）
• 飞书应用是否已发布（见下一步）

5.3 订阅必要事件并开通权限

订阅事件（必须勾选）

在“事件订阅”页面，点击 “添加事件”，勾选以下两项：

• im.message.receive_v1（接收消息）
• contact.user.info_v1（获取用户基本信息）

开通对应权限（必须勾选）

进入左侧 “权限管理” 页面，勾选：

• contact:user.base:readonly（用于识别谁发的消息）
• im:message → 展开后勾选 send_message 和 receive_message（用于收发消息）

权限和事件必须严格一一对应，缺一不可。Clawdbot不会猜测你要什么，它只做你明确授权的事。

5.4 发布新版本使配置生效

最后一步：点击左上角 “应用发布” → 选择刚创建的 1.0.0 版本 → 点击“发布”。

发布成功后，页面顶部会出现绿色提示：“应用已发布，新配置已生效”。

---

6. 第四步：端到端效果验证——发一条消息试试看

现在，真正的魔法时刻来了。我们不做任何代码调试，直接在飞书客户端发起真实交互。

6.1 在飞书中找到并启动你的AI助手

1. 打开手机或PC版飞书
2. 点击底部导航栏 【工作台】
3. 在搜索框输入“Clawd助教”（或你设置的应用名称）
4. 点击进入应用卡片

首次进入时，飞书会弹窗提示“是否允许该应用访问你的信息”，点击“允许”即可。

6.2 发送第一条多模态指令

在聊天窗口中，尝试发送以下任意一种消息：

• 纯文本：
  请用三句话总结我上周的会议纪要

• 文字+图片（截图/拍照）：
  发一张带表格的Excel截图，配文：提取这张图里的所有参数，列成Markdown表格

• 纯图片（无文字）：
  发一张手写笔记照片，配文：把这张图转成可编辑的文字

你会看到：

• 飞书界面出现“正在思考…”提示（约1–3秒）
• 紧接着返回结构化结果，例如：

  已识别图片中包含3个参数：

  参数名	数值	单位
  温度	25.3	℃
  湿度	62	%
  压力	101.2	kPa

6.3 实时观察模型调用状态

同时打开星图控制台的 “监控” 标签页，你会看到：

• GPU显存占用率瞬间从30%跃升至85%（Qwen3-VL:30B被激活）
• 终端日志实时打印：

  [FEISHU] Received message from user_abc123: "提取这张图里的所有参数..."
  [MODEL] Qwen3-VL-30B loaded, processing image...
  [RESPONSE] Sent reply to feishu-main: " 已识别图片中包含3个参数..."
  

这证明：从飞书消息 → Clawdbot路由 → Qwen3-VL视觉理解 → 结果返回飞书，整条链路已100%贯通。

---

7. 常见问题速查——90%的问题都在这里

我们整理了新手实操中最常遇到的5类问题，附带一键解决方法：

7.1 问题：飞书提示“机器人未上线”或“无法连接”

• 解决方案：检查星图终端中 clawdbot gateway 是否仍在运行。如果窗口关闭了，重新执行该命令即可。
• 不要重启整个实例，Clawdbot是独立进程，单独启停不影响模型服务。

7.2 问题：发消息后无响应，终端日志无记录

• 解决方案：回到飞书开放平台 → “事件订阅” → 确认“长连接”已开启且状态为“已连接”。
• 不要切换成“HTTP回调”模式，那需要公网IP和HTTPS证书，本教程不涉及。

7.3 问题：能收到消息，但回复内容是乱码或英文

• 解决方案：在Clawdbot配置中指定中文输出。在终端执行：

clawdbot config set model.qwen3-vl.language zh-CN

• 不需要修改模型权重或重新加载，这是纯配置层开关。

7.4 问题：上传图片后提示“不支持的文件类型”

• 解决方案：Qwen3-VL:30B默认支持JPG/PNG/WebP。请用手机相册原图发送，不要用微信“原图”功能（它会转成HEIC格式）。
• 不需要安装图像转换工具，Clawdbot不处理HEIC，这是飞书客户端限制。

7.5 问题：想让助手只在特定群组可用，如何设置？

• 解决方案：在飞书开放平台 → “权限管理” → 取消勾选 im:message 下的 send_message，仅保留 receive_message。这样它只能被动响应@提及，不会主动推送消息。
• 不需要改Clawdbot代码，所有权限控制由飞书平台统一管理。

---

8. 下一步：让AI助手真正融入你的工作流

现在你已拥有了一个可工作的飞书AI助手。但它的潜力远不止于单次问答。以下是三个零代码即可启用的进阶用法：

8.1 设置关键词自动响应（比如“报销”“请假”）

在星图终端执行：

clawdbot triggers add --keyword "报销" --response "请上传发票照片，我会自动识别金额和日期"

之后，只要有人在群聊中发“报销”，助手就会自动回复提示语。

8.2 接入内部知识库（无需向量数据库）

将公司制度PDF、产品手册Word等文件，放入星图实例的 /data/kb/ 目录。Clawdbot会自动索引，下次提问时加上前缀 #kb 即可触发知识检索：

#kb 试用期员工离职流程是什么？

8.3 批量处理图片任务

在飞书中@助手并发送多张图片，它会自动逐张分析并汇总结果。例如：

请分析这5张服务器监控截图，列出所有异常告警

---

9. 总结：你刚刚完成了什么？

你没有写一行模型推理代码，没有配置一个Nginx规则，没有申请一个SSL证书，却完成了一件在半年前还需要专业AI工程师团队才能做到的事：

• 将300亿参数的Qwen3-VL多模态大模型，私有化部署在企业可控环境中
• 通过Clawdbot轻量网关，将其无缝接入飞书工作台与群聊
• 实现文本、图片、图表的混合理解与结构化输出
• 全程数据不出本地，满足金融、政务、医疗等强合规场景要求

这不是一个Demo，而是一套可立即投入生产使用的AI办公基础设施。行政、HR、客服、研发团队，今天就能用它处理日常重复性认知劳动。

更重要的是，你掌握的不是某个具体命令，而是一种AI集成范式：

算力底座（Qwen3-VL） + 轻量网关（Clawdbot） + 业务入口（飞书） = 企业专属AI助手

这套范式同样适用于钉钉、企业微信、甚至内部OA系统——只需替换对应的插件和配置，核心逻辑完全复用。

---

获取更多AI镜像

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