中文文档
API Console

帮助

故障排除

查看 Markdown
创建 API Key 了解 Grok 4.7

从破坏性最小的步骤开始。即使桌面或移动应用断开连接，Bot 的云端工作也可以继续。

登录没有完成

  1. 浏览器中进行身份验证时，保持 Grok Bot 打开。

  2. 确认浏览器显示 Cursor 登录成功。

  3. 如果应用没有重新获得焦点，请手动返回应用。

  4. 再次尝试 Get started 或 Sign In with Cursor。

  5. 确认你的账号拥有 Grok Bot 访问权限。

如果你的组织使用 SSO，请完成组织登录，而不是用另一个个人账号登录。

关于 Legacy Privacy Mode 的错误表示该账号正在使用不允许 Grok Bot 所需存储的数据模式。请更新 Cursor 账号数据设置，或联系你的组织管理员。

电脑仍在设置

初始设置和镜像更新可能需要几分钟。请保持应用打开，直到 Starting your computer 或 Updating your computer 完成。

如果进度仍在变化，请等待。如果失败或停止变化：

  1. 在错误状态中重试。

  2. 重启 Grok Bot。

  3. 检查 Grok Bot 应用更新。

  4. 如果电脑仍无法访问，打开 Settings → Updates，选择 Grok Bot's Computer 下的 Update。

电脑无法访问

当电脑暂时不可达时，你的 Bot profile 和已保存对话不一定丢失。

按以下顺序恢复：

  1. 选择 Retry 或重新打开对话。

  2. 重启 Grok Bot 应用。

  3. 如果电脑无法访问的状态中提供 Recover computer，请选择它（确认对话框中称为 Recover Grok Bot's Computer）。

  4. 如果恢复不可用，打开 Settings → Updates，选择 Grok Bot's Computer 下的 Update。在 iPhone 和 Android 上，对应控件为 Settings → Bot → Bot Computer 下的 Update Computer 和 Reset Computer。

  5. 等待替换后的电脑可用。

  6. 只有恢复和更新均失败，且你接受丢失近期未同步工作的风险时，才使用 Reset。

Recover computer 和 Update 会保留持久文件和登录状态。Reset 会恢复最近保存的快照，可能丢失近期或尚未同步的工作。

Bot 看起来卡住了

  • 检查侧边栏和对话中显示的状态。

  • 打开电脑，查看 Bot 是否在某个页面上等待。

  • 查找问题、审批、登录、CAPTCHA 或 secret 请求。

  • 如果当前方法不对，发送一条简短的重定向指令。

  • 如果工作应该结束，发送直接的“Stop now”消息。

该 Bot 屏幕上已经活跃的 computer-use 任务可能需要先完成或被重定向，另一个任务才能开始。

如果用量已耗尽，或达到按需支出上限，请从账号访问页面或可用时的 Usage & Billing 查看用量和计费。

网站反复要求登录

  1. 接管电脑并自行登录。

  2. 完成双因素身份验证或 CAPTCHA。

  3. 确认已登录页面加载完成，再归还控制权。

  4. 告诉 Bot 从当前页面继续。

不要把密码或验证码粘贴到普通聊天中。有些网站会让会话过期，或对每个敏感操作要求验证；这并不总是能避免。

plugin 无法安装或验证

  1. 从侧栏打开 Marketplace，选择 Your plugins，确认插件列在 Installed 下。

  2. 重新打开插件详情页，选择身份验证操作。

  3. 在浏览器中使用预期账号完成授权。

  4. 返回 Grok Bot 并重试任务。

  5. 检查连接器是否需要组织提供的变量或管理员配置。

如果源服务中的身份验证已被撤销，请移除并重新连接 plugin。

附件无法读取

检查：

  • 文件不超过 25 MB，视频不超过 200 MB

  • 桌面端一次选择的附件不超过六个

  • 文件未加密或未受密码保护

  • 发送前上传已完成

  • 文件类型受支持

尝试将不常见格式导出为 PDF、CSV、纯文本或图片。如果移除文档保护会违反你的数据政策，请不要这样做。

routine 没有运行

打开 routine 并确认：

  • 它已启用

  • 它的计划和时区正确

  • 负责的 Bot 仍然存在

  • 必需 plugin 仍已验证

  • 电脑可以访问源系统

  • 用量或账号访问没有被暂停

检查最近运行历史中的失败。只用安全输入使用 Test run；测试可能会执行真实外部操作。

对于事件触发的 routine，请确认源频道、仓库和匹配规则仍然有效。

审批被阻塞

阅读拟执行的目标和参数。如果卡片不再可操作：

  1. 如果有对应控件，请拒绝或取消它

  2. 向 Bot 发送替代指令

  3. 要求它用修正后的范围重新生成操作

如果某项操作不断要求批准，请在 Settings → General → Bot → Auto-review 中检查匹配的 Ask first 规则，包括管理员要求的团队规则。Ask first 规则优先于 Allow automatically 规则。

本地电脑工作被拒绝

云端电脑与本地电脑工作使用不同的权限。打开 Settings → General → Bot → Execution on Local Computer（或 Settings → Computer → Computers 下对应电脑的行），检查策略。

除非任务明确需要你面前电脑上的文件或命令，否则请保持本地访问禁用。

更新 Grok Bot

Grok Bot 应用和 Agent Computer 分别更新。

  • 要更新应用，打开 Settings → Updates → Check for Updates。如果更新已准备好，选择 Restart to Update。

  • 要重建云端电脑，在同一分区中选择 Grok Bot's Computer 下的 Update。

更新桌面应用不会重置云端电脑。

联系支持前

收集：

  • Grok Bot 版本

  • 操作系统及版本

  • 完整的错误消息

  • Bot 或例行任务名称

  • 大致时间和时区

  • 完整的请求 ID 或对话 ID（如果有显示）

  • 重试、重启应用或更新 Grok Bot 电脑是否改变了结果

不要包含密码、一次性验证码、私钥或 secret 值。

最后更新：2026 年 9 月 16 日