Kimi 飞书机器人 5 分钟接入企业群
Kimi 飞书机器人怎么接？本文一步步讲清楚飞书后台建应用、Kimi Claw 拿凭证、订阅事件、发布上线 4 步流程，覆盖常见报错。
把 Kimi 接进飞书工作群之后，最直接的变化是：以前要切 App 去问 AI 的事，现在 @ 一下机器人就有回应。会议纪要、待办整理、跨语言对接、产品咨询——这些原本散在不同工具里的工作都能在一个群里跑通。
下面这篇按真实操作顺序讲 Kimi 飞书机器人怎么 5 分钟接入：飞书开放平台建应用 → Kimi Claw 控制台拿凭证 → 配置事件订阅 → 发布上线。每一步都标了「在哪个页面 / 点哪个按钮 / 看什么提示」。
30 秒了解：接完之后你会得到什么
Kimi 飞书机器人是基于 Kimi Claw 的飞书渠道接入方案，配置完成后，机器人能在飞书群和私聊里被 @ 触发，自动调用 Kimi K2.5 模型 + 已装 Skills 完成对话、写文、查文档等任务。
接完之后能做的事：
- 群里 @Kimi 让它写周报、做对比、出大纲
- 1v1 私聊当个人助理
- 上传文件让它检索内容
- 跨语言会议时实时翻译
- 用 Skills 做行业专用任务（财务、电商、HR 等）
接不进去能踩的坑（先列出来避免后面慌）：
- 飞书后台 App ID / Secret 复制错
- 事件订阅没开「长连接」模式
- 应用没发布版本
- 机器人权限漏勾
下面 4 步全部走完，5-10 分钟内能跑通。
准备工作
开始之前确认：
- 飞书账号：必须是企业自建应用管理员或开发者权限（个人版飞书不行）
- Kimi 账号：Kimi 注册 + 已开通 Kimi Claw 实例
- 浏览器：Chrome / Edge 最新版，开两个标签页方便切换
- 网络：飞书开放平台和 Kimi 都国内直连
第一次接需要管理员权限，建议提前跟 IT 同事打个招呼。
详细操作步骤
第 1 步：在飞书开放平台建应用
打开 飞书开放平台，登录后点右上角「开发者后台」，进入「应用管理 → 创建企业自建应用」。
[此处放截图：飞书开放平台开发者后台，创建应用按钮位置]
填写：
- 应用名称：随便起，如「Kimi 助手」
- 应用描述：一句话，如「Kimi K2.5 接入飞书」
- 应用图标：上传一个 88×88 图标
- 是否启用机器人：勾「是」
点确认，应用创建成功。
第 2 步：在「凭证与基础信息」拿 App ID 和 App Secret
进入新建的应用，左侧菜单点「凭证与基础信息」。页面上显示：
- App ID：以
cli_开头 - App Secret：一长串字符（点「重置」可重新生成）
把这两个字段复制下来，下一步要粘到 Kimi Claw。
[此处放截图：凭证与基础信息页，App ID / Secret 字段红框标注]
第 3 步：在 Kimi Claw 控制台配置飞书渠道
打开 kimi.com，进 Kimi Claw 控制台 → 「渠道接入」→ 选「飞书」。
填写：
- App ID：粘贴上一步复制的
- App Secret：粘贴上一步复制的
- 机器人显示名称：群里看到的名字，如「小 K 助理」
- 触发模式：选「仅 @ 时响应」或「私聊全程响应」
点「保存并重启 Claw」。Claw 后台会用这对凭证去飞书拉取配置。等 30-60 秒重启完成。
[此处放截图：Kimi Claw 控制台，飞书渠道配置表单]
第 4 步：回飞书开放平台配置事件订阅
回到飞书后台你刚建的应用，左侧菜单点「事件与回调」。
关键操作：
- 接收模式：选 「使用长连接接收事件」（这一步最容易漏，必须选长连接！）
- 订阅事件：搜索
im.message.receive_v1（接收消息事件），点「订阅」 - （可选）需要群信息可以再订阅
im.chat.member.bot.added_v1（机器人入群事件）
[此处放截图：事件与回调页，长连接模式 + 事件订阅列表]
第 5 步：配置机器人权限
左侧菜单「权限管理」，搜索并添加这几个权限：
im:message（接收消息）im:message:send_as_bot（以机器人身份发消息）im:chat（获取群组信息）
权限改完会提示「需要重新发布版本」。
第 6 步：发布版本
左侧菜单点「版本管理与发布」→ 「创建版本」→ 填写版本号（如 1.0.0）→ 提交审核。
企业自建应用提交后通常需要企业管理员审批。如果你就是管理员，直接到「应用管理 → 待审批应用」点通过即可。
发布通过后机器人才算真正激活。
第 7 步：把机器人拉进群测试
回到飞书 App，在任意群里点右上角「···」→ 「设置 → 群机器人 → 添加机器人」→ 搜你刚建的应用名 → 添加。
群里 @ 它发一条消息：
@小 K 你好
正常情况 3-5 秒后能收到回复。收不到回复就跳到下一节排查。
接不进去的 6 种排查路径
| 现象 | 原因 | 解决 |
|---|---|---|
| Kimi Claw 控制台保存后提示「凭证无效」 | App ID 或 Secret 复制错位 | 重新去飞书后台复制，注意首尾空格 |
| 飞书事件订阅页报「连接失败」 | 没选「长连接」模式 | 切到长连接，删了重订阅一次 |
| 机器人在群里 @ 了不回 | 权限漏勾或没发布版本 | 检查 im:message + 已发布版本 |
| 私聊不响应 | 触发模式没开「私聊响应」 | Kimi Claw 控制台改回来 |
| 回复延迟超过 30 秒 | Skill 加载慢或网络抖动 | 关掉不常用 Skill，重启 Claw |
| 偶尔回完直接 @所有人 | Skill 触发了广播 | 检查 Skill 配置里的提及范围 |
| 机器人发消息被标记为「营销内容」 | 飞书风控 | 在 Claw 控制台关闭「带链接回复」 |
5 个值得在飞书群里启用的 Skill
接通之后立刻能用的几个高价值 Skill：
Skill 1：会议纪要自动整理
群里转发会议录音 / 文字记录，@Kimi 一下输出结构化纪要（待办、决议、问题）。比手抄快 10 倍。
Skill 2：跨语言实时翻译
中外混合群里有外籍同事，发完中文 @Kimi 自动出英文版（或反向）。
Skill 3：文档检索
把 PRD、产品手册、HR 政策传到 Kimi Claw 工作区，群里问问题秒回准确答案，比建 wiki 还省事。
Skill 4：周报模板生成
每周五下午让 @Kimi 按 STAR 结构帮每个人列周报骨架，员工填血肉就行。
Skill 5：客户对接转译
跨境业务群里用本地通信兼顾语义传达，Kimi 同步做翻译 + 文化注释。
详细 Skill 安装教程见 Kimi Skills 完整教程。
实战：5 分钟用 prompt 验证机器人能力
接完之后第一件事是测试它的边界。下面这个 prompt 直接复制到群里 @ 机器人发送。
你好，我是这个群的管理员。请按下面 5 个任务测试你的能力，每个任务一句话回答，最后告诉我你完成了几个：
- 用一句话介绍你自己，包括你能做什么不能做什么
- 帮我写一个产品例会的 5 项标准议程
- 把这句中文翻译成英文：「下周三上午十点开会，请提前准备 Q3 数据」
- 列举 3 个我们群可以让你做的高频任务
- 如果我现在让你「帮我查询某客户的合同金额」，你会怎么处理（涉及敏感信息）
请用清单格式回复，每条不超过 80 字。最后一句告诉我哪些任务你能做、哪些做不到。
5 个任务回答完整 + 第 5 题主动说「合同金额属于敏感信息我无权访问」，说明机器人接入成功且 Skill 配置正确。
接入完成后的几个建议
- 第一周「仅 @ 响应」：避免群里被 AI 刷屏，等大家用习惯再开放更多触发条件
- 私聊开「长期记忆」：群聊关掉记忆（隐私），私聊开记忆让它越用越懂你
- 每月清理一次工作区：超过 90 天没用的文件归档，避免索引太重
- 关键群配「冷却时间」：领导汇报群里给机器人设个 5 分钟冷却，避免插话
- Skill 装多了反而慢：常用 5 个就够，多了 Agent 路径选择会卡
下一步
- Kimi Claw 是什么：Claw 完整能力总览
- Kimi 钉钉机器人配置指南：另一个常用渠道
- Kimi Claw 桌面版部署：本机跑 Claw 的方案
- Kimi Skills 是什么：给飞书机器人装外挂技能
- Kimi Agent 收费指南：飞书机器人按额度计费
- Kimi 微信机器人：微信生态接入参考
最后一句：机器人能不能用起来，关键不是技术接通了没有，而是团队里有没有一个人愿意持续维护 Skills 和工作区文档。接通只是开始，定期补内容才能让它真有用。