快速上手：用Clawdbot将Qwen3-VL接入飞书工作台

作者注：在[上篇]中，我们完成了 Qwen3-VL:30B 在 CSDN 星图 AI 云平台的私有化部署。本篇将聚焦于如何通过 Clawdbot 将该算力底座正式接入飞书（Lark），打造专属的企业级多模态智能助手。

1. 准备工作与环境确认

1.1 环境要求检查

在开始接入飞书之前，请确保你已经完成以下准备工作：

• Qwen3-VL:30B 模型已部署：在CSDN星图AI平台完成模型部署，能够正常进行推理
• Clawdbot 网关服务正常：确保Clawdbot服务正在运行且可访问
• 飞书企业账号：拥有飞书开放平台的管理员或开发者权限
• 网络连通性：确保服务器能够正常访问外网（用于飞书API调用）

1.2 首次配置注意事项

重要提示：首次使用需要在Clawdbot的Config页面完成以下配置：

1. 填写CSDN到网关的token信息
2. 添加自己的飞书App ID和App Secret
3. 保存配置后重启服务使配置生效

2. 飞书应用创建与配置

2.1 创建企业自建应用

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

# 登录飞书开放平台后，按以下步骤操作：
1. 点击"创建企业自建应用"
2. 填写应用名称（如：智能视觉助手）
3. 上传应用图标（建议使用清晰易识别的logo）
4. 填写应用描述，说明主要功能

2.2 开启机器人能力

在应用管理页面中，需要为应用添加机器人能力：

1. 在左侧导航栏选择"添加应用能力"
2. 点击"机器人"选项并启用
3. 创建基础版本（建议版本号1.0.0）

2.3 获取关键凭证信息

在"凭证与基础信息"页面，找到并保存以下重要信息：

• App ID：应用的唯一标识符
• App Secret：用于API调用的密钥

这些凭证将在后续的Clawdbot配置中使用，请妥善保管。

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

3.1 安装飞书插件

通过SSH连接到CSDN星图云服务器，执行以下命令安装飞书插件：

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

安装过程通常需要1-2分钟，完成后会显示安装成功提示。

3.2 配置飞书通信渠道

使用交互式命令添加飞书通信渠道：

# 启动渠道配置向导
clawdbot channels add

按照提示输入之前获取的飞书App ID和App Secret：

? 请选择渠道类型: feishu
? 请输入飞书App ID: your_app_id_here
? 请输入飞书App Secret: your_app_secret_here

配置完成后，系统会显示配置成功信息。

3.3 重启网关服务

为了使配置生效，需要重启Clawdbot网关服务：

# 重启网关服务
clawdbot gateway

等待服务重新启动，确认没有错误日志输出。

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

4.1 配置长连接回调

在飞书开放平台的事件订阅页面，进行以下配置：

1. 选择"长连接（WebSocket）"模式
2. 系统会自动检测并建立连接
3. 确保Clawdbot服务正常运行，否则会出现连接失败提示

注意：如果提示"未建立长链接"，请检查：

• Clawdbot服务是否正常运行
• App ID和App Secret是否正确
• 网络连接是否正常

4.2 添加必要的事件订阅

为了让机器人能够接收和处理消息，需要订阅以下核心事件：

• 接收消息v2：允许机器人接收用户发送的消息
• 消息已读事件：跟踪消息阅读状态
• 群聊消息：支持群组内的消息交互

点击"添加事件"，选择相应的事件类型并保存配置。

4.3 开通API权限

在权限管理页面，需要开通以下必要权限：

权限名称	权限范围	功能说明
获取用户基本信息	contact:user.base:readonly	识别发送者身份
接收消息	im:message:receive_v2	接收用户消息
发送消息	im:message:send	向用户回复消息
获取群组信息	im:chat:readonly	识别群组上下文

勾选所需权限后，点击"申请权限"并重新发布应用版本。

5. 端到端测试与验证

5.1 飞书工作台测试

完成所有配置后，在飞书客户端中进行测试：

1. 打开飞书移动端或PC端
2. 进入"工作台"，找到你创建的应用
3. 点击进入应用界面
4. 发送测试消息，如图片或文字

5.2 服务器端监控

在CSDN星图AI控制台，可以实时监控以下信息：

• GPU使用情况：观察Qwen3-VL模型是否被正确调用
• 显存占用：确认模型推理过程中的资源使用情况
• 请求日志：查看Clawdbot的消息处理日志
• 响应时间：监控从接收到响应的整体延迟

5.3 多模态能力测试

测试Qwen3-VL模型的多模态能力：

1. 图片识别：发送商品图片，测试识别准确性
2. 文字问答：询问图片中的具体内容
3. 复杂推理：测试模型的多步推理能力
4. 响应速度：评估整体系统的响应时间

示例测试结果可能包括：

• 图片中物体的准确识别
• 文字内容的精确提取
• 上下文相关的智能回复
• 快速响应（通常在几秒内）

6. 常见问题与解决方案

6.1 连接相关问题

问题：长连接无法建立

• 解决方案：检查Clawdbot服务状态，确认凭证正确

问题：消息发送失败

• 解决方案：检查权限配置，重新发布应用版本

问题：模型未响应

• 解决方案：确认Qwen3-VL服务正常，检查GPU资源

6.2 性能优化建议

提升响应速度：

• 确保服务器网络状况良好
• 监控GPU使用情况，避免资源瓶颈
• 优化提示词设计，减少不必要的计算

提高识别准确率：

• 使用清晰的图片输入
• 设计明确的提示词指令
• 根据业务场景微调模型参数

6.3 运维监控建议

建立日常监控机制：

• 定期检查服务状态
• 监控GPU资源使用情况
• 日志记录和分析
• 用户反馈收集和处理

7. 总结

通过本教程，我们成功实现了将Qwen3-VL多模态大模型通过Clawdbot接入飞书工作台的完整流程。关键步骤包括：

1. 环境准备：确认模型部署和Clawdbot服务正常
2. 飞书应用创建：创建自建应用并获取凭证
3. 插件安装配置：安装飞书插件并配置通信渠道
4. 权限与事件配置：设置必要的事件订阅和API权限
5. 端到端测试：验证整个链路的正常工作

这套方案的优势在于：

• 数据安全：所有处理在私有化环境中完成
• 成本可控：基于CSDN星图平台，按需使用资源
• 易于集成：通过标准化接口快速对接飞书平台
• 功能强大：充分利用Qwen3-VL的多模态能力

现在你已经在飞书工作台中拥有了一个强大的多模态AI助手，可以处理图像识别、文字问答、智能推理等多种任务，大幅提升工作效率和智能化水平。

---

获取更多AI镜像

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