飞书 Bot
把智能体接入飞书，在私聊或群聊中直接交代工作。
把一个 Melso 智能体连接成飞书 Bot 后，团队成员可以在飞书里私聊它、在群里 @ 它，也可以用 /issue 创建 issue。对话和执行记录仍会保存到 Melso 工作区。
每个 Bot 只对应一个智能体。需要在飞书中使用多个智能体时，分别为它们连接 Bot。
连接 Bot
智能体的所有者、工作区 owner 和 admin 可以发起连接：
- 打开 智能体，选择要接入飞书的智能体。
- 进入 集成，点击 绑定到飞书。
- 用飞书扫描二维码并确认授权。
- 回到 Melso。页面显示 已连接到飞书 后即可使用。
二维码为一次性凭证，过期后重新生成即可。已经连接的智能体不会再次显示扫码入口；需要改名或调整权限时，点击 在飞书中管理。
目前只开放中国大陆版飞书的新连接入口。已有的国际版 Lark 连接仍可继续使用和管理。
第一次使用
成员第一次给 Bot 发消息时，会收到一个账号绑定链接：
- 打开链接并登录 Melso。
- 确认要关联的工作区账号。
- 回到飞书，再发送一次消息。
绑定后，Melso 才能确认消息来自哪位工作区成员。非成员无法使用 Bot。
在飞书中交代工作
私聊
直接给 Bot 发消息即可。连续消息保留在同一段 Melso 对话中，智能体的回复也发回当前对话。
群聊
先把 Bot 加入群聊，再 @Bot 并写下要求。Bot 只会响应明确 @ 它的消息；执行时会结合当前会话中可读取的近期上下文。
创建 issue
发送：
/issue 修复登录后的跳转问题
Safari 登录成功后仍然停留在登录页。第一行作为标题，其余内容作为描述。只发送 /issue 不会创建任务；Bot 会回复用法提示。
管理连接
打开 设置 → 集成 可以查看工作区内已连接的 Bot。工作区 owner 和 admin 可以在这里断开连接；智能体所有者也可以回到该智能体的 集成 页面管理自己的 Bot。
断开后，Bot 不再接收新消息，已有的对话和审计记录不会随之删除。
自托管配置
Melso Cloud 无需额外配置。自托管部署需要先设置一个用于加密 Bot 凭据的密钥：
MULTICA_LARK_SECRET_KEY=<base64 编码的 32 字节密钥>可以这样生成：
openssl rand -base64 32重启 API 服务后，再从智能体的 集成 页面连接 Bot。该密钥需要长期保存：更换或丢失后，已有凭据无法解密，需要重新连接。
MULTICA_LARK_HTTP_BASE_URL 和 MULTICA_LARK_CALLBACK_BASE_URL 只用于代理、测试等特殊部署，正常情况下不需要设置。
常见问题
- 没有绑定按钮：确认当前账号是智能体所有者、工作区 owner 或 admin，并检查自托管密钥是否已配置。
- 二维码失效：关闭弹窗后重新发起连接。
- Bot 要求绑定账号：打开绑定链接并使用该工作区的 Melso 账号登录。
- Bot 不执行：检查智能体是否已归档，以及它使用的运行时是否在线。