4.2d 进阶选修：把本地 Agent 装进飞书
选修警示：全站最陡的一讲
这一讲需要愿意折腾：10 步左右的平台配置、让 AI 代写代码、出问题时看日志排错。零基础同学请直接跳过，主线不受影响；学完第 5 篇 Vibe Coding再回来，体验会好很多。
4.2 观摩课里说过：飞书自带的 AI，脑子是豆包。但飞书还有一个和模型无关的身份——开放平台：它允许你自己写程序，以「机器人」的身份住进飞书群里。这一讲就干这件事：
你的架构（本讲要搭的东西）：
你的电脑 飞书（手机/网页都能用）
┌─────────────────┐ ┌─────────────────┐
│ 本地 Agent │ 长连接 │ 飞书群 │
│ （脑子 = MiMo） │ ◄════════► │ @它提问 / 它回答 │
└─────────────────┘ └─────────────────┘
你自己的模型 飞书只当传声筒+遥控器飞书只提供「住处」（消息通道），智能完全来自你本地的 MiMo——这和 4.2c「客户端壳 + 自己的模型」是同一个哲学：壳与模型解耦。4.2c 借的是别人的客户端壳，这里借的是别人的 IM 壳。
本讲你将学到
- 这条路的真实形态：本地 Agent ↔ 飞书开放平台「长连接」↔ 飞书群
- 三级台阶：①群机器人单向推送（10 行代码起步）→ ②自建应用双向对话（完整形态）→ ③接知识库/定时任务
- 为什么这条路可行：长连接模式不需要公网 IP、不需要服务器、不需要内网穿透，学生笔记本就能跑
- 模型选档实战：机器人调 API 时 Flash/Pro 怎么选（1.1 决策方式的落地）
- 门槛与翻车的如实预告
前置：4.2b MiMo Code（会用终端让 AI 替你干活）；建议先读 1.1 的 Flash/Pro 选型。
1. 先看懂地图：三个角色一条通道
| 角色 | 是什么 | 谁提供 |
|---|---|---|
| 脑子 | MiMo 模型（走小米开放平台 API） | 小米 |
| 手脚 | 你电脑上跑的一段程序：收消息 → 调 MiMo → 发回复 | 你（AI 代写） |
| 住处 | 飞书群 + 开放平台上的「自建应用」（机器人的身份证） | 飞书 |
连接三者的关键是飞书开放平台的长连接模式：你的程序和飞书服务器之间建立一条 WebSocket 通道，群里的消息顺着通道推给你、你的回复顺着通道发回去。官方口径它把接入周期从约 1 周压到 5 分钟，因为——
- 不需要公网 IP 或域名（宿舍笔记本就行）；
- 不需要内网穿透工具；
- 不需要处理加密验签（传统 Webhook 模式的两大劝退点）。
社区里「本地 Agent 接飞书」已经是成熟玩法（2026 年多个开源项目专门做这件事，装个插件填参数就能用）。本站不绑定特定项目，教你通用路径。
2. 三级台阶
台阶①：群机器人单向推送（30 分钟，最简起步）
先体验「我的程序能出现在飞书群里」——不建应用、不写接收逻辑，只要一个 webhook 地址：
- 建一个测试飞书群 → 群设置 → 群机器人 → 添加自定义机器人 → 得到一个 Webhook 地址（一串 URL）；
- 把这个地址告诉 4.2b 装好的 MiMo Code，让它写一个 10 行左右的脚本：向这个 URL 发一条 POST 请求，内容是「今日一句英语 + 中文翻译」（数据让它自己编 7 条存本地，每天发一条）；
- 运行脚本，验收：飞书群里真的出现了这条消息。
这一步的价值：零配置成本打通「程序 → 飞书」的心智。单向推送已经能做不少事：社团每日提醒、速答库更新通知、监控某个网页变化推群。
台阶②：自建应用 + 长连接，双向对话（2~3 小时，完整形态）
目标：在群里 @你的机器人 问问题，它用 MiMo 回答。约 10 步配置 + 一段 AI 代写的代码：
- 建组织：飞书开放平台（open.feishu.cn）的自建应用要挂在一个飞书组织下——自己免费创建一个团队即可（拿你的手机号注册，不拉人也行）；
- 建应用：开发者后台 → 创建企业自建应用，记下 App ID 和 App Secret（这就是机器人的身份证和钥匙）；
- 加能力：应用里「添加机器人」能力；
- 开权限：权限管理里勾选消息相关权限（收消息、发消息）；
- 事件订阅：选择长连接模式（不要选 Webhook），添加「接收消息」事件；
- 发布：创建版本并发布，把机器人拉进你的测试群；
- 写程序：把上面拿到的 App ID / Secret 告诉 MiMo Code，让它用飞书官方 SDK 写一个程序：收到消息 → 调 MiMo API 生成回复 → 发回群里。模型选
MiMo-Flash（理由见第 3 节）； - 跑起来：终端里启动程序，去群里 @机器人 问一句——它回话的瞬间，就是你第一次把自己的模型装进了别人的生态。
排错预期：卡住是常态，不是你菜
社区经验原话：「你说难吧，就简单十步；你说容易吧，好多同学搞不定。」常见翻车点：权限没勾全（收不到消息）、App Secret 填错（连不上）、事件版本选了旧的 v1.0。卡住就把报错信息原样丢给 MiMo Code 让它诊断——这一讲真正的教学内容，就是「和 AI 一起排错」的完整体验。
台阶③：让它有用（选做）
双向通了之后，往上加东西的方向：
3. 模型选档：机器人的脑子用 Flash 还是 Pro
1.1 讲的决策方式在这里落地。机器人是长期常驻、高频调用的东西，选档直接决定月账单：
| 场景 | 选档 | 理由 |
|---|---|---|
| 日常群聊问答、查知识库 | Flash | 高频 + 任务简单——Flash 输入 0.7 元/百万 tokens，宿舍群聊一个月几块钱 |
| 让它写一段复杂代码、做多步分析 | Pro（单次升档） | 命中「任务本身硬」信号 |
| Flash 连续答非所问、改了两轮提示词还不行 | Pro 重跑一次 | 命中「连续翻车」信号，别跟 Flash 死磕 |
口诀不变：Flash 当默认，Pro 当升档，为质量付钱不为习惯付钱。机器人场景还有一条加码理由：调试期你会有大量无效调用（测试消息、格式错误重试），这些「学费」全部应该记在 Flash 头上。
4. 如实预告：这条路的三道坎
- 常驻问题：机器人程序跑在你的电脑上——笔记本合盖/关机，机器人就下线。想让它们 7×24 小时在线需要一台常开的服务器（云服务器或家里的旧电脑），那是毕业后的事；
- 配置量：10 步平台配置对零基础是真实门槛，本讲因此是选修；
- 密钥安全：App Secret 和小米 API Key 都是「钱包+身份证」，不进代码仓库、不发群里、不截图外传。
红线提醒
- 测试群隔离：先建只有自己和一两个朋友的测试群，别把机器人直接拉进社团大群——它还嫩，当众翻车社死的是你；
- 敏感内容零接触：机器人收到的一切消息都会经过你的程序和云端模型——别让它进有隐私内容的群；
- 费用盯紧：API 按量计费，机器人如果被拉进大群被高频 @，账单会涨——在小米开放平台设置充值上限/用量提醒。
跟做练习
实践（弹性：30 分钟 ~ 一个下午）
- 必做：完成台阶①——群机器人 webhook 单向推送跑通（30 分钟）；
- 选做：完成台阶②——自建应用 + 长连接双向对话（预留一个下午 + 好心态）；
- 记录：把翻车点和解决办法记 3 条笔记——这就是你的第一份「AI 结对排错」实战记录（5.3 讲会教你把它写进简历：「独立完成本地 Agent 与 IM 生态的集成」）。
产出物：一个能推送/能对话的飞书机器人 + 排错笔记。
下一步
主线回到工作流：你已经有会聊天的（4.2观摩）、会干活的（4.2b/4.2c）、能住进飞书的（本讲）——下一步把「一次性任务」固化成「自动触发的流水线」→ 4.3 工作流自动化
本页核验日期：2026-09-22（飞书开放平台长连接模式能力——免公网 IP/免内网穿透/免验签处理、自建应用需挂飞书组织、「本地 Agent 接飞书」社区成熟玩法（OpenClaw/MicroClaw 类连接器，2026 年多个开源项目）及「十步配置、卡人是常态」的社区经验，均经当日搜索核实；具体配置路径与权限清单以 open.feishu.cn 官方文档为准；Flash/Pro 价格取自 docs/01 核验快照）