企业级AI助手搭建：基于星图平台和Clawdbot的飞书机器人实战

想象一下，你的团队每天都要处理大量的文档、图片和即时沟通，信息在多个平台间流转，效率低下不说，数据安全也让人头疼。如果能有一个专属的、能看懂图片和文字的智能助手，直接集成在你们每天都在用的飞书里，随时待命，那会是什么体验？

今天，我们就来把这个想象变成现实。我将带你一步步，在CSDN星图AI云平台上，将一个强大的多模态大模型Qwen3-VL:30B私有化部署，并通过Clawdbot这个智能网关，无缝接入飞书工作台。整个过程，你不需要操心复杂的服务器运维，也不需要担心数据泄露，我们用的都是私有化、可掌控的技术栈。

这篇文章是实战的下篇，我们将聚焦于“连接”这一步。如果你已经按照上篇完成了模型的部署，那么恭喜你，最复杂的算力部分已经搞定。接下来，就是让这个“大脑”学会说话，并走进你的办公场景。

1. 开箱即用：理解我们的起点与目标

在开始动手之前，我们先快速回顾一下现状，并明确这半程的目标。

1.1 我们已经拥有了什么？

通过上篇的教程，你应该已经在星图AI云平台上成功运行了一个私有化的Qwen3-VL:30B模型。这意味着：

• 一个强大的多模态AI大脑：它不仅能理解文字，还能分析图片内容，进行图文对话。
• 一个专属的算力环境：模型运行在你独享的云服务器上，所有交互数据都在这个封闭环境内处理，安全性极高。
• 一个稳定的服务端点：模型已经通过API的形式在本地网络内提供服务，等待被调用。

现在，这个“大脑”还很安静，它需要一个“嘴巴”和“耳朵”来与外界沟通，也需要一个“神经系统”来理解指令和传递信息。

1.2 本篇我们要实现什么？

本篇的核心目标，就是为这个“大脑”配备Clawdbot作为智能网关（神经系统），并打通飞书（嘴巴和耳朵），最终打造一个完整的企业级AI助手。具体来说，你需要完成三件事：

1. 在飞书开放平台创建一个“机器人应用”：这相当于在飞书里注册一个官方账号，获得合法的身份（App ID和App Secret）。
2. 在星图服务器上配置Clawdbot：安装飞书插件，并将上一步获得的身份信息配置进去，建立通信链路。
3. 在飞书后台完成权限配置与联动：告诉飞书：“我创建的这个小机器人，有权接收消息和回复消息”。

一个重要的好消息：你当前正在使用的这个星图平台镜像，已经预配置好了Clawdbot及其飞书插件。这意味着上述第2步“安装与配置”对你来说是开箱即用的，可以跳过，我们将把精力集中在飞书平台的配置和最终的联调上。

整个流程的蓝图如下图所示，你可以清晰地看到数据是如何流转的：

flowchart TD
    A[飞书用户发送消息] --> B[飞书开放平台]
    B -- 通过长连接推送 --> C[Clawdbot网关]
    C -- 转发请求 --> D[星图平台<br>私有化Qwen3-VL模型]
    D -- 返回AI响应 --> C
    C -- 通过飞书API回复 --> B
    B --> A

好了，背景清晰，目标明确，我们这就进入飞书开放平台，开始创建属于你自己的AI助手。

2. 飞书侧配置：创建你的机器人身份

要让AI助手在飞书里工作，首先得在飞书的“官方体系”内给它一个合法身份。所有操作都在飞书开放平台完成。

2.1 第一步：创建企业自建应用

首先，访问 飞书开放平台，使用你的飞书管理员账号登录开发者后台。

1. 在控制台首页，找到并点击醒目位置的 “创建企业自建应用” 按钮。
2. 在弹出的表单中，填写应用的基本信息：
   • 应用名称：这是你的机器人在飞书中显示的名字，比如“AI办公助手”、“智能客服Clawd”等。
   • 应用描述：简单描述一下应用的功能，例如“基于大模型的团队智能问答助手”。
   • 应用图标：上传一个LOGO，这会在飞书工作台和聊天界面显示，建议使用清晰、有辨识度的图片。

