小白必看：如何用星图平台快速搭建飞书AI助手？-洪萨配资

小白必看：如何用星图平台快速搭建飞书AI助手？

你是不是也遇到过这样的场景？团队刚上线一个内部知识库系统，员工却总在群里反复问“XX流程怎么走”“合同模板在哪下”；客服同事每天要花3小时回复重复问题；新员工入职培训材料堆成山，但没人真去翻……这时候，一个能随时响应、懂文档、会看图、还能在飞书里直接对话的AI助手，就成了最实在的提效方案。

别被“私有化部署”“多模态大模型”这些词吓住。今天这篇教程，就是专为零基础用户写的——不需要你会写代码，不用配环境，不碰GPU驱动，甚至不用申请公网IP。只要你会登录飞书、会复制粘贴App ID，就能在1小时内，把Qwen3-VL:30B这个300亿参数的视觉语言大模型，变成你公司专属的飞书AI助手。

我们用的是CSDN星图AI云平台提供的预置镜像，它已经帮你把所有复杂环节打包好了：模型权重、推理框架、Agent网关、飞书插件全都在里面。你只需要做三件事：在飞书后台点几下创建应用、把两个密钥填进终端、重启一次服务。剩下的，全是它自己跑。

这篇文章不讲原理、不列公式、不谈架构。只说你打开电脑后，每一步该点哪里、输什么、等多久、看到什么才算成功。文末还有真实测试截图和常见卡点排查清单。准备好了吗？咱们现在就开始。

1. 先搞清楚：这个AI助手到底能帮你做什么？

在动手前，先明确一件事：你不是在搭一个玩具机器人，而是在部署一个能真正干活的办公伙伴。它不是只能回“你好”，而是能理解你发过去的截图、PDF、表格、会议照片，再结合你公司的制度文档、产品手册、FAQ知识库，给出准确回答。

我们来举几个你明天就能用上的例子：

你把一张报销单截图发给它，它能自动识别金额、日期、事由，并告诉你“这张单据缺少部门负责人签字，需补签后提交至财务部”；
新同事在飞书工作台里问“试用期转正流程是怎样的”，它会从你上传的《员工手册》PDF中精准定位条款，生成带步骤编号的指引；
产品经理发来一张Axure原型图，问“这个按钮点击后跳转逻辑对吗”，它能看懂界面元素，对照你提供的PRD文档给出反馈；
客服收到客户发来的故障设备照片，它能识别型号、判断常见问题，并推送对应的维修SOP视频链接。

这些能力，都来自背后那个叫Qwen3-VL:30B的大模型。它不像传统AI只能读文字，它真能“看图说话”——而且是300亿参数级别的专业级理解力。而Clawdbot，就是把它和飞书连起来的那根“智能神经”。

关键在于：整个过程数据不出你公司网络。模型运行在星图云平台的私有实例上，飞书消息通过加密通道传输，你的报销单、产品图、内部文档，全程不经过任何第三方服务器。

所以这不是一个调API的轻量方案，而是一套真正可控、可定制、可扩展的企业级AI助手底座。

2. 准备工作：三样东西，5分钟搞定

别担心要装软件、配环境。你只需要准备好以下三样东西，其他全部由星图镜像自动完成：

2.1 一个飞书企业账号（管理员权限）

必须是企业自建应用管理员，不是普通员工账号。如果你不确定，可以找IT同事确认，或者登录飞书管理后台看左下角是否有“开发者后台”入口。

检查方法：打开飞书开放平台 → 右上角头像 → 看是否显示“我的应用”或“企业应用管理”。如果只有“个人应用”，说明权限不够。

2.2 星图云平台已运行的Clawdbot实例

这一步已经在上篇完成。你只需确认：

登录 CSDN星图AI平台；
进入“我的实例”页面；
找到名为“Clawdbot-Qwen3-VL”或类似名称的实例；
状态显示为“运行中”。

如果状态是“已停止”，请先点击右侧“启动”按钮，等待1~2分钟直到状态变为绿色“运行中”。

2.3 30秒：记下这两个关键信息的位置

你马上就要用到它们，提前知道在哪找，能省下一半时间：

飞书App ID：在飞书开放平台 → 应用详情页 → “凭证与基础信息” → “App ID”
飞书App Secret：在同一页面，“App Secret”字段右侧有个“显示”按钮，点一下才看到

提示：App Secret只显示一次！看到后立刻复制保存到记事本，刷新页面就没了。

这三样齐了，就可以进入实操环节。整个过程不需要下载任何文件，不修改任何配置文件，所有操作都在网页和终端里完成。

3. 第一步：在飞书后台创建你的AI助手应用（10分钟）

这是唯一需要你在飞书网页端操作的步骤。全程点选+填写，没有技术门槛。

3.1 创建企业自建应用

