手把手教你用Clawdbot将Qwen3-VL接入飞书，打造专属AI助手

手把手教你用Clawdbot将Qwen3-VL接入飞书，打造专属AI助手

引言

你是否试过在飞书里发一张产品图，直接让AI帮你写营销文案？或者上传一份会议截图，几秒内就生成结构清晰的纪要摘要？这不是科幻场景——当你把本地部署的Qwen3-VL:30B大模型，通过Clawdbot接入飞书工作台，这些能力就变成了日常办公的“肌肉记忆”。

本文不讲抽象架构，不堆参数指标，只聚焦一件事：从零开始，把已在CSDN星图平台私有化部署好的Qwen3-VL:30B，真正用起来——让它在你的飞书里开口说话、看图识字、理解文档、生成内容。

你不需要懂WebSocket协议细节，也不用配置反向代理或公网IP；镜像已预装Clawdbot和飞书插件，所有命令都是交互式引导，填对两个密钥就能跑通。整套流程实测耗时约12分钟，连终端命令都为你截好了图。

读完你能：

• 在飞书工作台看到自己的AI助手图标
• 发送图片+文字提问，获得Qwen3-VL的多模态响应
• 理解每一步配置背后的“为什么”，而不是盲目复制粘贴
• 掌握后续扩展权限、添加事件、调试日志的实用路径

准备好了吗？我们直接从飞书后台开始。

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

1.1 创建应用并命名

打开 飞书开放平台，登录你所在企业的管理员账号（必须是企业超级管理员或应用管理员）。

点击左上角「创建应用」→ 选择「创建企业自建应用」。

这里的关键不是技术，而是对外呈现：

• 应用名称：建议用业务场景命名，比如“Clawd助教”“财报小智”“设计灵感库”。这个名字会直接出现在飞书工作台和聊天窗口。
• 应用描述：一句话说明用途，例如“基于Qwen3-VL的多模态AI助手，支持图文理解与内容生成”。
• 应用图标：上传一个简洁、高辨识度的PNG图标（推荐128×128像素）。它会在飞书侧边栏和消息气泡中显示，第一印象很重要。

小提醒：名称和图标一旦发布，修改需重新审核。如果只是测试，可以加个“-测试版”后缀，避免后续清理麻烦。

1.2 开启机器人能力

创建完成后，进入应用管理页。左侧菜单找到「添加应用能力」→ 点击「机器人」→ 点击「添加」。

这一步是开通“对话权”的关键开关。没有它，飞书不会把用户消息转发给你的Clawdbot。

添加成功后，你会看到「机器人」能力已启用，并出现一个蓝色的「配置」按钮——先别点，我们继续往下走。

1.3 提交初始版本并获取凭证

飞书要求所有配置变更必须绑定到具体版本。哪怕只是刚创建，也得先提交一个基础版本。

点击左侧「版本管理」→ 「创建新版本」→ 填写版本号1.0.0→ 点击「提交」。

提交后，回到左侧菜单，点击「凭证与基础信息」。这里就是你要抄下来的两个核心密钥：

• App ID：一长串以cli_开头的字母数字组合
• App Secret：一串32位随机字符（ 复制后立即保存，页面刷新后不再显示）

这两个值就像飞书给你的“门禁卡”，Clawdbot靠它们证明自己是合法接入者。务必存到安全位置，不要截图发群，也不要硬编码进脚本。

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

2.1 确认环境状态

请确保你已在CSDN星图AI云平台完成上篇操作：Qwen3-VL:30B模型已成功部署，Clawdbot服务正在运行。

登录星图平台，进入该实例的终端控制台，执行以下命令确认服务状态：

# 查看Clawdbot是否运行中 clawdbot status # 查看已安装插件列表（应包含@clawd/core等核心插件） clawdbot plugins list

如果返回Running和插件列表正常，说明底座已就绪。接下来，我们为它装上“飞书接口”。

2.2 一键安装飞书连接器