点击创建后，你就拥有了一个应用的基本框架。这就像为你未来的机器人申请了一个“公司邮箱账号”。

2.2 第二步：为应用添加“机器人”能力

创建的应用初始是“空壳”，我们需要赋予它核心的对话能力。

1. 在应用管理页面的左侧导航栏，找到 “能力” 或 “添加应用能力” 区域。
2. 在能力列表中，找到 “机器人” 并点击添加。这个操作相当于给你的“邮箱账号”开通了“自动收发邮件并智能回复”的高级功能。

2.3 第三步：获取关键凭证（App ID & App Secret）

机器人能力开启后，我们需要拿到它的“账号密码”，以便Clawdbot能代表它登录飞书系统。

1. 在左侧导航栏进入 “凭证与基础信息” 页面。
2. 在这里，你会看到系统自动生成的 App ID 和 App Secret。请立即将这两串字符妥善保存下来（可以复制到本地文本中），它们在下一步配置Clawdbot时会用到。
   • App ID：是应用的唯一标识，相当于用户名。
   • App Secret：是高度保密的密钥，相当于密码。

小提示：为了能顺利进入后续的配置页面，飞书通常要求应用有一个“版本”。你可以直接在“版本管理”中，快速创建一个1.0.0的初始版本并提交，无需填写详细信息。这只是为了解锁配置流程。

至此，飞书侧的“身份注册”工作就完成了。我们已经拿到了连接飞书和Clawdbot的关键钥匙（App ID & Secret）。接下来，我们回到星图平台，进行链路的配置。

3. 通道连接：配置Clawdbot与飞书的通信

现在，我们要在星图云服务器上，告诉Clawdbot如何用刚才拿到的“钥匙”去连接飞书。再次强调，本镜像已预装所需插件，你只需完成配置即可。

3.1 添加飞书通信渠道

我们需要在Clawdbot中添加一个针对飞书的“通信渠道”。

1. 通过星图AI云平台，连接到你的服务器终端（Web Shell或SSH）。
2. 在命令行中，输入以下命令来启动渠道添加向导：

   clawdbot channels add
   

3. 根据交互式提示进行操作：
   • 当提示选择渠道类型时，选择 feishu（飞书）。
   • 在要求输入 app_id 和 app_secret 时，请准确粘贴你在 2.3 步骤中保存的 App ID 和 App Secret。
   • 其他配置项通常可以保持默认，直接按回车即可。

这个步骤的本质，是让Clawdbot记录下飞书机器人的登录凭证。配置成功后，Clawdbot就知道了该以哪个身份去连接飞书的消息服务器。

3.2 重启网关以加载配置

新的渠道配置添加后，需要重启Clawdbot的核心网关服务来使其生效。

在终端中执行：

clawdbot gateway

这个命令会重启网关进程。请确保终端窗口保持运行，不要关闭，这是机器人在线接收消息的关键进程。

看到网关成功启动并监听的日志后，说明Clawdbot侧的准备已经就绪。现在，我们需要回到飞书后台，完成最后一步——授权和握手。

4. 权限与握手：在飞书后台完成最终联动

配置了凭证，启动了服务，但飞书还不知道该把哪些消息发给我们的服务器。这一步就是建立正式的“通信协议”。

4.1 建立长连接（WebSocket）

我们推荐使用长连接模式，它比传统的Webhook方式更稳定，且无需你拥有公网IP地址。

1. 回到飞书开放平台，在你的应用管理后台，找到 “事件订阅” 页面。
2. 在“事件订阅”设置中，你会看到“长连接”选项。确保其处于开启状态。
3. 系统会自动尝试与你的Clawdbot网关建立连接。如果终端中 clawdbot gateway 正在运行且凭证正确，连接状态通常会显示“已建立”。

如果提示“未建立长连接”：请按顺序检查：① 终端中 clawdbot gateway 进程是否在运行；② 配置的 app_id 和 app_secret 是否与飞书后台完全一致。

4.2 订阅消息事件

光有连接还不够，我们需要明确订阅哪些类型的事件。对于聊天机器人，最核心的就是“接收消息”事件。

1. 在“事件订阅”页面，找到 “添加事件” 按钮。
2. 在事件列表中，你需要找到并订阅与消息相关的事件，例如：
   • im.message.receive_v1 （接收用户发送的消息）
   • 确保你订阅的事件版本与你的飞书API版本匹配。

