星图平台+Clawdbot：Qwen3-VL飞书智能助手一站式搭建

1. 学习目标与前置说明

1.1 你能学到什么

这是一篇面向企业技术落地的实战指南，不讲空泛概念，只聚焦一件事：如何把已在星图平台私有化部署好的 Qwen3-VL:30B 多模态大模型，通过 Clawdbot 这个轻量级 Agent 网关，快速、稳定、安全地接入飞书（Lark）工作台，变成你团队每天都在用的“看得懂图、读得懂表、答得准问题”的智能助手。

学完本篇，你将能：

• 在飞书工作台中直接打开自己的 AI 助手应用，像聊天一样发送文字或图片
• 让 Qwen3-VL:30B 模型实时理解用户上传的截图、Excel 表格、产品设计稿并给出专业反馈
• 完全掌控数据流向——所有图片和文字都在你的私有服务器上处理，不出内网
• 避开公网暴露、反向代理、SSL 证书等复杂配置，用长连接模式实现零公网 IP 接入
• 掌握一套可复用的“大模型 + Agent 网关 + 企业 IM”集成方法论，后续接入钉钉、企微同样适用

无论你是运维工程师、AI 平台负责人，还是想为业务部门快速上线智能工具的产品经理，这篇都能让你在两小时内完成从配置到可用的全过程。

1.2 前置确认清单

请花 30 秒快速核对以下三点，确保后续操作顺畅无阻：

• 上篇已完成：你已在 CSDN 星图 AI 平台成功部署 Qwen3-VL:30B 模型，并可通过 curl 或本地 API 正常调用（如 http://localhost:8000/v1/chat/completions）
• Clawdbot 已运行：星图云服务器终端中，clawdbot status 命令返回 running，且日志中可见模型加载成功的提示
• 飞书管理员权限：你拥有企业飞书开放平台的管理员或应用创建者权限，可新建自建应用、配置事件与权限

提示：本文默认你已熟悉飞书工作台的基本操作。若尚未开通飞书开放平台权限，请先联系企业管理员开通“开发者权限”。

2. 飞书侧准备：三步创建可信企业应用

2.1 创建自建应用并启用机器人能力

登录 飞书开放平台，点击左上角「创建应用」→「创建企业自建应用」。

填写应用信息时，请注意两个关键点：

• 应用名称：建议使用业务场景命名，例如“Clawd助教”“文档小智”“报表解读官”，避免使用“AI助手”“智能机器人”等泛称，便于员工识别
• 应用图标：上传一张简洁清晰的 PNG 图标（推荐 128×128 像素），它会直接显示在飞书工作台和群聊中，是用户第一眼建立信任的关键

创建完成后，进入应用管理页，在左侧菜单选择「添加应用能力」→「机器人」→「添加」。

这一步不是可选项，而是必须项。Clawdbot 的飞书插件正是通过这个“机器人”能力与飞书建立通信通道的。

2.2 初始化版本并获取核心凭证

飞书要求所有配置变更必须基于一个“已发布的版本”。因此，我们需要先提交一个基础版本。

在应用管理页，点击顶部导航栏的「版本管理」→「创建新版本」，填写版本号 1.0.0，描述写“初始版本，仅开通机器人能力”，然后点击「提交审核」→「发布」。

发布成功后，切换到「凭证与基础信息」页面。这里你会看到两个至关重要的字符串：

• App ID：一串以 cli_ 开头的 32 位字母数字组合，是飞书识别你应用的唯一身份标识
• App Secret：一串随机生成的密钥，用于双向身份校验，务必复制保存，飞书后台不会再次显示

安全提醒：App Secret 相当于你的应用“密码”，切勿截图上传至公开平台，也不要在代码中硬编码。Clawdbot 的配置流程会将其加密存储在本地，无需你手动管理。

2.3 配置事件订阅与最小必要权限

这是整个链路中最容易出错也最关键的一步。很多用户卡在“消息收不到”，90% 是因为权限没开全或事件没订阅。