打开飞书开放平台，用企业管理员账号登录；
点击右上角“创建应用” → 选择“创建企业自建应用”；
填写应用基本信息：
- 应用名称：建议起个好记的名字，比如“智汇助手”“Clawd小助”（后续会显示在飞书工作台）；
- 应用描述：简单写一句，如“公司内部AI知识助手”；
- 应用图标：上传一个方形PNG图标（推荐128×128像素），会让工作台更专业。

小技巧：图标不用自己画，用任意在线工具（如Canva）搜“AI icon”，选一个蓝色科技感的免费下载即可。

3.2 开启机器人能力

创建完应用后，页面会自动跳转到应用管理页。

左侧菜单栏找到“添加应用能力”；
在能力列表中，找到“机器人” → 点击右侧“添加”；
弹窗中勾选“接收消息”和“发送消息” → 点击“确定”。

注意：这里不要点“安装到企业”，先不做这步。等全部配置完再统一发布。

3.3 获取并保存凭证信息

现在是最关键的一步：拿到App ID和App Secret。

左侧菜单切换到“凭证与基础信息”；
找到“App ID”一栏，直接复制；
找到“App Secret”一栏，点击右侧“显示”按钮；
立刻复制弹出的密钥，粘贴到你的记事本里，标注“飞书AppSecret”；
关闭弹窗（不点“隐藏”，因为密钥已复制成功）。

再次强调：App Secret一旦关闭弹窗就再也看不到，重置后旧密钥立即失效。务必先复制再关！

此时，飞书端的基础配置已完成。你不需要记任何复杂的URL或Token，Clawdbot会自动处理所有通信协议。

4. 第二步：在星图终端配置飞书连接（5分钟）

这一步在星图云平台的终端里操作。你看到的是一串命令行，但其实只需要照着敲三行，每行按回车就行。

4.1 登录并进入Clawdbot实例

回到CSDN星图AI平台 → “我的实例” → 找到你的Clawdbot实例；
点击右侧“连接”按钮 → 选择“Web终端”；
等待终端加载完成（出现$符号），表示已连上。

终端里默认就是Clawdbot工作目录，无需cd切换路径。

4.2 一键安装飞书插件

在终端里，输入以下命令（注意空格和大小写）：

clawdbot plugins install @m1heng-clawd/feishu

按回车执行。你会看到类似这样的输出：

✔ Plugin @m1heng-clawd/feishu installed successfully → Installed to /root/.clawdbot/plugins/feishu

如果提示command not found，说明Clawdbot未正确初始化，请先运行clawdbot init再重试。

4.3 绑定飞书应用凭证

接下来，把刚才复制的App ID和App Secret填进去：

clawdbot channels add

按回车后，终端会依次提问：

Channel type?→ 输入feishu（飞书专用通道）
App ID?→ 粘贴你复制的App ID，回车
App Secret?→ 粘贴你复制的App Secret，回车
Channel name?→ 直接回车（使用默认名feishu）

完成后，你会看到：

✔ Channel feishu added successfully → Config saved to /root/.clawdbot/channels/feishu.json

此时，Clawdbot已经记住了你的飞书应用身份，就像你给它发了一张“飞书通行证”。

5. 第三步：飞书后台完成最后联动（8分钟）

前面两步是“建桥”，这一步是“通电”。我们要告诉飞书：“这个机器人已经准备好了，你可以把消息发给它了。”

5.1 启动Clawdbot网关服务

回到星图终端，输入：

clawdbot gateway

按回车。你会看到日志开始滚动，最后一行是：

Gateway server started on http://0.0.0.0:3000

这表示Clawdbot的通信网关已启动，正在等待飞书的消息。

5.2 在飞书后台配置事件订阅

切换回飞书开放平台 → 进入你的应用管理页；
左侧菜单选择“事件订阅”；
在“订阅模式”中，选择“长连接（WebSocket）”；
在“网关地址”栏，输入：
```
ws://<你的星图实例公网IP>:3000/ws/feishu
```
如何找实例IP？回到星图平台 → 实例详情页 → “网络信息” → “公网IP”（格式如118.193.xxx.xxx）。完整地址示例：ws://118.193.123.45:3000/ws/feishu
点击“保存”按钮。

如果提示“未建立长连接”，请检查：
星图终端里clawdbot gateway命令是否还在运行（没被Ctrl+C中断）；
飞书填写的IP和端口是否完全正确（注意是ws://不是http://）；
星图实例安全组是否放行了3000端口（默认已开放，一般不用改）。

5.3 订阅核心事件并开通权限

添加事件：

在“事件订阅”页，点击“添加事件”；
勾选以下两项（其他可不选）：
- im.message.receive_v1（接收消息）
- contact.user.add_v1（获取用户信息，用于识别提问人）

开通权限：