订阅事件相当于告诉飞书：“当用户给我的机器人发消息时，请把这个消息通知推送给我的服务器（Clawdbot）”。

4.3 开通应用权限

订阅了事件，但机器人还没有权限去执行“读消息”和“回消息”的操作。

1. 进入 “权限管理” 页面。
2. 在权限列表中，找到并开通以下两个核心权限：
   • 获取用户基础信息（例如 contact:user.base:readonly）：用于识别消息发送者。
   • 接收与发送消息（im:message）：这是机器人工作的核心权限，请勾选其下的相关子权限项。

权限名称	权限范围示例	为什么需要它？
获取用户基础信息	contact:user.base:readonly	识别是谁在发消息，可以实现个性化回复。
接收与发送消息	im:message (及子项)	最核心的权限，没有它机器人既听不见也说不了话。

3. 至关重要的一步：权限开通后，你必须前往 “应用发布” 页面，将修改后的配置发布一个新版本（例如从1.0.0升级到1.0.1）。只有发布后，所有配置才会真正生效。

至此，所有配置工作全部完成！一条从飞书用户 -> 飞书服务器 -> Clawdbot网关 -> Qwen3-VL模型 -> 原路返回的完整通信链路已经打通。

5. 激动人心的时刻：端到端测试

现在，是时候检验我们的劳动成果了。这个测试将让你亲眼看到整个系统是如何协同工作的。

5.1 在飞书中找到你的机器人

1. 打开你的飞书（手机App或电脑客户端均可）。
2. 点击底部的 “工作台”。
3. 在工作台的应用列表中，找到你刚刚创建并发布的应用（例如“AI办公助手”）。如果没找到，可以尝试在搜索框中搜索应用名称。
4. 点击进入应用。这里通常是一个简单的聊天界面。

5.2 发送第一条指令

在聊天框中，尝试发送一条消息。可以是简单的问候，比如“你好”，也可以测试一下它的多模态能力，例如描述一张图片（如果你通过飞书发送了图片，Clawdbot会将其传递给Qwen3-VL进行分析）。

5.3 观察系统反馈

这时，你可以切换到两个地方观察系统的实时反应：

1. 飞书聊天窗口：你应该在几秒到十几秒内（取决于问题复杂度），收到来自机器人的文字回复。恭喜你，你的企业级AI助手首次回应了你！
2. 星图平台终端：保持运行的 clawdbot gateway 窗口会滚动日志。你会看到类似 Received message from user...、Calling model API...、Response sent 这样的日志，这清晰地展示了消息从飞书传入，经Clawdbot转发给Qwen3-VL模型，再将结果返回给飞书的完整过程。
3. 星图AI控制台：你还可以去星图平台的控制台查看GPU监控。当模型在处理你的问题时，你会看到GPU的显存占用和计算利用率有一个明显的波动，这直观地证明了你的私有化大模型正在为你一个人工作。

6. 总结与展望

回顾整个实战旅程，我们从星图平台的一台云服务器开始，完成了从底层算力部署、中层智能网关配置到顶层飞书应用接入的全链路搭建。你得到的不仅仅是一个聊天机器人，而是一个完全私有化、自主可控、深度集成到办公流程的企业级多模态AI助手。

它的核心价值在于：

• 数据安全：所有对话、图片处理均在私有环境中完成，敏感业务数据不出私域。
• 能力强大：基于Qwen3-VL:30B，具备出色的图文理解和生成能力。
• 开箱即用：得益于星图平台的预置镜像和Clawdbot的插件化设计，集成过程大幅简化。
• 场景深度融合：直接嵌入飞书，无需切换平台，提升工作效率。

现在，你的AI助手已经就位。你可以尝试让它：

• 分析团队共享的图表截图，并生成数据简报。
• 理解产品设计稿，并回答关于设计细节的疑问。
• 作为知识库助手，回答基于内部文档的各类问题（需结合RAG技术进一步开发）。

这个由你亲手搭建的智能体，正等待着被你和你团队的想象力所赋能。开始探索吧，让AI真正为你的业务创造价值。

---

获取更多AI镜像

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