一步步来：在星图平台完成Qwen3-VL与飞书的联动配置

一步步来在星图平台完成Qwen3-VL与飞书的联动配置作者注在上篇中我们完成了Qwen3-VL:30B在CSDN 星图 AI云平台的私有化部署。本篇将聚焦于如何通过Clawdbot将该算力底座正式接入飞书Lark打造专属的企业级多模态智能助手。如果你已经按照上篇教程在星图平台成功部署了强大的Qwen3-VL多模态模型那么恭喜你最核心的“大脑”已经就位。接下来我们要为这个大脑安装一个“嘴巴”和“耳朵”让它能听懂飞书里的消息并给出智能回复。这个过程就是通过Clawdbot这个智能网关将模型能力与飞书办公平台无缝连接。整个过程听起来复杂但别担心我会带你一步步拆解就像搭积木一样简单。你不需要是专业的开发人员只要跟着步骤操作就能拥有一个属于自己或团队的AI助手。1. 准备工作理清思路与获取凭证在开始动手之前我们先花一分钟理清整个流程的逻辑这能帮你更好地理解每一步在做什么。1.1 整体流程概览你可以把整个过程想象成在两个平台之间架设一座通信桥梁飞书侧应用端我们在飞书开放平台创建一个“机器人应用”并拿到它的“身份证”App ID和“钥匙”App Secret。星图侧服务端我们在已经部署好Qwen3-VL和Clawdbot的星图服务器上安装一个“飞书插件”并用刚才拿到的“身份证”和“钥匙”进行配置。建立连接告诉飞书机器人“以后有消息就通过长连接发送给星图服务器上的这个地址。”授权与测试给机器人开通必要的权限比如读取消息、发送消息然后进行对话测试。整个链路就是飞书用户发送消息 → 飞书平台将消息推送给我们的机器人应用 → 机器人通过长连接将消息转发到星图服务器的Clawdbot → Clawdbot调用本地的Qwen3-VL模型进行推理 → 生成的回复沿原路返回给飞书用户。1.2 在飞书开放平台创建应用这是第一步也是获取关键凭证的地方。登录平台打开浏览器访问 飞书开放平台使用你的飞书账号登录。创建应用在开发者后台点击页面上的“创建企业自建应用”按钮。填写信息应用名称给你的机器人起个名字比如“AI小助手”、“智能客服”等。这个名字会显示在飞书的工作台和聊天界面。应用描述简单写一下这个机器人的用途比如“基于Qwen3-VL的多模态智能问答助手”。应用图标上传一个头像让它在飞书里看起来更醒目。开启机器人能力创建成功后进入应用管理页面。在左侧菜单找到“添加应用能力”点击并添加“机器人”能力。这相当于给你的应用赋予了接收和发送消息的“超能力”。创建版本与获取凭证为了进行后续配置我们需要先创建一个初始版本。在左侧菜单进入“版本管理与发布”点击“创建版本”版本号可以填1.0.0描述写“初始测试版本”然后保存。找到关键信息保存版本后回到“凭证与基础信息”页面。在这里你会看到两个最重要的信息App ID和App Secret。把它们复制下来妥善保存下一步配置Clawdbot时会用到。它们就像是机器人的账号和密码。好了飞书这边的“身份证”和“钥匙”我们已经拿到了。接下来我们回到星图服务器的终端开始配置桥梁的另一端。2. 配置桥梁在Clawdbot中安装飞书插件现在我们切换到星图AI云平台的控制台通过Web终端连接到你的服务器实例。2.1 安装飞书连接器插件Clawdbot的强大之处在于其插件化架构。要连接飞书我们只需要安装对应的官方插件即可。在终端中执行以下命令# 安装飞书专用插件 clawdbot plugins install m1heng-clawd/feishu命令执行后你会看到插件开始下载和安装的进度提示。安装过程通常很快完成后会显示成功信息。2.2 添加飞书通信渠道插件安装好后我们需要告诉Clawdbot如何连接到我们刚刚在飞书创建的那个应用。这通过添加一个“渠道Channel”配置来完成。在终端中运行交互式配置命令# 启动添加渠道的向导 clawdbot channels add运行命令后系统会以交互式问答的方式引导你完成配置首先它会列出可用的渠道类型选择feishu飞书。接着会提示你输入这个渠道的标识名可以简单输入feishu或lark。然后最关键的一步来了它会要求你输入App ID和App Secret。把上一步从飞书后台复制的内容粘贴进去即可。后续还有一些可选配置比如加密密钥、事件订阅地址等对于初次配置我们可以直接按回车使用默认值或留空。配置完成后Clawdbot会生成一个用于飞书事件订阅的URL通常以wss://开头。请记下这个URL下一步在飞书后台配置时会用到。重要提示为了让新的配置生效我们需要重启Clawdbot的网关服务。在终端中运行# 重启网关服务加载新配置 clawdbot gateway服务重启后桥梁的星图端就配置好了。接下来我们需要在飞书端完成最后的接线工作。3. 完成接线配置飞书事件与权限桥梁两端都准备好了现在要把它们连接起来并确保机器人有权限工作。3.1 配置事件订阅建立长连接长连接WebSocket是一种高效的通信方式它允许飞书和我们的服务器保持一个持续的、双向的通信通道无需公网IP非常适合云服务器环境。回到飞书开放平台进入你创建的应用管理页面。在左侧菜单找到“事件订阅”。在“请求地址配置”部分你会看到“长连接”选项。点击进入长连接配置。将上一步Clawdbot生成的那个wss://开头的URL填写到“长连接地址”栏中。点击“保存”。如果点击保存时提示“未建立长链接”别慌这通常是因为Clawdbot网关服务没有在运行或者刚才填写的URL有误。请回到星图终端确认clawdbot gateway命令正在运行并且终端没有报错信息。确认无误后再回到飞书后台点击保存。3.2 订阅机器人所需事件光有连接还不够我们还需要告诉飞书“当用户给机器人发消息时请把这个‘消息事件’通知给我们。”在“事件订阅”页面找到“添加事件”按钮。在事件列表中找到与消息相关的核心事件。对于基础的收发消息功能通常需要订阅im.message.receive_v1接收消息事件可能还包括im.message.message_read_v1消息已读事件等根据你的需求选择。勾选所需的事件并保存。3.3 开通机器人操作权限订阅了事件相当于机器人“听到了”消息。但要“回复”消息还需要获得相应的操作权限。在左侧菜单进入“权限管理”页面。在权限列表中找到并勾选机器人运行所必须的权限。至少需要以下两项权限名称权限Scope作用说明获取用户基本信息contact:user.base:readonly让机器人知道是谁发送的消息以便个性化回复。接收与发送消息im:message(需勾选其下的子权限如send,receive等)这是核心功能允许机器人读取用户消息并发送回复。勾选后点击“批量开通”或类似按钮。3.4 发布新版本使配置生效在飞书开放平台对应用配置如权限、事件的修改需要发布一个新的版本才能生效。再次进入“版本管理与发布”。基于刚才的1.0.0版本创建一个新版本例如1.0.1版本描述可以写“开通消息权限”。提交审核企业自建应用通常为自动通过或免审。审核通过后记得点击“发布”。只有发布后你的企业成员才能在飞书工作台看到并使用这个应用。至此所有的配置工作全部完成一座连接私有化大模型与飞书办公平台的智能桥梁已经正式通车。4. 最终验证开启你的第一次AI对话最激动人心的时刻到了让我们来测试一下整个链路是否畅通。4.1 在飞书中找到你的机器人打开你的飞书手机App或电脑客户端均可。点击底部的“工作台”。在工作台的应用列表中找到你刚刚创建并发布的应用例如“AI小助手”。如果没找到可以在搜索框输入应用名称查找。点击进入应用。这里通常是一个简单的聊天界面。4.2 发起对话并观察响应在聊天框中尝试发送一条消息。可以是简单的问候比如“你好”也可以是一个问题比如“介绍一下你自己”。发送后请耐心等待几秒钟。第一次调用模型时需要加载权重到显存可能会稍慢一些。与此同时打开星图AI平台的控制台观察GPU监控在实例的监控面板或通过nvidia-smi命令你会看到GPU显存占用率显著上升这表明本地的Qwen3-VL模型已经被成功调用正在辛勤工作。查看Clawdbot日志在运行clawdbot gateway的终端里你会看到实时的日志滚动显示收到了飞书的消息、正在调用模型、以及发送回复的完整过程。如果一切顺利你将在飞书聊天界面中收到来自Qwen3-VL模型的回复。恭喜你一个部署在私有环境、完全受你控制、并深度集成到飞书办公场景的企业级多模态AI助手已经正式上线运行了5. 总结与展望通过上下两篇教程我们完成了一个从底层算力到顶层应用的完整实践算力层在CSDN星图AI云平台利用其强大的GPU资源一键私有化部署了顶尖的多模态大模型Qwen3-VL:30B。网关层安装并配置了Clawdbot这一轻量、高效的AI Agent框架作为连接模型与应用的智能中间件。应用层将Clawdbot与飞书平台深度集成让模型能力以“机器人”的形式无缝嵌入到最常用的办公协作流程中。这套方案的价值在于数据安全所有对话和推理过程均在私有环境中完成敏感业务数据不出域。成本可控按需使用云上GPU算力无需前期巨额硬件投入。开箱即用星图平台的预置镜像和Clawdbot的插件化设计极大降低了集成复杂度。场景灵活不仅限于飞书基于Clawdbot的架构可以相对容易地扩展接入微信、钉钉、Slack等其他平台。你的AI助手现在已经就绪。你可以尝试给它发送图片测试其强大的视觉理解能力也可以进行多轮复杂对话探索其推理逻辑。接下来你可以基于这个基础进行更深度的定制例如为机器人设计特定的技能Skill和知识库。设置不同的对话场景和响应逻辑。将其接入群聊作为团队的智能知识库助手。希望本教程能为你打开一扇门让你能更轻松地将前沿的AI能力转化为实际的生产力工具。获取更多AI镜像想探索更多AI镜像和应用场景访问 CSDN星图镜像广场提供丰富的预置镜像覆盖大模型推理、图像生成、视频生成、模型微调等多个领域支持一键部署。