集成
Lark / 飞书 集成配置指南
通过 Lark / 飞书「智能机器人」的智能体应用，将 MokenLogic 中的智能体接入 Lark / 飞书，让团队成员可以在单聊或群聊中直接与你的智能体对话。全流程约 3 分钟。
开始前的准备
- 一个具备「创建应用」权限的 Lark / 飞书账号。
- 已安装并完成初始化的 MokenLogic，并至少创建一个智能体。
- 一台保持运行的 Mac，用于承载长连接（无需公网 IP 或域名）。
操作步骤
创建智能体应用
打开 Lark（https://open.larksuite.com/page/launcher?from=backend_oneclick）或飞书（https://open.feishu.cn/page/launcher?from=backend_oneclick）开发者平台的一键创建应用页，选择头像、填写应用名称，点击「创建」。
复制 App ID 与 App Secret
应用创建后会显示 App ID 与 App Secret，复制并填入 MokenLogic。
请妥善保存 App Secret；如泄漏可在应用「凭证与基础信息」页重置。
在 MokenLogic 中注册机器人
打开 MokenLogic，进入「能力 → 连接器」，在「Lark（国际）」/「飞书（国内）」分组点击「添加机器人」。填入 App ID 与 App Secret，选择要回应消息的智能体，可选填显示名称，点击「注册机器人」。注册成功后，机器人会立即通过长连接接入 MokenLogic —— 在 Lark / 飞书中向该机器人发送消息，即可由所选智能体生成回复。可在「连接器」页面随时点击「刷新」查看连接状态，或点击垃圾桶图标移除机器人。
连接器
- Lark（国际）已填入 App ID注册机器人
- 飞书（国内）未连接添加机器人
- 企业微信未连接添加机器人
开通「用户基本信息」
注册成功后，MokenLogic 会提示「开通用户基本信息」——这能让对话标题正确显示用户名称。点击「打开权限配置页面」跳转到 Lark / 飞书的权限设置。
开通用户基本信息？
开通后，对话标题才能正确显示 Lark / 飞书用户名称。
添加「获取用户基本信息」权限
在权限页搜索并勾选「获取用户基本信息（contact:user.base:readonly）」，点击「开通」添加该权限。
发布应用使变更生效
进入「版本管理与发布」，设置可用范围后点击「保存」创建版本并发布。权限变更在应用发布（管理员审核通过）后才会正式生效。
顶部若提示「变更将在当前版本发布后生效」，即表示需要完成这一步。
完成！开始在 Lark / 飞书中使用
应用发布并连接成功后，可见范围内的成员即可在 Lark / 飞书中向机器人发送消息或在群聊中 @它，由所选智能体生成回复。如需在群聊中使用，请把该机器人添加到对应群组。