零基础教程：星图平台快速搭建企业级AI助手（飞书版）

作者注：本教程是系列教程的下篇，专注于将已部署的Qwen3-VL模型接入飞书平台。如果你还没有完成模型部署，请先参考上篇内容完成私有化部署。

1. 教程概述与准备工作

1.1 你将学到什么

通过本教程，你将掌握如何将星图平台上部署的Qwen3-VL大模型与飞书平台无缝对接，打造一个真正可用的企业级AI助手。具体包括：

• 如何在飞书开放平台创建自建应用
• 如何配置Clawdbot与飞书的连接通道
• 如何设置必要的权限和事件订阅
• 如何进行端到端的测试验证

1.2 所需准备

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

• 已完成上篇内容：在星图平台成功部署Qwen3-VL:30B模型
• 飞书企业账号：拥有飞书管理员权限或创建应用的权限
• 基础命令行操作：能够使用基本的Linux命令

1.3 预期效果

完成本教程后，你将获得：

1. 一个专属的飞书AI助手应用
2. 能够通过飞书与你的私有化大模型对话
3. 完整的消息收发和响应能力
4. 符合企业级安全要求的数据流

2. 飞书应用创建与配置

2.1 创建企业自建应用

首先访问飞书开放平台，使用你的企业账号登录。

在开发者后台，点击"创建企业自建应用"，这是搭建AI助手的第一步：

填写应用基本信息时，请注意：

• 应用名称：建议使用清晰易识别的名称，如"AI智能助手"
• 应用描述：简要说明应用功能，让用户一目了然
• 应用图标：上传一个专业的图标，提升用户体验

2.2 开启机器人能力

创建应用后，在左侧导航栏找到"添加应用能力"，选择"机器人"功能：

这个步骤很关键，它让你的应用具备了接收和发送消息的能力。

2.3 获取关键凭证信息

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

• App ID：应用的唯一标识符
• App Secret：用于身份验证的安全密钥

重要提示：这些凭证信息后续需要配置到Clawdbot中，请妥善保管。

2.4 创建基础版本

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

1. 进入"版本管理与发布"页面
2. 点击"创建版本"，版本号可以填写1.0.0
3. 填写简单的版本描述
4. 提交版本申请

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

3.1 安装飞书专用插件

回到星图平台的服务器终端，执行以下命令安装飞书插件：

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

安装过程通常很快，看到成功提示后即可进行下一步。

3.2 配置飞书通信渠道

接下来需要添加飞书通信渠道，将刚才获取的凭证信息配置到Clawdbot中：

# 添加通信渠道
clawdbot channels add

按照提示依次输入：

• 渠道类型选择"飞书"
• 输入App ID
• 输入App Secret
• 其他配置保持默认即可

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

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

4.1 重启Clawdbot网关

在继续配置之前，需要重启Clawdbot服务以确保新配置生效：

# 重启网关服务
clawdbot gateway

等待服务重新启动完成，确认没有错误信息输出。

4.2 配置长连接回调

回到飞书开放平台，进入"事件订阅"页面：

1. 选择"长连接（WebSocket）"模式
2. 系统会自动检测连接状态
3. 确保显示"长连接已建立"

常见问题：如果提示"未建立长链接"，请检查：

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

4.3 添加必要的事件订阅

点击"添加事件"，订阅以下核心事件：

• 接收消息：im.message.receive_v1
• 消息已读：im.message.message_read_v1

这些事件让你的机器人能够接收用户消息并做出响应。

4.4 开通必要权限

事件订阅后，还需要在"权限管理"页面开通相应权限：

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

开通权限后，记得重新发布一个新版本，使配置生效。

5. 端到端测试与验证

5.1 在飞书中测试对话

现在进入最令人兴奋的测试环节：

1. 打开飞书APP或PC端
2. 进入"工作台"
3. 找到你创建的应用
4. 尝试发送一条消息

5.2 观察后端响应

在星图平台的控制台，你可以实时观察到：

1. 模型调用：Qwen3-VL模型被成功触发，GPU显存占用上升
2. 日志同步：Clawdbot日志显示消息处理流程
3. 响应时间：通常几秒内就能收到回复

5.3 常见问题排查

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

1. 凭证配置：确认App ID和App Secret是否正确
2. 服务状态：检查Clawdbot服务是否正常运行
3. 网络连接：确认网络通畅，没有防火墙阻挡
4. 权限配置：确认所有必要权限都已开通

6. 总结与下一步建议

通过本教程，你已经成功将星图平台上的Qwen3-VL大模型接入飞书，打造了一个完整的企业级AI助手。这个方案具有以下优势：

• 数据安全：所有数据处理都在私有化环境中完成
• 高效集成：飞书作为入口，用户体验无缝衔接
• 强大能力：基于Qwen3-VL的多模态理解能力
• 易于扩展：可以在此基础上添加更多功能

6.1 进一步优化建议

为了让你的AI助手更加强大，可以考虑：

1. 定制化训练：使用企业特定数据对模型进行微调
2. 多场景适配：针对不同部门需求定制不同的对话能力
3. 性能优化：根据使用情况调整资源配置
4. 监控告警：设置使用情况监控和异常告警

6.2 扩展应用场景

这个基础架构可以扩展到更多应用场景：

• 智能客服：自动回答常见问题
• 知识查询：快速检索企业知识库
• 会议助手：自动生成会议纪要
• 文档处理：智能解析和总结文档内容

现在你已经掌握了构建企业级AI助手的完整流程，接下来就是发挥创意，打造适合自己企业需求的智能应用了。

---

获取更多AI镜像

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