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