# 飞书配置指南

MOI 通过长连接接入飞书应用机器人。你需要在飞书开放平台创建应用并发布，然后回到 MOI 填写 **App ID** 和 **App Secret**。MOI 不需要公网域名、回调 URL 或工具实例。

```{note}
飞书开放平台的菜单位置可能随平台版本调整，请以当前页面为准；下述步骤标注了需要开启的功能和要记录的凭据。
```

## 一、在飞书开放平台准备应用

1. 打开 [飞书开放平台](https://open.feishu.cn/app)，创建一个企业自建应用，并按平台要求开启机器人相关能力。
2. 在**事件与回调**中选择**使用长连接接收事件**。
3. 订阅**接收消息**事件。
4. **发布应用**，并确保应用可用范围覆盖要使用智能体的用户或群。

## 二、在 MOI 中建立连接

1. 在智能体卡片的**⋯**菜单中打开**IM 双向通信**。
2. 平台选择**飞书应用机器人**，接收方式保持**长连接**。
3. 填写应用的 **App ID** 和 **App Secret**。首次连接时必须填写 App Secret；编辑已有连接时，留空表示保留现有值，需要更换时填写新值并保存。
4. 为该智能体选择**运行模型**。
5. 点击**保存并继续**。MOI 提示「双向通信已保存，正在建立连接」即开始接入。

## 三、验证连接

1. 在 MOI 中确认显示**配置已保存**和**MOI 接收已启用**，再等待**连接已建立**。
2. 在飞书中打开应用机器人私聊，或将机器人加入测试群后 @机器人发送消息。
3. 返回 MOI，确认接收状态变为**已收到真实消息**，再在原飞书会话中确认收到智能体回复。

**已收到真实消息**只确认 MOI 已收到消息。没有回复时，继续检查运行模型及对应会话的执行结果，见[连接状态与问题排查](troubleshoot.md)。

## 下一步

- [连接后的使用方式](usage.md)
- [连接状态与问题排查](troubleshoot.md)