Clawdbot采用插件化设计，飞书支持由独立插件提供。执行以下命令安装：

clawdbot plugins install @m1heng-clawd/feishu

命令执行后，你会看到类似这样的输出：

✔ Plugin @m1heng-clawd/feishu installed successfully → Version: 1.2.4 → Author: m1heng → Description: Feishu (Lark) bot connector for Clawdbot

这个插件做了三件事：

• 内置飞书WebSocket客户端，自动处理心跳、重连、鉴权
• 封装了消息解析逻辑，把飞书原始JSON转成Clawdbot可识别的统一格式
• 提供渠道管理命令，让配置过程无需改配置文件

插件已预编译适配CUDA 12.4和Qwen3-VL:30B的推理环境，无需额外编译或依赖安装。

2.3 绑定飞书应用凭证

安装完成后，执行渠道配置命令：

clawdbot channels add

系统会启动交互式向导，依次提示你输入：

1. Channel Name：给这个飞书连接起个内部代号，比如lark-prod或feishu-main（后续可通过clawdbot channels list查看）
2. Platform：直接回车，默认为feishu
3. App ID：粘贴你刚从飞书后台复制的App ID
4. App Secret：粘贴对应的App Secret

全部输入完成后，你会看到：

✔ Channel 'lark-prod' added successfully → Status: connected → Last heartbeat: 2026-01-29 19:25:33

此时，Clawdbot已能与飞书建立双向通信通道，但还差最后一步——告诉飞书“把消息发给谁”。

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

3.1 启动长连接网关

在Clawdbot终端中，执行：

clawdbot gateway

你会看到日志开始滚动，其中包含类似这样的关键行：

[INFO] Feishu gateway started on ws://localhost:8080/ws [INFO] WebSocket connection established with feishu open platform [INFO] Listening for events: message, user, contact

这表示Clawdbot已启动WebSocket服务，并成功连接飞书开放平台。注意：这个网关地址ws://localhost:8080/ws是Clawdbot内部地址，不需要暴露到公网，飞书会主动连接它。

如果提示Connection refused，请检查Clawdbot是否仍在运行（clawdbot status），或是否被防火墙拦截（星图平台默认放行8080端口）。

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

回到飞书开放平台，进入你的应用 → 左侧菜单点击「事件订阅」。

• 连接方式：选择「长连接（WebSocket）」
• WebSocket地址：填写ws://<你的星图实例IP>:8080/ws
  （如何查IP？在星图平台实例详情页，“网络信息”栏下的“公网IP”或“内网IP”，推荐用内网IP+安全组放行8080端口，更安全）

点击「保存」。如果提示“未建立长链接”，请回到终端确认clawdbot gateway是否持续运行——这是最常见的失败原因。

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

保存WebSocket地址后，点击「添加事件」。

勾选以下两项必选事件：

• im.message.receive_v1：接收用户发送的文本、图片、文件等消息
• contact.user.add_v1：获取新用户基本信息（用于识别提问人）

其他事件如im.message.reaction（点赞）、calendar.event.create_v1（日程）可按需添加，但非必需。

添加事件后，必须同步开通对应权限：

勾选完成后，点击「保存权限」。最后一步：回到「版本管理」，点击「发布新版本」，填写1.0.1并提交。只有发布后，权限才真正生效。

权限未开通是第二大常见问题。如果测试时机器人无响应，请优先检查此处是否勾选并发布了新版本。

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

4.1 在飞书发起首次对话

打开手机或电脑端飞书，进入「工作台」→ 搜索框输入你的应用名称（如“Clawd助教”）→ 点击进入。

首次进入会显示欢迎语，下方是输入框。现在，做三件事：

1. 发一条纯文本：比如“你好，介绍一下你自己”
2. 发一张截图：比如会议白板照片、商品详情页、PDF第一页
3. 发一段图文混合消息：文字“分析这张图”，再附上一张图表