进入「事件订阅」页面，选择 “长连接（WebSocket）” 模式（非 HTTP 回调）。这是本方案的核心优势：无需公网 IP、无需域名备案、无需 Nginx 反向代理，Clawdbot 会主动连接飞书服务器，建立一条持久、安全的双向通道。

接着点击「添加事件」，勾选以下两项：

• im.message.receive_v1：接收用户发来的消息（文字、图片、文件）
• contact.user.add_v1：识别新成员加入（可选，用于欢迎语）

最后，进入「权限管理」页面，勾选对应权限范围：

权限名称	必须勾选子项	为什么需要？
获取基础用户信息	contact:user.base:readonly	识别提问人是谁，支持个性化回复
接收与发送消息	im:message:readonly 和 im:message:send	实现“收到→理解→生成→回复”的完整闭环

小技巧：勾选完权限后，一定要回到「版本管理」，点击「创建新版本」→「发布」。飞书的权限策略是“配置随版本生效”，旧版本的配置不会自动更新。

3. Clawdbot 侧操作：两行命令完成飞书对接

3.1 安装飞书专用插件（开箱即用）

Clawdbot 的设计理念是“插件即服务”。飞书连接器已作为官方插件预置在镜像中，你只需执行一条命令即可激活：

clawdbot plugins install @m1heng-clawd/feishu

该命令会自动下载、校验并注册飞书插件。执行成功后，终端会输出类似 Plugin @m1heng-clawd/feishu installed successfully 的提示。

插件原理简述：该插件封装了飞书 WebSocket 协议的全部细节，包括心跳保活、消息加解密、事件路由分发。你不需要关心底层协议，只需提供 App ID 和 Secret。

3.2 绑定飞书渠道并启动网关

接下来，将飞书应用的凭证绑定到 Clawdbot 的通信渠道系统：

clawdbot channels add

按提示依次输入：

1. Channel Type：选择 feishu
2. App ID：粘贴你刚复制的 cli_xxx 字符串
3. App Secret：粘贴对应的密钥
4. Channel Name：给这个渠道起个名字，例如 feishu-prod（方便后续多环境管理）

配置完成后，Clawdbot 会自动生成一个 channels/feishu-prod.json 文件，其中敏感字段已加密。

最后，重启网关服务，让新配置生效：

clawdbot gateway restart

此时，终端日志中会出现类似 Feishu channel 'feishu-prod' connected successfully 的提示，表示 Clawdbot 已成功与飞书服务器建立长连接。

关键验证点：如果日志中出现 WebSocket connection established 且无报错，说明飞书侧的事件订阅已打通，可以进入最终测试。

4. 端到端效果验证：从飞书提问到模型响应

4.1 在飞书工作台发起首次交互

打开你的飞书客户端（PC 或手机均可），点击底部导航栏「工作台」→ 在搜索框中输入你创建的应用名称（如“Clawd助教”）→ 点击进入。

你会看到一个干净的聊天界面。现在，尝试发送第一条消息：

• 纯文本测试：输入 你好，今天有什么待办事项？
• 图文混合测试：点击输入框旁的「+」号 → 选择一张包含待办清单的截图 → 输入 帮我整理这张图里的任务，按优先级排序

几秒后，你应该会收到一条结构清晰的回复，内容来自你私有服务器上的 Qwen3-VL:30B 模型。

4.2 观察星图平台实时反馈

为了确认整条链路真实生效，我们同步查看星图平台的运行状态：

• GPU 显存监控：登录星图 AI 控制台，在实例详情页观察 GPU 显存占用曲线。当你在飞书中发送图片消息时，显存占用会瞬间跃升（Qwen3-VL:30B 处理一张 1024×768 图片约需 8–12GB 显存），处理完毕后回落，形成一个明显的“脉冲峰”。
• Clawdbot 日志追踪：在服务器终端中，执行 clawdbot logs -f 查看实时日志。你会看到类似以下的流水线记录：

  [INFO] feishu-prod: Received message from user_abc123 (image)
  [INFO] gateway: Forwarding to model qwen3-vl:30B
  [INFO] model: Inference started, input tokens: 1248, image patches: 64
  [INFO] model: Response generated (217 tokens), latency: 3.8s
  [INFO] feishu-prod: Sent reply to user_abc123
  

  这条日志清晰展示了“飞书接收 → 网关转发 → 模型推理 → 结果返回”的完整路径，每一环都可追溯、可审计。

