Agent 创建失败
会看到什么： 咕咕会显示「Agent 名称 创建失败：原因」。失败原因可能是以下三种：
- 「设备已离线，Agent 未能启动」
- 「设备长时间未响应，Agent 未能启动」
- 「设备启动 Agent 时出错，未能完成创建」
原因。配置已保留，点击「创建」重试。」
表示什么：创建没有完成。咕咕不会改用其他引擎。一次可重试的创建失败不会自动删除相关内容。咕咕会保留以下内容，等待重试或放弃：
- 同一个 agent
- 单聊
- 创建记录
Agent 长时间停在「启动中」
会看到什么：创建后先出现「Agent 正在上线：名称」。等待时间较长时，本地 agent 会提示「名称 仍在启动（可能在下载运行时）」。云端 agent 会提示「名称 仍在启动（云端处理较慢）」。
表示什么：这条提示还不代表创建失败。等待时间已经结束，但咕咕还没有收到成功或失败的最终结果。创建任务可能仍在等待或执行，咕咕会继续观察。本机准备 Claude 或 Codex 运行时的时候，右下角还会显示准备进度。
可以怎么做：等待后续结果。如果右下角显示「Claude 运行时下载失败」或「Codex 运行时下载失败」，点卡片里的「重试」。如果随后出现创建失败提示，按上一节重试创建。
某一轮回复失败
会看到什么：输入框上方原来显示运行状态的位置会换成失败提示。提示会显示 agent 名称和以下一种失败原因：- 「Agent 长时间未响应，本次回复未完成」
- 「设备连接中断，本次回复未完成」
- 「Agent 本次回复出错，未能完成」
聊天记录里出现引擎错误
会看到什么：聊天记录里出现一条系统提示。「Agent 本回合未能回复，请稍后重试。」 表示什么：引擎遇到了错误，例如：- 鉴权
- 配额
- 网络
- 登录状态
- 配额
- 网络连接
「运行中」没有及时消失
会看到什么：agent 已经结束工作，界面仍显示「运行中」。 表示什么：咕咕可能没有收到这一轮结束的事件。「运行中」显示满 90 秒后，咕咕会向云端重新读取 agent 状态。云端确认 agent 空闲后，界面会清除「运行中」。如果这次读取无法判断，咕咕每 30 秒复查一次，最多复查 10 次。 可以怎么做：先等待 90 秒后的自动核实，不需要重建 agent。如果之后出现回复失败提示，使用该提示的「重试」。Agent 旁边显示「主机旧」
会看到什么：agent 旁边出现带警告图标的「主机旧」徽标。完整提示是「Agent 所在主机的咕咕版本偏旧，缺少部分上报能力（如最近活动）；不影响当前对话，建议升级该主机（与你的账号/咕咕号无关）」。 表示什么：agent 所在机器的咕咕版本缺少部分状态上报能力，当前对话仍可使用。这个徽标与账号或咕咕号无关。 可以怎么做：升级 agent 所在机器上的咕咕。需要升级的是运行 agent 的那台机器，不一定是当前使用的设备。收不到登录验证码
会看到什么：提交邮箱后，登录页显示「验证码已发送至邮箱，请查收邮件」，并显示 60 秒倒计时的「重新发送」。发送请求失败时会显示「验证码发送失败，请稍后重试」。
表示什么：发送成功后，咕咕已经接受发码请求，并开始重发倒计时。登录使用 6 位验证码。
可以怎么做：先核对页面上显示的邮箱。邮箱不对时，点「换邮箱」。邮箱正确时，等倒计时结束，再点「重新发送」。
突然回到登录页
会看到什么：咕咕回到邮箱登录页。如果本机 agent 恰好有尚未发出的回复，登录页还会显示「登录已失效，期间 agent 有数量 条回复未发出，重新登录后自动补投。」
表示什么：主动点「退出登录」会正常回到登录页。没有主动退出却回到登录页，表示原登录状态已经失效。咕咕会区分这两种情况。主动退出时不会把它写成「登录已失效」。
可以怎么做：用邮箱验证码重新登录。有待发送回复时，重新登录后咕咕会自动补投。
本地引擎没有安装
会看到什么：创建对应的本地 agent 时会失败，并提示「本地引擎运行时缺失：找不到可执行的命令。请确认该运行时已安装并在 PATH 中，或改用云端 agent。」各引擎需要找到的命令如下：
表示什么：所选机器无法找到该引擎的本地命令。咕咕不会改用 Claude 或其他引擎继续创建。
可以怎么做：在 agent 所在机器上安装所选引擎，并确保系统能从 PATH 找到表中的命令。然后重试创建。也可以改选云端 agent。