飞书群机器人
用飞书智能体应用模板一键创建应用，把团队脑接进飞书群：@ 它提问，回答带出处；给消息加个表情，就把决定存进团队记忆。
飞书机器人把团队的记忆放到做决定的地方。在任何已绑定的群里：
- @ 它提问。 在群里 @ 机器人问一个问题，它会回一张卡片，答案带出处，引用的记忆可以直接点开，范围限定在这个群绑定的空间里。
- 加表情保存。 给一条消息加上 📌 表情，这条消息就会作为一条记忆存进绑定的空间，机器人回一张确认卡片，可以撤销。
没有绑定空间的群，机器人保持沉默。它从不猜测知识该去哪里。
交给你的 Agent
把下面这行交给你的 Agent。每一步都标注了控制台里的准确菜单名和直达链接，有浏览器控制能力的 Agent 可以照着执行；结尾的最终状态清单就是它该逐项验证的内容：
阅读 https://mem.nowledge.co/zh/docs/integrations/feishu-bot，按文档创建飞书智能体应用并连接到 Nowledge Mem。遇到这三件事停下来交还给我：控制台登录、App Secret、版本发布审批。开始之前
- 一个可以在开发者后台创建应用的飞书租户。应用版本发布需要租户管理员审批。
- 一个带群聊连接界面的 Nowledge Mem Team 工作区：连接 → 群聊。看不到「群聊」标签页，说明当前工作区还没有这个能力。
- 在飞书开发者后台大约 10 分钟。
必须亲自做的三件事
有三件事属于你本人，不属于你的 Agent：登录飞书开发者后台、保管 App Secret（只粘贴到 Nowledge Mem 的凭证输入框里，别的地方一律不给）、以租户管理员身份审批版本发布。本页其余步骤都可以交给 Agent 执行。
第一部分：用智能体应用模板创建
最顺的路是控制台自带的智能体应用模板：权限、事件配置、长连接、卡片回调基本都预置好了，手动路径里大半的步骤它一键替你做完。
创建智能体应用
- 打开 open.feishu.cn/app（开发者后台）。
- 页面顶部有横幅创建飞书智能体应用：「为你预置智能体所需的权限、事件配置，一键创建后，即可接入你的智能体服务」。点立即创建。
- 填一个名字（比如
Nowledge Mem）和描述。
如果你的租户控制台没有这个模板，走文末附录里的手动路径，最终结果完全一致，用下面的清单验证即可。
记下凭证
- 在应用侧边栏打开凭证与基础信息。
- 记下 App ID（以
cli_开头）和 App Secret。第二部分会把两者粘进 Nowledge Mem。
核对预置项，补齐缺口
模板预置得很全，但它不知道这个机器人的具体需要。把下面四处走一遍：已有的原样保留，只补缺的。（直达链接：权限管理在 open.feishu.cn/app/<App ID>/auth，事件与回调在 open.feishu.cn/app/<App ID>/event。）
a. 机器人能力：通常已预置，核对即可。 应用能力 → 机器人应显示已启用。给机器人起名、配头像，这就是大家在群里 @ 的那个身份。
b. 权限：跑一遍批量导入，当作查漏补缺。 打开权限管理 → 批量导入，原样粘贴这份清单。已开通的权限会被直接跳过，所以在模板的权限包之上跑一遍是安全的：
im:message.group_at_msg
im:message.p2p_msg
im:message.reactions:read
im:message.reactions:write_only
im:message:readonly
im:message:send_as_bot
im:chat
im:chat.tabs:write_only
cardkit:card:write
cardkit:card:read
contact:contact.base:readonly
application:application:self_manage不要添加 im:message.group_msg（接收群内所有消息）。正因为没有这条权限，「机器人只能看到 @ 它的消息」才是一个你可以在自己控制台里核实的权限层事实，而不是一句口头承诺。
c. 事件：核对订阅方式，补上机器人专用的事件。 打开事件与回调 → 事件配置：
- 订阅方式应已是使用长连接接收事件，这是模板的默认值，也是整套配置里最关键的简化：不需要公网回调地址，不需要开防火墙，不需要内网穿透。是连接器主动连向飞书。
- 在已添加事件里确认这三个都在，缺哪个就添加事件补上：
im.message.receive_v1（接收消息，通常已预置）im.message.reaction.created_v1（消息新增表情回复，保存手势靠它）im.chat.member.bot.added_v1（机器人进群，自我介绍靠它）
模板可能还预订了一些这个机器人用不上的事件（云文档评论、会议纪要之类）。留着无妨：多余的事件送达后会被直接忽略。
d. 卡片回调：核对。
还是在事件与回调下打开回调配置（直达 .../event?tab=callback）。订阅方式这里同样应是长连接，已订阅的回调里应有 card.action.trigger（卡片回传交互）。少了它，机器人卡片上的所有按钮（反馈、存进团队脑、撤销）都会毫无反应。
把机器人拉进群
在飞书客户端里打开目标群，点 ⋯ → 设置 → 群机器人 → 添加机器人，选中你的应用。
第二部分：在 Nowledge Mem 里连接
在 Nowledge Mem 打开连接 → 群聊。面板按同样的流程五步引导，每一步展示的都是服务端确认过的真实状态；不是点过就算完成。
- 创建应用：就是上面的控制台工作，权限列表带一键复制。
- 粘贴凭证：App ID 和 App Secret。保存后为工作区加密存储、不再回显；已存的密钥只显示末四位。可选设置里可以填机器人的
open_id，用于 @ 的精确匹配（之后补也可以）。 - 连接状态：等状态亮起来。如果显示等待中，面板会给出启动连接器的完整命令。
- 绑定群与空间：机器人所在的每个群都会列出来，把它绑到唯一的一个空间。提问从哪里读、保存往哪里写，都由这个绑定决定。
- 发送测试消息：选一个已绑定的群，发一张测试卡片。到群里看到卡片，整条链路就通了。
逐项验证
这份清单验证的是最终状态，走模板还是走手动都适用。Agent（或你自己）可以逐条核对：
- App ID 以
cli_开头 - 应用能力 → 机器人显示已启用
- 权限管理（
/app/<App ID>/auth）里第 3b 步的 12 条权限全部已开通，且im:message.group_msg没有开通 - 事件配置（
/app/<App ID>/event）显示订阅方式为长连接，im.message.receive_v1、im.message.reaction.created_v1、im.chat.member.bot.added_v1都在已添加事件中 - 回调配置（
/app/<App ID>/event?tab=callback）显示订阅方式为长连接，card.action.trigger已订阅 - 版本管理与发布显示已有线上版本
- 目标群的群机器人列表里能看到它
- Nowledge Mem 群聊面板显示连接状态为已连接，群已绑定空间
- 测试卡片已经出现在群里
- @ 机器人问一个绑定空间答得上来的问题，收到带出处的回答卡片；给任意消息加 📌，收到保存确认卡片
排查
- 机器人在群里不说话。 多半是设计如此：这个群没有绑定空间。到连接 → 群聊 → 绑定群与空间里绑上。
- 消息里写了它的名字但没 @，它不理。 也是设计如此。只有真正的 @ 才会投递给它，这正是第 3b 步只申请
group_at_msg的结果。 - 卡片按钮没反应。 第 3d 步的
card.action.trigger回调没配，或者版本还没发布。 - 加表情不触发保存。 你的租户可能用了不同的表情键值。连接器会把每个未识别表情的
emoji_type打进日志，把那个键加进配置即可。 - 事件一直收不到。 确认第 4 步的版本确实已发布：权限和事件订阅在发布前都不生效。
下一步
- 绑定更多群：一个群对应一个空间，永远显式指定。
- 空间解释了机器人读写的容器。