成功标志：飞书端收到回复 + 显存出现脉冲 + 日志显示 Sent reply。三者同时满足，即代表部署完全成功。

5. 实战进阶：让助手真正“懂业务”

5.1 自定义 system prompt，注入领域知识

Qwen3-VL:30B 的强大在于其多模态理解能力，但要让它真正服务于你的业务，需要注入上下文。Clawdbot 支持为每个渠道设置专属的 system prompt。

编辑 config/channels/feishu-prod.json，在 model_config 下添加：

"system_prompt": "你是一名资深的[XX公司]IT支持专家，熟悉所有内部系统（OA、CRM、ERP）的操作流程。用户可能上传系统截图或错误日志，请结合图片内容，用中文给出具体、可执行的解决方案，避免使用技术术语。"

保存后执行 clawdbot gateway restart，下次用户上传 OA 系统报错截图时，助手就能精准定位问题模块并指导操作步骤。

5.2 批量处理图片，提升办公效率

很多业务场景需要批量分析图片，比如客服部门每天要处理上百张用户投诉截图。Clawdbot 支持“多图并发处理”。

在飞书中，你可以一次性上传最多 10 张图片（总大小不超过 20MB），并输入指令：请分别分析这 10 张图中的问题类型，并汇总成表格。

Qwen3-VL:30B 会逐张理解每张图，再综合生成一份 Markdown 表格，包含“图片编号、问题类别、严重等级、建议措施”四列，直接复制到飞书文档中即可使用。

5.3 安全边界控制：谁可以用？能看什么？

作为企业级助手，权限管控必不可少。Clawdbot 提供两级过滤：

• 飞书侧白名单：在飞书开放平台「应用管理」→「可见范围」中，可精确指定哪些部门、哪些成员能访问该应用，其他人员完全不可见
• Clawdbot 侧内容过滤：在 config/gateway.json 中启用 content_safety 模块，可配置关键词黑名单（如“工资”“合同”“客户手机号”），当用户提问涉及敏感词时，自动返回预设的安全提示，而非调用模型

数据主权声明：所有图片、文字、对话历史均存储在你的星图云服务器本地磁盘中，Clawdbot 不上传任何数据至第三方，符合《个人信息保护法》及企业数据治理规范。

6. 总结

6.1 我们到底完成了什么？

回看整个过程，你其实已经构建了一套企业级多模态智能助手的最小可行架构（MVP）：

• 底层算力层：Qwen3-VL:30B 在星图平台私有化部署，保障数据不出域、模型可定制、推理高性能
• 中层网关层：Clawdbot 作为轻量级 Agent 枢纽，统一管理飞书连接、消息路由、模型调用与安全策略
• 顶层应用层：飞书工作台作为用户入口，零学习成本，无缝融入现有办公流

这不是一个“玩具 Demo”，而是一套可立即投入生产的解决方案。它解决了三个核心痛点：

• 数据安全焦虑：告别公有云 API 调用，所有计算在私有服务器完成
• 多模态落地难：一张截图、一份 PDF、一张图表，都能被准确理解并给出专业反馈
• 集成成本高：无需开发 Web 后端、无需申请公网 IP、无需配置 HTTPS，两行命令完成对接

6.2 下一步，你可以做什么？

• 横向扩展：用同样的 Clawdbot 插件机制，接入钉钉（@m1heng-clawd/dingtalk）或企业微信（@m1heng-clawd/wecom），打造跨平台统一 AI 助手
• 纵向深化：为 Qwen3-VL:30B 添加 RAG（检索增强）能力，接入企业知识库，让助手不仅能“看图说话”，还能“查文档作答”
• 场景沉淀：将高频问答（如“如何重置 VPN 密码”“报销单怎么填”）固化为预设模板，提升响应速度与一致性

真正的 AI 落地，不在于参数规模有多大，而在于是否能安静地坐在你的飞书工作台里，解决一个又一个具体的问题。

---

获取更多AI镜像

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