先做影响最小、可以撤销的检查。恢复出厂会删除本机用户数据，不应该用来处理普通网络或供应商故障。
先判断是哪一层出问题
按顺序问：
- 本地管理台能打开吗？ 不能就从网络开始。
- 总览是否显示 Agent 正在运行？ 没有就重启 agent 或相关服务。
- 模型供应商已配置且凭证有效吗？ 测试或重新授权。
- 聊天通道已经连接吗？ 检查 token、账户和投递路径。
- 只有 Browser、某个定时任务或工具失败吗？ 只修复该组件。
总览会显示设备信息、Agent、Browser、当前模型供应商和常用重启操作。
本地管理台打不开
- 确认设备有电，网线连接到路由器 LAN 口。
- 启动后等待约一分钟。
- 让手机／电脑连接同一局域网；必要时暂时关闭移动数据。
- 打开标签上的准确地址，例如
http://mango-abc-def.local。 - 用
MT-XXXXXXXX设备码打开查找 MangoTart。 - 检查访客网络、client isolation、VLAN 或防火墙是否阻止设备互访。
- 暂时关闭会拦截本地地址的 VPN 或 Private Relay。
查找页面返回私人局域网地址，不能让管理台从外网访问。详情见网络与访问。
管理台能打开，但 agent 不回复
在总览检查：
- Agent 正在运行：停止时选择重启 Agent。
- 已设置模型供应商：缺失时到模型供应商配置。
- 已连接聊天平台：缺失或状态不确定时到消息平台重新连接。
三项都正常时：
- 先发一条简短纯文本消息，不要不断重试复杂任务。
- 确认模型供应商可访问且账户有余额／有效套餐。
- 重启一次 Agent，等它恢复在线。
- 从已配置的私聊测试，排除群聊会话与路由问题。
模型登录或 API key 失败
打开模型供应商，可用时运行测试连接。
- OAuth／ChatGPT 过期：选择重新授权，再完成 device-code 流程。
- 认证失败：替换 API key，并确认 key 属于当前供应商。
- 模型不存在／不可用：选择账户实际可用模型或填入准确模型 ID。
- 余额不足／限流：到供应商控制台处理。
- 自定义端点失败：检查 Base URL、模型 ID、key、TLS 和兼容行为。
- 中国大陆网络：OpenAI 登录和推理端点通常无法直接访问，请使用可访问供应商；MangoTart 不代理连接。
修改后按界面提示重启 Agent。详见模型与持续费用。
消息平台不工作
- 重新核对该通道需要的 bot token、account ID、user ID 或二维码登录。
- 确认你正在联系的就是 MangoTart 已配置的 bot／账户。
- 保存后按提示重启 Agent。
- Telegram／Discord allow-list 应填写用户 ID，而不是 username。
- 群聊中确认 bot 已加入，而且平台权限允许读取所需消息。
- 确认平台能从 MangoTart 所在网络访问，并在当前地区可用。
“通过邮箱通道与 agent 聊天”和邮件工具不是同一功能；后者让 agent 读取和发送你的邮箱。
Browser 不可用或网站已退出
打开管理台的 Browser：
- 检查 Browser 服务是否运行。
- 停止或无响应时选择重启浏览器服务。
- 打开浏览器画面，网站 session 过期时重新登录。
- 手动测试网站；页面改版、CAPTCHA、双重验证和反自动化措施都可能阻止任务，即使 Browser 服务本身正常。
浏览器 profile 和网站登录不进入备份，恢复或迁移后需要重新授权是正常现象。
定时任务没有运行或投递
在定时任务页面检查：
- 任务没有暂停；
- 下次执行时间符合设备时区；
- 当时 Agent、网络和模型供应商可用；
- 投递通道仍已连接；
- 任务没有卡在过期的网站登录或人工审批上。
使用立即运行区分“排程问题”和“任务本身问题”。立即运行也失败的任务，不会因为改时间而恢复。
更新失败
MangoTart 与 Hermes 更新会执行健康检查，验证失败会回到上一程序版本。在系统页面：
- 查看当前版本和更新日志。
- 当前版本仍可用时，可以等待自动维护窗口。
- 只有确实需要立即更新时才手动触发。
- 页面显示更新失败并回滚时，保持设备供电联网，并把日志和版本发给支持。
更新过程中不要反复断电。
备份或恢复失败
- 云端备份需要互联网，先查看系统中的最近错误。
- 确认已设置备份密码并开启自动备份。
- 恢复时使用创建该日期备份所对应的密码。
- 目标设备版本不能低于备份来源。
- 导入会覆盖当前记忆和设置。
- 解绑前先从网站下载云端备份；解绑会永久删除它们。
详见备份、恢复与迁移。
应该重启、Reboot 还是恢复出厂？
| 操作 | 适用情况 | 对数据的影响 |
|---|---|---|
| 重启 Agent | 模型／消息修改需要应用，或只有 agent 卡住 | Agent 短暂停顿，状态保留 |
| 重启 Browser | 浏览器服务卡住 | Browser 短暂停顿，profile 保留 |
| 重启全部服务 | 多个 runtime 服务停止或状态不一致 | 活跃任务暂停，用户状态保留 |
| Reboot 设备 | 系统或网络整体异常 | 约一分钟离线，用户状态保留 |
| 恢复出厂 | 转让设备，或支持确认必须清除本地状态 | 删除本地账户、设置、凭证、聊天和浏览器登录 |
恢复出厂需要机主 pairing code。它保留 provisioning 与支持所需的注册设备身份，但用户流程会回到初始化。
联系支持前准备
MT-XXXXXXXX设备码和 hostname；- 问题发生的大致时间；
- 当前 MangoTart 与 Hermes 版本；
- 出问题的页面／服务；
- 准确错误文字或截图；
- 最小可复现任务。
不要通过普通邮件发送 API key、密码、备份密码或完整备份包。联系 hello@mangot.art。授权支持拥有管理员级远程维护路径，其访问边界见隐私、安全与权限。