从零开始：在星图平台搭建私有化Qwen3-VL飞书机器人

从零开始在星图平台搭建私有化Qwen3-VL飞书机器人你是不是也想过如果能有一个专属的AI助手直接集成在飞书里既能看图说话又能处理文档还不用担心数据泄露那该多方便今天我们就来把这个想法变成现实。在上一篇文章里我们已经在CSDN星图AI云平台上成功部署了强大的多模态大模型Qwen3-VL:30B。现在我们要做的就是给这个“大脑”装上“手脚”让它能通过飞书和我们对话。整个过程就像搭积木一样简单清晰。1. 准备工作理清思路备好材料在开始动手之前我们先花一分钟看看整个流程的全貌。这能帮你更好地理解每一步在做什么避免“只见树木不见森林”。我们的目标是把部署在星图平台上的Qwen3-VL模型通过一个叫Clawdbot的智能网关连接到飞书。你可以把Clawdbot想象成一个“翻译官”和“接线员”它负责接收飞书的消息转发给Qwen3-VL模型处理再把模型的回复传回飞书。整个搭建过程主要分为三个核心环节在飞书开放平台“注册”你的机器人就像给机器人办个“身份证”告诉飞书系统“我这里有个人工智能要接入”。在星图服务器上“安装”连接器给Clawdbot装上能和飞书“通话”的插件。让两边“握手”建立连接配置好通信协议和权限确保消息能顺畅地一来一回。听起来是不是没那么复杂了接下来我们就一步步来操作。2. 第一步在飞书创建你的专属应用首先我们需要在飞书开放平台创建一个“企业自建应用”这就是我们机器人在飞书世界的合法身份。2.1 创建应用并开启机器人能力打开浏览器访问 飞书开放平台 并登录。在开发者后台点击页面上的“创建企业自建应用”按钮。这时会弹出一个创建应用的窗口。你需要填写两个关键信息应用名称给你的机器人起个名字比如“AI小助手”、“文档分析官”等。应用描述简单描述一下这个应用是做什么的比如“基于大模型的智能问答助手”。这里有个小建议应用名称和后续上传的应用图标会直接显示在飞书工作台和聊天界面里。所以起个好听的名字选个有辨识度的图标能让你的机器人更受欢迎。创建完成后进入应用的管理页面。在左侧导航栏找到“添加应用能力”点击进入后你会看到一个能力列表。找到并点击添加“机器人”能力。这一步至关重要它相当于给你的应用赋予了“说话”和“听令”的基本权限。2.2 获取关键凭证App ID 和 App Secret为了让我们的Clawdbot能代表这个应用去和飞书服务器通信我们需要拿到两个像“账号密码”一样的凭证。在应用管理页面找到“凭证与基础信息”菜单。点进去你就能看到App ID和App Secret。请务必妥善保存这两个信息最好复制到记事本里。它们是你应用的身份标识后续在Clawdbot里配置时会用到。App Secret尤其重要它一旦生成就无法再次查看如果丢失只能重置会生成新的所以一定要记好。为了后续配置流程更顺畅飞书平台建议我们先创建一个应用版本。你可以在“版本管理与发布”里创建一个1.0.0的初始版本并提交。这样一些基础配置就生效了。好了飞书这边的“户口”和“钥匙”我们已经拿到了。接下来我们去星图服务器那边把“接线员”Clawdbot准备好。3. 第二步配置Clawdbot安装飞书插件现在我们回到CSDN星图AI云平台的控制台打开你的服务器终端。假设你已经按照上篇教程部署好了Clawdbot基础服务。Clawdbot本身是一个框架要连接不同的平台如飞书、QQ需要安装对应的“插件”。我们需要安装飞书插件。在终端中输入以下命令clawdbot plugins install m1heng-clawd/feishu这个命令会从插件仓库拉取并安装飞书专用的连接器。看到安装成功的提示后我们就可以进行下一步把刚才从飞书拿到的“钥匙”交给Clawdbot。输入以下命令开始添加通信渠道clawdbot channels add这是一个交互式命令。执行后系统会引导你进行配置首先会让你选择渠道类型使用上下箭头选择feishu飞书。然后会依次提示你输入App ID和App Secret。把上一步保存的两个值分别粘贴进去。后续可能还有一些可选配置如机器人名称等可以根据提示填写或直接按回车使用默认值。配置完成后Clawdbot就记住了如何连接你的飞书应用。为了让这个新配置生效我们需要重启一下Clawdbot的网关服务。在终端中输入clawdbot gateway这个命令会启动或重启网关。看到服务成功运行、没有报错信息的日志就说明Clawdbot这边已经准备就绪正在等待飞书那边的连接。4. 第三步联动配置打通飞书与机器人的通信现在我们手里有两样东西飞书应用的“身份”和已经配置好“身份”并启动的Clawdbot服务。最后一步就是让飞书官方认可这个连接并开放通信权限。4.1 建立长连接WebSocket再次回到飞书开放平台的应用管理后台在左侧找到“事件订阅”页面。这里有一个关键选择连接方式。飞书提供了两种方式让你的服务器接收事件比如用户发来的消息HTTP回调需要你有一个公网可访问的URL地址。长连接WebSocket由你的服务主动与飞书服务器建立持久连接。对于我们部署在云服务器上的场景强烈推荐使用“长连接”模式。它的最大好处是你不需要拥有一个固定的公网IP或者去配置复杂的内网穿透Clawdbot会主动去连接飞书通信更稳定便捷。在事件订阅页面选择“长连接”模式。通常Clawdbot服务启动后如果App ID和App Secret配置正确这里可能会自动显示“已连接”。如果提示“未建立长链接”请返回终端检查clawdbot gateway命令是否在运行以及密钥是否填写无误。4.2 订阅消息事件光有连接还不够我们需要告诉飞书“当用户给我的应用发消息时请把这个事件通知给我。”在“事件订阅”页面点击“添加事件”。在事件列表中你需要找到并订阅与消息相关的事件。核心是im.message.receive_v1接收用户消息事件确保它被勾选上。这样当用户在飞书里你的机器人或发送消息时飞书才会把这个消息事件推送给Clawdbot。4.3 开通消息权限订阅了事件相当于“我要听”。但要想“能回复”还需要开通对应的API权限。切换到“权限管理”页面。在这里你需要为你的应用申请两个关键权限获取用户基本信息例如contact:user.base:readonly用于识别是谁发送了消息。接收与发送消息例如im:message下的相关权限这是机器人工作的核心没有它机器人既收不到消息也无法回复。找到这些权限勾选并申请开通。权限开通后非常重要的一步是你需要到“应用发布”页面将刚才的权限变更发布到一个新版本中比如从1.0.0升级到1.0.1。只有发布后新的权限配置才会对所有用户生效。至此所有配置工作全部完成飞书和你的私有化模型之间已经架起了一座畅通的桥梁。5. 最终验证与你的AI助手对话激动人心的时刻到了让我们来测试一下成果。打开你的飞书手机App或电脑客户端进入“工作台”。你应该能在工作台列表里找到你刚刚创建并发布的应用比如“AI小助手”。点击进入应用就像打开一个普通的聊天窗口一样尝试给它发送一条消息。你可以发文字比如“你好介绍一下你自己”更酷的是得益于Qwen3-VL的多模态能力你甚至可以发送一张图片然后问它“图片里有什么”或者“描述一下这张图”。发送消息后请切换回CSDN星图AI平台的控制台。你应该能看到终端里Clawdbot的日志在快速滚动显示它收到了消息正在调用模型并返回了结果。同时在飞书聊天窗口里稍等片刻你就会收到来自你的私有化Qwen3-VL模型的回复你可以观察星图平台提供的资源监控当模型工作时GPU的显存占用会有明显的波动这直观地证明了你的私有化大模型正在云端为你服务。6. 总结恭喜你走到这里你已经成功打造了一个完全私有化、集成在飞书里的多模态AI助手。让我们简单回顾一下这个过程的精妙之处数据安全所有对话和图片处理都在你掌控的星图云服务器内完成业务数据不出私域满足了企业对数据安全的严格要求。能力强大背后的Qwen3-VL:30B模型具备出色的图文理解和生成能力不再是简单的聊天机器人而是能处理文档、分析图表、理解图像的智能伙伴。开箱即用通过Clawdbot这样的标准化网关工具我们将复杂的机器人开发、通信协议维护等工作极大简化让你能专注于应用场景本身。无缝集成最终产品直接嵌入飞书这样日活极高的办公协同平台员工无需切换应用即可享受AI提效落地路径非常平滑。从在星图平台一键部署算力底座到通过Clawdbot连接飞书我们完成的是一个完整的、可复用的企业级AI应用链路。你可以基于这个基础继续探索更多可能为机器人添加专业领域知识库、定制工作流、连接企业内部系统等等。希望这篇教程能为你打开一扇门让你看到将前沿AI能力以低成本、高安全的方式融入日常工作的巨大潜力。动手试试吧你的专属智能助手正在飞书里等你。获取更多AI镜像想探索更多AI镜像和应用场景访问 CSDN星图镜像广场提供丰富的预置镜像覆盖大模型推理、图像生成、视频生成、模型微调等多个领域支持一键部署。