保姆级教程：星图平台快速搭建Clawdbot接入飞书机器人

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

1. 准备工作与环境确认

在开始接入飞书之前，我们先快速回顾一下当前环境状态，确保一切准备就绪。

1.1 环境检查清单

请确认你的星图云服务器已经具备以下条件：

• Qwen3-VL:30B 模型已部署完成（上篇内容）
• Clawdbot 网关服务正常运行
• 网络连接正常，能够访问外网
• 拥有飞书企业账号（个人账号也可，但企业账号功能更完整）

1.2 首次登录重要提示

首次进入需要填写 CSDN 到网关 token，在 Config 页面添加配置自己的飞书 AppId & AppSecret 即可进入到当前平台。

硬件环境概览

GPU 驱动	CUDA 版本	显存	CPU	内存	系统盘	数据盘
550.90.07	12.4	48GB	20 核心	240GB	50GB	40GB

2. 飞书开放平台：创建企业自建应用

2.1 初始化应用配置

首先打开浏览器，访问 飞书开放平台 开发者后台。

• 点击页面上的 "创建企业自建应用" 按钮

• 填写 应用名称（例如：Clawd助教）和 应用描述
• 上传一个清晰的应用图标（建议尺寸：256x256像素）

实用提示：应用名称和图标会直接显示在飞书工作台及聊天界面中，建议选择一个有辨识度的图标，方便用户快速找到你的机器人。

2.2 开启机器人能力

在应用管理页面的左侧导航栏中，选择 "添加应用能力"，然后点击添加 "机器人" 功能。

2.3 创建基础版本并获取凭证

为了后续进行配置，我们需要先创建一个基础版本。

注意：部分配置依赖于版本的初始化，建议此时先提交一个 1.0.0 的初始版本。

获取关键凭证信息

在 "凭证与基础信息" 页面，找到并保存你的 App ID 和 App Secret，这两个信息稍后需要配置到 Clawdbot 中。

请务必妥善保管这些凭证，建议使用密码管理器保存。

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

3.1 安装飞书专用插件

回到星图云服务器的终端界面，使用以下命令一键安装飞书连接器插件。

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

安装过程会自动下载所需的依赖包，通常需要1-2分钟完成。

扩展知识：如果需要了解 QQ 机器人接入方法，可以参考 Clawdbot QQ机器人接入实战-CSDN。

3.2 添加飞书通信渠道配置

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

# 添加通信渠道
clawdbot channels add

按照提示信息，依次输入之前在飞书后台获取的 App ID 和 App Secret。

配置完成后，系统会显示确认信息，表示飞书渠道已成功添加。

4. 联动配置：飞书机器人事件与权限

在正式开始通信前，需要重启 Clawdbot 网关服务，确保新的配置生效。

# 重启网关服务
clawdbot gateway

重启过程通常需要10-20秒，请耐心等待服务重新启动。

4.1 建立长连接回调机制

在飞书后台的 "事件订阅" 页面，推荐选择 "长连接（WebSocket）" 模式，这种模式不需要公网固定 IP 地址就能实现双向通信。

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

4.2 添加并配置订阅事件

点击 "添加事件"，订阅以下核心事件，这样机器人才能正常接收和响应消息。

根据需要选择相应的事件类型，确保覆盖基本的消息收发功能。

4.3 开通必要权限配置

事件添加完成后，必须在 "权限管理" 页面勾选对应的权限范围，否则机器人无法获取回复消息所需的数据。

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

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

发布完成后，可以在版本管理中查看发布状态。

5. 最终验证：端到端消息推送测试

5.1 飞书端发起对话测试

打开手机或电脑端的飞书应用，进入 【工作台】 → 搜索并进入你刚创建的应用（例如 Clawbot 助手）。尝试发送一条测试消息。

可以尝试发送不同类型的消息：

• 文本消息："你好，你是谁？"
• 图片消息：上传一张图片询问相关内容
• 文件消息：发送文档请求摘要

5.2 算力平台实时反馈验证

通过星图 AI 控制台，我们可以观察到以下关键指标：

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

如果一切正常，你应该能在几秒内收到机器人的回复，这表示整个链路已经成功打通。

6. 总结

通过上下两篇的实战教程，我们成功在 CSDN 星图 AI 云平台 上构建了一套完整的AI应用链路：

• 底层算力：私有化部署的 Qwen3-VL:30B 多模态大模型
• 中层网关：Clawdbot Agent 网关服务
• 顶层接入：飞书平台深度集成

这套方案不仅保证了数据的安全性隐私性，更重要的是通过飞书的深度集成大幅提升了办公效率和用户体验。你现在拥有了一个能够理解图像、文本、视频的智能助手，可以直接在飞书中进行多模态交互。

关键优势总结：

• 🛡 数据安全：所有数据处理在私有环境中完成
• ⚡ 高效集成：与飞书办公场景无缝结合
• 智能交互：支持文本、图像、视频多模态理解
• 💰 成本可控：按需使用，资源利用率高

接下来你可以进一步探索：

• 定制化训练模型以适应特定业务场景
• 扩展更多消息类型支持（视频、语音等）
• 集成企业知识库提升问答准确性
• 设置自动化工作流触发条件

感谢您花费宝贵的时间阅读本教程，希望这套方案能为您的 AI 应用开发带来实质性的帮助和启发！

---

获取更多AI镜像

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