管理与排查

先看状态

状态	含义	你要做什么
已连接	机器人可以使用	发送私聊和群聊测试消息
连接中	系统正在完成连接	等待页面自动更新，正常不需手动刷新
连接异常	连接中断、凭证失效或应用被删除	点击“检查连接”，再按提示重新配置
已停用	灵谐不会继续连接	打开开关后等待重新连接

常见现象

平台删除机器人后仍显示已连接

点击“检查连接”会强制重新建立连接。平台返回认证失败后，灵谐会把状态更正为“连接异常”。若平台没有提供即时删除通知，状态纠正可能发生在主动检查或下次重连时。

保存后一直连接中

保持页面打开约 90 秒。超过 90 秒可以关闭窗口，后台仍会继续处理，主页面会自动刷新。随后仍未连接时检查应用是否发布、机器人能力和消息接收是否开启。

机器人已连接但没有回复

1. 确认消息发给正确机器人。
2. 群聊必须明确 @机器人。
3. 检查发送者是否在应用可见范围。
4. 在管理后台消息日志确认消息是否进入系统，以及失败阶段和错误码。

提示机器人已经连接到其他分身

同一个平台机器人只能绑定一个分身。请使用新的机器人，或先在原分身中停用并重新配置。

换绑、停用和删除

• 重新配置：替换凭证或重新扫码，适合换机器人或密钥失效。
• 停用：保留配置但停止接收消息，之后可以恢复。
• 删除平台机器人：应同时回灵谐重新配置或停用，避免本地继续尝试恢复旧连接。

排查时记录平台、灵谐账号、发生时间和管理后台的诊断 ID。不要提交 Secret、Token、API Key 或完整凭证截图。