连接状态与问题排查

连接状态说明

在 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 中查看

群聊里没反应

确认发送时 @ 了机器人；个别平台私聊无需 @

下一步

最后更新于