飞书 Bot 接入

把任意智能体绑定到飞书 Bot，团队就能在飞书里直接使用它——私聊 Bot、在群里 @ 它，或者输入 /issue 直接创建一个 Multica issue，不用打开应用。智能体的回复会以一张实时卡片的形式回到聊天里，随着它干活不断更新。

每个 Bot 与一个 Multica 智能体一对一绑定。再绑定一个智能体会创建另一个 Bot；一个智能体永远不会有两个 Bot。

这个集成能做什么

绑定智能体（所有者 / 管理员）

绑定走的是扫码安装流程——不用复制任何应用密钥，也不用进开发者后台。

1. 在 Agents → 你的智能体 打开该智能体。
2. 进入 集成（Integrations） tab（或使用左侧栏的 集成 区块），点击 绑定到飞书。
3. 弹出一个二维码。用手机打开 飞书 → 扫一扫，然后授权这个新的 PersonalAgent Bot。
4. 扫码完成后弹窗关闭，智能体显示 已连接到飞书。你自己的飞书身份会自动绑定到你的 Multica 账号，绑完即可开始和 Bot 对话。

智能体连接后，绑定到飞书 按钮会替换成 在飞书中管理 链接。需要调整权限范围、改名或申请更多权限时，用它打开 Bot 在飞书里的应用页面——重新扫码被刻意禁用，以免把已有的 Bot 弄成孤儿。

使用 Bot（成员）

第一条消息：绑定你的飞书身份

第一次给 Bot 发消息时，它会回一张卡片，让你 绑定飞书身份。点开链接、登录 Multica，你的飞书账号就会关联到你的 Multica 成员身份。正是这一步让智能体能以你的身份行事——比如 /issue 会把 issue 记在你名下。

对话与 /issue

• 随便问智能体 —— 私聊 Bot，或在群里 @ 它。对话就是一段普通的智能体 chat 会话，智能体在卡片里回复。
• 创建 issue —— 发送 /issue 修复登录跳转，Multica 会在工作区创建这个 issue，和新建任何 issue 一样。标题后面再加几行就是描述。
• 看它干活 —— 回复卡片会随着智能体运行不断更新，进度和结果都在原处呈现。

如果智能体离线（运行时未连接）或已归档，Bot 会回一条简短的状态提示，而不是悄悄丢掉你的消息。

管理与断开

工作区级别的管理在 设置 → 集成：

• 已连接的 Bot 列出工作区里每个 Bot 以及它绑定的智能体。这个列表所有成员都能看到。
• 断开连接 仅限 所有者 / 管理员。断开后 Bot 停止接收飞书消息、连接被销毁；安装记录会保留以便审计，之后你可以重新绑定同一个智能体。

权限

• 绑定 / 断开 需要工作区所有者或管理员。成员能看到已连接 Bot 列表，但看不到绑定或断开的操作。
• 和 Bot 对话 需要你是工作区成员且已绑定飞书身份。其余的人一律被丢弃。
• 对于被丢弃的消息，集成不会保存消息内容——只记录一个丢弃原因，用于审计。

自部署配置

在 Multica Cloud 上这个集成已经可用——可跳过本节。

自部署时，在你设置好静态加密密钥之前，飞书集成是关闭的。这个密钥会在每个 Bot 的 app secret 落库之前对其加密。

1. 生成一个 32 字节的密钥并设置到 API 服务器：

   MULTICA_LARK_SECRET_KEY=<base64 编码的 32 字节密钥>

2. 重启 API。在密钥设置好之前，设置 → 集成 会显示「未启用飞书集成」提示，绑定到飞书 入口也会保持隐藏。

MULTICA_LARK_HTTP_BASE_URL=https://open.larksuite.com

下一步

• 智能体 —— 每个 Bot 都绑定到恰好一个智能体
• Chat —— 一段 Bot 对话在 Multica 里对应什么
• Issues —— /issue 创建的是什么
• 环境变量 —— 完整的自部署配置参考