小白也能懂：用Clawdbot将Qwen3-VL接入飞书的详细步骤

小白也能懂：用Clawdbot将Qwen3-VL接入飞书的详细步骤

你是不是也遇到过这样的场景：团队刚部署好一个强大的多模态大模型，比如Qwen3-VL，却卡在最后一步——怎么让它真正“活”起来，走进每天都在用的办公软件里？不是写API、不是搭服务、更不是配Nginx反向代理，而是让同事在飞书里@一下，就能发图提问、查资料、写总结，像和真人同事聊天一样自然。

这篇文章就是为你写的。它不假设你懂OAuth2.0，不需要你会写WebSocket心跳包，也不要求你背下飞书开放平台所有权限码。我们只做一件事：把已经跑在CSDN星图平台上的Qwen3-VL:30B，通过Clawdbot这个“智能翻译官”，稳稳当当地接进飞书工作台。整个过程，就像给一台高性能发动机装上方向盘和油门踏板——它本来就会跑，现在，你终于能开走了。

特别说明：本文是《星图平台快速搭建Clawdbot：私有化本地Qwen3-VL:30B并接入飞书平台》的下篇。上篇中，我们已在CSDN星图AI云平台上完成Qwen3-VL:30B的私有化部署，模型已就绪、GPU显存正待调用。本篇聚焦“最后一公里”：如何让这个算力底座，真正成为你团队日常办公中触手可及的AI助手。

现在，让我们从飞书后台的一个按钮开始，一步步走完这条“看得见、摸得着、用得上”的接入之路。

1. 准备工作：三分钟搞清你要配什么、为什么配

1.1 先理清角色关系：谁是谁的“老板”？

很多新手卡在第一步，不是因为操作难，而是没搞清系统之间的“上下级”关系。我们用最直白的方式说清楚：

• Qwen3-VL:30B是你的“大脑”——它负责看图、读表、理解文字、生成回答。但它不会主动说话，也不会自己登录飞书。
• Clawdbot是你的“秘书兼翻译官”——它住在星图云服务器上，一边连着Qwen3-VL的大脑，一边连着飞书的通信通道。你发给飞书的消息，它先收下，再翻译成Qwen3-VL能听懂的语言；Qwen3-VL的回答，它再翻译成飞书能显示的格式，原路送回去。
• 飞书应用（你创建的那个）是你的“门面”——它出现在飞书工作台里，有图标、有名字、有权限。它本身不干活，但所有消息都必须经过它的“大门”才能进来。

所以，整个流程其实是：你在飞书里@Clawbot助手 → 消息从飞书“大门”进来 → Clawdbot“秘书”收到 → 转给Qwen3-VL“大脑”处理 → “大脑”给出答案 → “秘书”再把答案送回飞书“大门” → 你看到回复。

明白了这点，后面每一步配置，你就知道它在哪个环节起作用了。

1.2 硬件环境确认：你的“大脑”够不够劲？

Qwen3-VL:30B是个大家伙，它需要足够强壮的硬件支撑。如果你是从上篇延续下来的部署，那下面这些参数你应该很熟悉——它们不是摆设，而是决定你能否顺利走完全程的关键基础：

小贴士：如果你是在星图平台一键部署的该镜像，这些配置已由平台自动匹配完成，无需手动调整。你只需确认实例状态为“运行中”，GPU监控显示显存已被Qwen3-VL进程占用即可。

1.3 心态准备：这不是一次“技术考试”，而是一次“配置通关”

整个接入过程，没有一行代码需要你从零手写，没有一个命令需要你死记硬背。Clawdbot的设计哲学就是“开箱即用”，它的命令行交互式配置（clawdbot channels add）会像填空题一样，一步步引导你输入关键信息。

你唯一需要做的，就是：

• 打开飞书开放平台网页，复制两个字符串（App ID 和 App Secret）；
• 回到星图云服务器终端，粘贴进去；
• 按提示敲几个回车。

剩下的，Clawdbot会自动完成插件加载、密钥校验、长连接建立、事件订阅绑定……你只需要看着终端里滚动的日志，像看一场实时直播一样，见证它一点点把“大脑”和“门面”连通。

2. 第一步：在飞书开放平台创建你的专属“门面”

2.1 登录与创建：三步起号

打开浏览器，访问 飞书开放平台，使用你企业的管理员账号登录。

注意：必须是企业管理员或拥有“应用管理”权限的成员，普通员工账号无法创建自建应用。

点击右上角【创建应用】→ 选择【创建企业自建应用】→ 进入创建页面。

这里要填两项，非常简单：

• 应用名称：建议取个有辨识度的名字，比如“Clawd助教”、“Qwen小助手”、“多模态智问”。这个名字会直接显示在飞书工作台和聊天窗口顶部。
• 应用描述：一句话说明它是干嘛的，比如“基于Qwen3-VL的图文理解助手，支持上传图片问答、文档分析”。

小技巧：上传一个清晰的Logo图标（推荐128×128像素PNG）。图标会在工作台列表和聊天窗口左上角显示，一个好图标能让同事一眼记住它。

