# 连接状态与问题排查

## 连接状态说明

在 IM 双向通信窗口中可以查看连接的实时状态。

| 状态 | 含义 |
| --- | --- |
| 正在连接 | 正在建立长连接 |
| 连接已建立 | 协议链路已接通 |
| 正在重连 | 连接中断，MOI 正在自动恢复 |
| 凭据校验失败 | 平台拒绝了凭据，需检查后重新保存 |
| 连接配置无效 | 配置不完整或已失效，需修改后重新保存 |
| 连接已停止 | 已手动断开，MOI 不再接收消息 |
| 等待首条消息 | 等待来自平台的首条消息；同时检查连接状态与接收状态 |

窗口还会显示配置和收件状态：

| 状态 | 含义 |
| --- | --- |
| 配置已保存 | 连接配置已保存，不代表已经建连 |
| MOI 接收已启用 | 已启用消息接收，不代表已经收到消息 |
| 等待首条真实消息 | 尚未收到来自该连接的真实消息，可向已连接的机器人发送测试消息 |
| 已收到真实消息 | MOI 已收到来自该连接的消息，不代表智能体执行或回复发送成功 |

验证完整对话时，依次确认**连接已建立**、**已收到真实消息**，并在原 IM 会话中确认收到智能体回复。

## 常见问题

| 现象 | 可能原因与处理 |
| --- | --- |
| 凭据校验失败 | 检查 Secret、App Secret、Token 是否与平台一致，是否已被平台重置；修正后再次保存。凭据留空表示不变更，必须粘贴新值才能轮换 |
| 一直正在连接或正在重连 | 重新打开连接窗口查看状态与连接错误；若提示凭据或配置无效，按提示修改后保存 |
| 已建连，但一直等待首条真实消息 | 确认消息发给了已连接的机器人；检查应用可用范围、消息事件订阅和接收权限，群聊中应 @机器人 |
| 已收到真实消息，但 IM 中没有回复 | 回到 MOI 的对应会话，检查运行模型是否可用及任务是否失败；若 MOI 已生成回复，再检查平台发送权限及错误提示 |
| 飞书消息未到达 MOI | 确认应用已发布、选择了使用长连接接收事件、已订阅接收消息事件，并授予对应单聊或群聊消息权限 |
| Slack 消息未到达 MOI | 确认应用已安装到目标工作区，频道中已邀请 Bot；私聊需要 `message.im` 与 `im:history`，频道 @消息需要 `app_mention` 与 `app_mentions:read` |
| 智能体无法读取用户发送的文件 | 确认平台允许机器人下载该文件；Slack 需具备 `files:read`；同时检查文件类型、大小及错误提示 |
| 收不到智能体发回的文件 | 在 MOI 中确认任务已生成文件，再检查平台发送权限及文件限制；Slack 需具备 `files:write` |
| `!moi` 命令没有反应 | 命令单独发送，检查参数格式；切换和重命名使用 `!moi list sessions` 返回的会话 ID，重命名还需填写新名称 |
| 断开后新消息不被接收 | 重新启用连接并完成测试，再核对当前会话；已接收任务的状态到 MOI 中查看 |
| 群聊里没反应 | 确认发送时 @ 了机器人；个别平台私聊无需 @ |

## 下一步

- [IM 双向通信](index.md)