技术干货：Qwen3-VL在星图平台的飞书机器人实现

1.

你能实现什么

本文将手把手教你如何将强大的多模态大模型

Qwen3-VL

中间件接入飞书平台，打造企业级智能助手。

学完本教程，你将能够：

• 在星图AI云平台完成

  Qwen3-VL:30B

  模型的私有化部署（上篇内容）

• 创建飞书自建应用并配置机器人能力
• 使用

  Clawdbot

  搭建模型与飞书之间的通信桥梁

• 实现端到端的多模态对话功能（图文理解与生成）
• 构建安全可靠的企业级AI助手解决方案

1.2

为什么选择这个方案

这个技术方案有三大核心优势：

数据安全性：模型私有化部署，所有数据处理都在企业内部环境完成，避免数据外泄风险

成本效益：利用星图平台的弹性算力，按需使用GPU资源，相比自建GPU集群节省70%以上成本

易用性：Clawdbot

提供开箱即用的飞书插件，大大降低了集成复杂度，从部署到上线只需几小时

2.

创建企业自建应用

首先访问飞书开放平台，登录你的开发者账号。

点击"创建企业自建应用"，填写应用基本信息：

• 应用名称：建议使用有辨识度的名称，如"智能办公助手"
• 应用描述：简要说明应用功能，如"基于Qwen3-VL的多模态AI助手"
• 应用图标：上传一个清晰的logo，这将在飞书工作台中显示

创建完成后，记下系统生成的

App

开启机器人能力

在应用管理页面，找到"添加应用能力"选项，选择开启"机器人"功能。

这个步骤很关键，只有开启了机器人能力，你的应用才能接收和发送消息。

飞书提供了丰富的机器人权限配置，可以根据实际需求选择相应的消息接收和发送权限。

2.3

创建版本并获取凭证

为了确保所有配置生效，需要创建一个应用版本。

建议使用

1.0.0

作为初始版本号。

在"凭证与基础信息"页面，你可以找到：

• App

  ID：应用的唯一标识符

• App

  Secret：用于身份验证的密钥

这两个信息需要妥善保管，后续配置

Clawdbot

安装飞书专用插件

回到星图云服务器的终端界面，使用以下命令安装

Clawdbot

@m1heng-clawd/feishu

安装过程通常只需要几分钟，完成后你会看到成功的提示信息。

这个插件封装了与飞书平台通信的所有底层细节，让你无需关心复杂的API调用。

3.2

配置飞书通信渠道

接下来需要将飞书应用的凭证信息配置到

Clawdbot

就具备了与飞书平台建立连接的能力。

重要提示：确保输入的凭证信息准确无误，任何拼写错误都会导致连接失败。

3.3

重启网关服务

配置完成后，需要重启

Clawdbot

网关服务以使配置生效：

#
重启网关服务
gateway

重启过程中，系统会加载新的飞书插件配置，并尝试与飞书平台建立连接。

你可以在日志中看到连接状态信息。

4.

飞书平台深度配置

4.1

配置事件订阅

在飞书开放平台的应用管理页面，找到"事件订阅"选项。

这里推荐使用"长连接（WebSocket）"模式，这种模式不需要公网固定IP，能够实现双向实时通信。

关键配置项包括：

• 请求网址：填写

  Clawdbot

  提供的回调地址

• 加密密钥：用于消息加密验证
• 验证令牌：确保请求来源可信

4.2

添加必要的事件订阅

为了让机器人能够正常工作和响应用户消息，需要订阅以下核心事件：

• 接收消息：允许机器人接收用户发送的消息
• 发送消息：允许机器人向用户发送回复
• 消息已读：跟踪消息阅读状态
• 用户加入群聊：感知群组成员变化

每个事件都需要相应的权限支持，确保在权限管理页面已经开通了这些权限。

4.3

权限管理配置

在"权限管理"页面，需要为机器人开通以下必要权限：

开通权限后，记得重新发布应用版本，这样权限配置才会正式生效。

5.

端到端测试与验证

5.1

飞书端测试

打开飞书移动端或PC端，进入工作台找到你创建的应用。

尝试发送不同类型的消息进行测试：

文本消息测试：

发送：你好，请介绍一下你自己
预期：机器人应该能够回复自我介绍

图片消息测试：

发送：这是一张产品图片，请描述一下内容
预期：Qwen3-VL应该能够识别图片内容并给出描述

多轮对话测试：

连续发送多个相关问题，测试对话连贯性

5.2

星图平台监控

在飞书端测试的同时，观察星图AI云平台的控制台：

• GPU使用情况：当用户发送消息时，GPU显存占用应该有明显上升
• 模型推理时间：观察从接收到消息到生成回复的延迟
• 日志输出：Clawdbot

  的日志应该显示消息处理的全过程

5.3

常见问题排查

如果测试过程中遇到问题，可以按照以下步骤排查：

连接问题：

• 检查飞书凭证配置是否正确
• 确认网络连接正常
• 查看

  Clawdbot

  日志中的错误信息

权限问题：

• 确认所有必要权限都已开通
• 检查事件订阅配置是否正确

性能问题：

• 监控GPU显存使用情况
• 检查模型加载是否正常

6.

总结与最佳实践

6.1

方案优势总结

通过这个完整的实现方案，你获得了以下价值：

技术层面：

• 完整的私有化多模态AI解决方案
• 企业级的安全保障和数据隐私
• 可扩展的架构设计，支持后续功能扩展

业务层面：

• 大幅提升办公效率，智能助手随时待命
• 降低人力成本，自动化处理常规咨询
• 提升员工体验，提供7x24小时智能支持

6.2

生产环境建议

对于计划在生产环境部署的用户，建议注意以下几点：

性能优化：

• 根据实际使用量合理配置GPU资源
• 设置合理的超时时间和重试机制
• 实现负载均衡，支持多个机器人实例

监控告警：

• 设置关键指标监控（响应时间、成功率等）
• 配置异常告警，及时发现问题
• 定期检查系统日志，优化系统性能

用户体验：

• 提供清晰的使用指南和示例
• 收集用户反馈，持续优化功能
• 定期更新模型，提升智能水平

6.3

扩展可能性

这个基础框架还可以进一步扩展：

功能扩展：

• 集成更多外部工具和API
• 支持多模态输入输出（语音、视频等）
• 实现个性化学习和记忆功能

场景扩展：

• 客户服务自动化
• 内部知识问答系统
• 业务流程智能化助手