左侧菜单切换到“权限管理”；
找到并勾选：
- contact:user.base:readonly（读取用户基本信息）
- im:message→ 展开后勾选send_message和receive_message

权限必须和订阅事件严格对应，否则机器人收得到消息但无法回复。

5.4 发布应用，让配置生效

左侧菜单回到“应用发布”；
点击“发布新版本”；
版本号填1.0.1（比初始的1.0.0高一点即可）；
勾选“发布到本企业”；
点击“发布”。

发布成功后，页面会显示“已发布”，且状态变为绿色。这是最后一步，也是最关键的一步。

6. 第四步：真实测试——发一条消息，看它怎么回答（2分钟）

现在，真正的验证时刻来了。打开你的飞书客户端（手机或电脑都行），按以下步骤操作：

6.1 在工作台找到并打开你的AI助手

打开飞书 → 点击底部导航栏“工作台”；
在搜索框输入你起的应用名称（如“智汇助手”）；
点击图标进入应用主页。

首次进入会显示“欢迎使用”，这是正常现象。

6.2 发送第一条测试消息

在聊天窗口里，直接输入：

你好，你能看懂这张图吗？

然后点击“+”号 → “图片” → 选择一张你手机里的照片（比如一张风景照、一张菜单、一张带文字的PPT截图都可以）。

发送后，等待3~8秒（取决于图片大小和网络），你会看到AI助手回复一段文字，内容类似：

“这是一张城市街景照片，画面中有玻璃幕墙写字楼、一辆白色轿车停在路边，天空晴朗，可见几朵白云。建筑外立面有‘创新中心’字样。”

如果看到类似回复，恭喜！你的飞书AI助手已100%跑通。

6.3 查看后台实时反馈（可选但推荐）

回到星图终端，观察clawdbot gateway日志，你会看到类似记录：

[INFO] Received message from user_abc123 in chat_789 [INFO] Forwarding to Qwen3-VL model... [INFO] Model response generated (tokens: 142, time: 4.2s) [INFO] Sending reply to feishu...

同时，在星图控制台的“监控”页，能看到GPU显存占用瞬间上升（Qwen3-VL:30B正在推理），几秒后回落。

这说明：飞书消息 → Clawdbot网关 → Qwen3-VL模型 → 返回结果，整条链路完全打通。

7. 常见问题与快速排查清单

即使严格按照步骤操作，也可能遇到几个典型卡点。以下是90%用户会碰到的问题及一键解决方案：

问题现象	最可能原因	30秒解决方法
飞书发消息后无回复	事件订阅未保存成功	回到飞书“事件订阅”页，重新点击“保存”，确认提示“保存成功”
终端报错`Connection refused`	`clawdbot gateway`未运行	在星图终端按`Ctrl+C`停止当前进程，再输入`clawdbot gateway`重启
飞书提示“应用未发布”	忘记最后一步发布	飞书开放平台 → “应用发布” → 点击“发布新版本” → 填`1.0.1`→ 发布
发图后回复“图片无法加载”	图片太大或格式不支持	换一张小于5MB的JPG/PNG图，或用手机截一张屏幕图再发
回复内容很短或不相关	模型还在热身（首次调用）	多发2~3条不同消息，Qwen3-VL会自动缓存优化，后续变快变准
工作台找不到应用图标	应用未安装到企业	飞书开放平台 → “应用发布” → “安装到本企业”（发布后自动触发）

终极技巧：如果所有步骤都确认无误还是不行，直接在星图终端运行：
clawdbot status
它会返回当前所有通道状态、模型加载情况、网络连通性检测结果，比人工排查快10倍。

总结

到这里，你已经亲手完成了一个企业级AI助手的从零搭建。回顾一下，你实际做了什么：

在飞书后台点了不到20下，创建了一个带图识别能力的机器人；
在星图终端敲了4行命令，就把300亿参数的大模型和飞书连了起来；
发了一张图，3秒内收到了专业级的视觉理解结果。

整个过程没有一行代码需要你写，没有一个环境需要你配，没有一次GPU驱动需要你装。你只是在做最自然的事：点、填、发、看。

这正是现代AI工程化的意义——把复杂留给平台，把简单还给用户。Qwen3-VL:30B的强大能力，不再属于实验室或大厂算法团队，而是你今天下午就能用上的生产力工具。

下一步，你可以：

把公司内部的PDF手册、Excel产品表、Word流程文档上传给它，让它成为真正的知识大脑；
在Clawdbot后台配置更多渠道，比如同时接入企业微信或钉钉；
用它的API接口，把AI能力嵌入到你自己的OA或CRM系统里。

AI助手的价值，从来不在“能不能做”，而在于“什么时候开始用”。你已经跨过了最难的那道门槛。

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

小白必看：如何用星图平台快速搭建飞书AI助手？