点击【创建】，你的飞书应用就诞生了。别急着点下一步，先记住这个页面——它就是你整个接入流程的“总控台”。

2.2 开启机器人能力：给“门面”装上“耳朵”和“嘴巴”

新创建的应用，默认只有基础信息，还不能收发消息。我们需要给它加上“机器人”这个核心能力。

在左侧菜单栏，找到并点击【添加应用能力】→ 在弹出的能力列表中，找到【机器人】→ 点击右侧【添加】按钮。

添加成功后，你会看到“机器人”能力已出现在应用能力列表中。这相当于给你的“门面”装上了“耳朵”（接收消息）和“嘴巴”（发送消息），但它现在还不会说话，因为还没学会“语法”——也就是你的App凭证。

2.3 获取凭证：两个字符串，就是你的“钥匙”

在左侧菜单栏，点击【凭证与基础信息】。这是整个流程中最关键的一页。

在这里，你会看到两行醒目的信息：

• App ID：一串以cli_开头的字母数字组合，例如cli_a1b2c3d4e5f67890
• App Secret：一串更长的随机字符，例如gHjKlMnOpQrStUvWxYz1234567890AbCdEfGhIjKlMnOpQrStUvWxYz

请务必用文本编辑器（如记事本）将这两个字符串完整复制下来，并妥善保存。它们是你Clawdbot连接飞书的唯一身份凭证，泄露即等于他人可冒充你的助手。

别担心，它们不会过期，但一旦丢失，你需要在飞书后台重新生成（会作废旧密钥）。

3. 第二步：在Clawdbot端安装“翻译官”并绑定钥匙

3.1 安装飞书插件：一句话，装好“翻译模块”

Clawdbot本身是一个通用Agent网关，它支持微信、QQ、飞书、钉钉等多种渠道。但默认只装了最基础的框架，飞书这个“方言模块”需要单独安装。

打开你的星图云服务器终端（SSH或Web Terminal），确保Clawdbot服务正在运行（可通过clawdbot status查看）。

执行以下命令：

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

你会看到终端开始下载依赖、解压、注册插件。几秒钟后，出现类似Plugin @m1heng-clawd/feishu installed successfully.的提示，就表示“翻译官”的飞书方言包已安装完毕。

小贴士：这个插件是社区维护的，已针对Qwen3-VL做了适配优化，支持图片、表格、富文本等多模态消息的双向转换，无需你额外开发。

3.2 绑定飞书渠道：把“钥匙”交给“翻译官”

现在，“翻译官”有了，钥匙也有了，接下来就是最关键的一步：把钥匙交给它。

在终端中执行：

# 添加飞书通信渠道 clawdbot channels add

这时，Clawdbot会启动一个交互式向导，它会依次问你三个问题：

1. 请选择渠道类型：用方向键 ↓ 选中feishu，按回车确认。
2. 请输入 App ID：粘贴你刚才复制的cli_xxx字符串，按回车。
3. 请输入 App Secret：粘贴你刚才复制的长密钥，按回车。

注意：输入App Secret时，终端不会显示任何字符（这是安全设计，防止被旁观者看到），你只需确保粘贴完整、无空格，然后按回车即可。

如果一切正确，你会看到类似Channel feishu-xxx added successfully.的绿色提示。这意味着，“翻译官”已经拿到了你的钥匙，随时准备上岗。

4. 第三步：在飞书后台完成“握手”与“授权”

4.1 重启网关：让新配置“热生效”

Clawdbot的配置是动态加载的，但新添加的渠道需要网关服务重新初始化才能识别。执行：

# 重启Clawdbot网关，加载新渠道 clawdbot gateway

你会看到终端开始停止旧进程、加载新插件、启动WebSocket监听。当出现Gateway started on ws://0.0.0.0:8080或类似日志时，说明网关已就绪，正在等待飞书的“第一次握手”。

4.2 建立长连接：选择最省心的通信方式

回到飞书开放平台，在左侧菜单栏找到【事件订阅】→ 点击进入。

在“订阅模式”选项中，强烈推荐选择【长连接（WebSocket）】。这是为什么？

• 无需公网IP：你的星图云服务器可能没有固定公网IP，长连接模式下，Clawdbot会主动向飞书服务器发起连接，飞书再把消息推过来，完美绕过内网穿透难题。
• 实时性高：消息秒级到达，无轮询延迟。
• 配置简单：只需填一个“密钥”（Verification Token），其他全由Clawdbot自动处理。

在“密钥”栏，随便填一个6~32位的英文+数字组合，比如clawd-feishu-2024。这个密钥的作用是验证消息确实来自飞书，Clawdbot插件已内置校验逻辑，你无需修改代码。

点击【保存】。如果提示“未建立长链接”，别慌——这恰恰说明Clawdbot网关已启动，正在尝试连接。稍等10~20秒，刷新页面，状态通常会变成“已连接”。

4.3 订阅核心事件：告诉飞书“哪些话我愿意听”