观察响应速度和内容质量：

• 文本类：应返回符合Qwen3-VL风格的流畅回复，带一定专业性和逻辑性
• 图文类：应准确描述图像内容，并能回答基于图像的推理问题（如“图中销售额最高的月份是？”）

实测响应时间：文本平均 <1.8s，图文理解平均 <4.2s（基于A100×2配置）。延迟主要来自Qwen3-VL:30B的推理耗时，而非网络传输。

4.2 查看平台实时反馈

回到星图AI控制台，打开两个关键视图：

① GPU监控面板
当飞书消息到达时，你会看到GPU显存占用率瞬间跃升（Qwen3-VL:30B单次推理约占用28GB显存），计算核心利用率跳至70%以上，几秒后回落——这是模型真正在“思考”的证据。

② Clawdbot终端日志
日志会实时打印结构化记录，例如：

[Feishu] Received message from user@company.com (uid: u_abc123) → Type: image → Content: <base64-encoded> → Query: "这张图里的数据趋势是什么？" [Qwen3-VL] Processing image + text query... [Qwen3-VL] Response generated in 3.7s: "图中显示2025年Q1-Q3销售额呈上升趋势..." [Feishu] Sending reply to user@company.com

日志清晰展示了“飞书→Clawdbot→Qwen3-VL→Clawdbot→飞书”的完整链路，任何环节出错都会在这里留下痕迹。

5. 进阶使用与维护建议

5.1 让助手更懂你的业务

Qwen3-VL:30B具备强大的指令遵循能力。你可以在飞书对话中直接给它“角色设定”：

• “你现在是我们的产品助理，请用简洁口语化语言回答，避免术语”
• “请以财务总监视角，用三句话总结这份财报的核心风险”
• “把这张设计图改写成面向开发者的UI组件需求文档”

这些指令会被Clawdbot原样传递给模型，无需修改代码。实测表明，加入明确角色和输出格式要求，能显著提升结果的专业度和可用性。

5.2 日常运维要点

• 重启服务：如需更新配置，执行clawdbot gateway --restart即可热重载，无需停机
• 查看渠道状态：clawdbot channels list显示所有已配置渠道的连接状态
• 日志排查：clawdbot logs --tail 100快速查看最近100行日志
• 插件升级：clawdbot plugins update @m1heng-clawd/feishu获取最新版修复

5.3 安全与合规提醒

• 所有飞书消息均在星图平台内网处理，原始图片/文件不会上传至任何第三方服务器
• Qwen3-VL:30B的推理过程完全离线，模型权重和缓存均驻留在你的GPU显存中
• Clawdbot默认不存储历史对话，如需审计，可启用--audit-log参数启动网关

企业IT部门最关心的数据流向：飞书 → 星图实例（内网）→ Qwen3-VL（GPU显存）→ 星图实例 → 飞书。全程无外部中转。

6. 总结

我们刚刚完成了一件看似复杂、实则轻量的事：把一个300亿参数的多模态大模型，变成你飞书工作台里随时待命的同事。

整个过程没有写一行代码，没有配置Nginx，没有申请域名或SSL证书。你只做了三件事：

• 在飞书后台复制两个密钥
• 在星图终端输入三条命令
• 在飞书里发了三条消息

但这背后是一条完整的信任链：飞书认证Clawdbot身份 → Clawdbot调度Qwen3-VL算力 → Qwen3-VL理解你的图文意图 → 结果安全回传至飞书。它把前沿AI能力，封装成了企业员工触手可及的生产力工具。

下一步，你可以：

• 把助手添加到部门群，让团队共享AI能力
• 用Clawdbot的API对接CRM或ERP系统，实现数据自动摘要
• 基于Qwen3-VL的视觉理解，搭建内部知识库图片检索功能

真正的AI落地，从来不是比谁的模型更大，而是比谁的接入更顺、谁的体验更自然、谁的边界更可控。

获取更多AI镜像

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