从部署到落地：Qwen3-VL私有化接入飞书的完整指南

1. 项目概述与准备工作

1.1 你能实现什么

本指南将带你完成企业级多模态AI助手的完整搭建过程。通过本文，你将掌握：

• 如何在飞书开放平台创建自建应用并配置机器人能力
• 如何使用Clawdbot连接私有化部署的Qwen3-VL模型
• 如何配置飞书事件订阅和权限管理
• 如何进行端到端的消息推送测试和验证

最终，你将拥有一个完全私有化的企业智能助手，能够通过飞书接收和回复消息，同时调用本地的Qwen3-VL模型进行多模态处理。

1.2 环境准备

在开始之前，请确保你已经完成以下准备：

• 已完成上篇内容：在CSDN星图AI云平台成功部署Qwen3-VL:30B模型
• 飞书企业账号：拥有飞书开放平台的管理员权限
• 网络环境：确保服务器可以正常访问飞书开放平台API
• 基础工具：熟悉基本的命令行操作和Web配置界面

重要提示：首次进入Clawdbot需要填写CSDN网关token，在Config页面添加配置自己的飞书AppId和AppSecret即可进入平台。

2. 飞书应用创建与配置

2.1 创建企业自建应用

首先访问飞书开放平台并登录开发者后台：

1. 点击"创建企业自建应用"
2. 填写应用名称（如：Clawd助教）和应用描述
3. 上传应用图标（建议使用有辨识度的图标）

提示：应用名称和图标将直接显示在飞书工作台和聊天界面中，建议认真设计。

2.2 开启机器人能力

在应用管理页面的左侧导航栏中：

1. 选择"添加应用能力"
2. 点击并添加"机器人"能力

2.3 获取凭证信息

为了后续配置，需要先创建一个基础版本：

1. 在版本管理中选择"创建版本"
2. 提交一个1.0.0的初始版本

在"凭证与基础信息"页面，找到并保存你的App ID和App Secret，这些信息将在Clawdbot配置中使用。

3. Clawdbot飞书插件安装与配置

3.1 安装飞书插件

回到CSDN星图云服务器的终端，使用以下命令安装飞书连接器插件：

# 安装飞书专用插件
clawdbot plugins install @m1heng-clawd/feishu

3.2 配置飞书通信渠道

通过交互式命令行将飞书应用凭证绑定到Clawdbot：

# 添加通信渠道
clawdbot channels add

根据提示输入之前在飞书后台获取的App ID和App Secret：

配置完成后，需要重启Clawdbot网关服务以确保配置生效：

# 重启网关服务
clawdbot gateway

4. 飞书事件订阅与权限配置

4.1 配置长连接回调

在飞书后台的"事件订阅"页面，选择"长连接（WebSocket）"模式：

1. 这种模式不需要公网固定IP即可实现双向通信
2. 确保Clawdbot正在运行且密钥填写正确

注意：如果点击保存时提示"未建立长链接"，请检查终端中的Clawdbot是否正在运行且密钥填写正确。

4.2 添加事件订阅

点击"添加事件"，订阅以下核心事件以允许机器人接收消息：

• im.message.receive_v1（接收消息事件）
• 其他相关事件根据实际需求添加

4.3 开通必要权限

在"权限管理"页面勾选以下必要权限：

权限名称	权限范围	说明
获取基础用户信息	contact:user.base:readonly	识别发送者身份
接收与发送消息	im:message（所有子项）	实现对话核心功能

开通权限后，需要在"应用发布"中重新发布一个新版本，配置才会正式生效。

5. 端到端测试与验证

5.1 飞书端发起对话

打开手机或PC端飞书，进行以下操作：

1. 进入"工作台"
2. 搜索并进入你创建的应用（如Clawbot助手）
3. 尝试发送一条测试消息

5.2 平台端验证响应

通过CSDN星图AI控制台，可以观察到以下现象：

1. 模型调用：私有化部署的Qwen3-VL模型被成功触发，GPU显存占用率动态上升
2. 日志同步：服务器终端的Clawdbot日志与飞书助手中的消息流完全同步

5.3 常见问题排查

如果遇到问题，可以检查以下几个方面：

1. 凭证配置：确认App ID和App Secret是否正确填写
2. 服务状态：检查Clawdbot网关是否正常运行
3. 网络连接：确认服务器可以访问飞书API
4. 权限配置：检查所有必要权限是否都已开通

6. 总结

6.1 项目成果回顾

通过本指南，我们成功构建了一个完整的企业级多模态智能助手系统：

• 底层算力：基于CSDN星图AI云平台的Qwen3-VL:30B私有化部署
• 中层网关：使用Clawdbot作为Agent网关处理消息路由和转换
• 顶层应用：通过飞书平台提供最终用户交互界面

这种架构不仅保证了数据的安全性，还通过飞书的深度集成大幅提升了办公效率。

6.2 进一步优化建议

如果你希望进一步优化这个系统：

1. 性能优化：根据实际使用情况调整模型参数和资源配置
2. 功能扩展：添加更多的多模态处理能力，如图片理解、文档分析等
3. 用户体验：优化飞书界面的交互设计和响应速度
4. 监控告警：添加系统监控和异常告警机制

---

获取更多AI镜像

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