光有连接还不够，你得明确告诉飞书：“我只对哪些类型的消息感兴趣”。否则，它可能会把所有群聊、所有通知都推给你，造成混乱。

点击【添加事件】→ 在弹出的列表中，勾选以下两项（其他可暂不选）：

• im.message.receive_v1：这是最核心的事件，代表“我收到了一条消息”。勾选它，Clawdbot才能收到你@它时发来的文字和图片。
• contact.user.info_v1：这个事件让Clawdbot能获取发消息人的姓名、部门、头像等基本信息，方便后续个性化回复（比如“张经理，您上传的财报截图已分析完成”）。

小技巧：首次接入，只勾选这两个最基础的事件。等整个链路跑通后，再根据需要添加“群消息”、“卡片点击”等高级事件。

4.4 开通必要权限：给“翻译官”发“通行证”

飞书有个严格的安全机制：即使你订阅了某个事件，如果没有对应的权限，Clawdbot依然拿不到数据。这就像是你申请了“查看用户信息”的事件，但没拿到“查看用户信息”的通行证，飞书还是会拒绝给你数据。

在左侧菜单栏，点击【权限管理】→ 找到你刚订阅的两个事件对应的权限：

勾选完成后，点击右上角【提交审核】→ 【确定】。飞书会进行一个简短的自动审核（通常几秒），审核通过后，状态变为“已开通”。

最后一步，也是最容易被忽略的一步：发布新版本。
在左侧菜单栏点击【应用发布】→ 点击【发布新版本】→ 填写版本号（如1.0.1）和更新说明（如“接入Clawdbot，支持图文问答”）→ 【发布】。
只有发布后，你刚才配置的所有事件和权限才会真正生效。

5. 第四步：端到端测试——亲眼见证“大脑”开始工作

5.1 飞书端发起第一问：像平时一样聊天

打开你的飞书PC客户端或手机App，进入【工作台】→ 在搜索框输入你创建的应用名（如“Clawd助教”）→ 点击进入。

你会看到一个干净的聊天窗口。现在，做一件你每天都会做的事：

• 点击输入框旁的“图片”图标，上传一张任意图片（比如一张餐厅菜单、一张会议白板照片、甚至一张猫的自拍照）；
• 在文字框中输入一个问题，比如：“这张图里有什么？”、“请描述这个场景。”、“图中文字是什么意思？”；
• 按下回车或点击发送。

成功标志：几秒内，你就会看到一条来自“Clawd助教”的回复，内容正是Qwen3-VL对这张图的理解和回答。

5.2 星图端实时验证：看见“大脑”在运转

与此同时，切换回你的星图云服务器终端，观察Clawdbot网关日志。你会看到类似这样的实时输出：

[INFO] feishu: Received message from user: zhangsan@company.com [INFO] feishu: Image uploaded, size: 1.2MB, mime: image/jpeg [INFO] qwen3-vl: Processing image with prompt: "请描述这个场景。" [INFO] qwen3-vl: GPU memory usage: 41.2 / 48.0 GB [INFO] feishu: Sending reply to chat: "图中是一位工程师正在白板前讲解一个系统架构图..."

再打开星图AI控制台的GPU监控面板，你会看到GPU显存占用率瞬间从空闲状态（约5GB）跃升至40GB以上，并在几秒后回落——这正是Qwen3-VL:30B被成功唤醒、完成一次完整推理的直观证据。

这一刻，你完成了从“模型部署”到“业务可用”的跨越。它不再是一个躺在服务器里的静态文件，而是一个真正能听、能看、能说、能帮你的AI同事。

总结

• 整个接入流程，本质是三步“配对”：在飞书配好“门面”（App ID/Secret），在Clawdbot配好“翻译官”（插件+渠道），在飞书后台配好“通行规则”（事件+权限）。每一步都对应一个明确的角色和目的，理清了就不怕迷路。
• Clawdbot的价值，在于它抹平了所有底层复杂性：你不用研究飞书的OAuth2.0授权码流程，不用手写WebSocket心跳保活，不用解析复杂的事件JSON结构。它把这一切封装成clawdbot plugins install和clawdbot channels add两条命令，让非开发者也能掌控AI集成。
• Qwen3-VL:30B的私有化部署，赋予了你真正的数据主权：所有图片、所有对话、所有分析结果，都只在你的星图云服务器内流转，不会上传至任何第三方模型服务商。这对金融、政务、医疗等对数据安全要求极高的行业，是不可替代的核心优势。
• 现在，你可以立刻开始探索更多可能性：把“Clawd助教”加进部门群，让它自动解读每日晨会的白板照片；把它嵌入审批流，让它扫描发票截图并提取金额与税号；甚至让它成为新员工的入职向导，通过上传公司组织架构图，回答“我的直属领导是谁？”、“IT支持找谁？”……

这条路，你已经走完了最难的第一步。接下来，就是让它越来越懂你的业务，越来越像你团队里那个最靠谱的AI同事。

获取更多AI镜像

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