Skip to content
📖 速查手册第 2 / 2 节

报错速查:按报错原文找解法 ​

遇到 Grok Bot 报错,先按报错原文对号入座。官方的排错原则只有一条:从破坏性最小的步骤开始,多数问题一次完整重启就能解决。

先放心一件事:就算桌面或手机 App 断开连接,Bot 的云端工作也会继续,任务不会跟着中断。

桌面端自带 37 种界面语言(含简体中文、繁体中文),但官方排错文档收录的报错原文均为英文,排查时直接复制英文原文对照最准确。

症状:常见报错原文 ​

  • 登录与账号类(走第 1 步):Sign-in does not complete(登录不完成)、登录循环或持续认证错误、Legacy Privacy Mode、SSO 或 Grok Business seat 登录失败。
  • 运行与云电脑类(走第 2 步):Bot failed to respond、Model provider is overloaded、Setting up your Grok Bot…、Update still running、Taking longer than usual、An agent couldn't pause in time、Couldn't Reach Grok Bot's Computer、Reconnecting、Automation run rate limit exceeded、Voice chat failed。
  • 集成与设置类(走第 3 步):Local tools are turned off、Zoom error 4700、AADSTS50011。

快速检查(先花两分钟) ​

  1. 完整重启:Mac 上从菜单栏选 Quit 彻底退出 Grok Bot——不是只关窗口——再重新打开重试。
  2. 查服务状态:打开 status.cursor.com,看 Grok Bot 行(troubleshooting.md:49-51)。App 内不显示服务状态,状态页是官方指定入口,可订阅更新。
  3. 刚出现的报错先等:部分认证错误等 30 到 60 分钟,会随会话刷新自行消失。

排查步骤 ​

第 1 步:登录与账号类报错,逐条对号 ​

Sign-in does not complete(登录不完成) ​

保持 Grok Bot 打开,等浏览器跑完认证。确认浏览器显示 Cursor 登录成功后,如果 App 没有自动切回来,手动返回即可。仍不行的话,在欢迎屏再点一次 Sign in;已经进入应用,就用设置里的 Sign In with Cursor。最后再确认你的账号确实有 Grok Bot 的访问权限。

登录循环或持续认证错误 ​

  1. 把桌面应用更新到最新版,退出登录再重新登录。
  2. 清除 cursor.com 和 x.ai 的浏览器缓存与 Cookie,换无痕窗口重登。
  3. 桌面端用同一 Cursor 账号在 x.ai/bot 再登录一次;手机端循环,先在桌面端登录。
  4. 报错最近才出现,等 30 到 60 分钟再试。

Legacy Privacy Mode 报错 ​

含义:账号当前的数据模式不允许 Grok Bot 所需的存储。更新 Cursor 账号数据设置,或联系你的组织管理员。

SSO 或 Grok Business seat 登录失败 ​

组织 SSO:完成组织登录,别改用其他个人账号。自助 Grok Business seat:在浏览器选 Sign in with Grok,用持有 seat 的那个 Grok 账号。

第 2 步:运行与云电脑类 Grok Bot 报错,逐条对号 ​

先判断是不是服务端问题,再按报错原文对号入座。

Grok Bot 是不是宕机了? ​

打开 status.cursor.com 查看 Grok Bot 行,可以订阅状态更新(troubleshooting.md:49-51)。状态页显示事故:等事故解决,再把消息发一遍。别 Reset 电脑或重装应用——都修不了服务问题,Reset 还可能丢失来不及保存的最新改动(:53-56)。

"Bot failed to respond" / "Model provider is overloaded" ​

原因:状态页没有事故时,官方按瞬时问题处理:稍等再重发一次(troubleshooting.md:58-59)。

解决:

  1. 先等一会儿,把消息原样再发一次。
  2. 仍不回复,完整退出 Grok Bot 再重开。
  3. 电脑显示 Reconnecting 或 Couldn't Reach Grok Bot's Computer,走下面的恢复顺序。
  4. 电脑已连接、同一提示仍失败:带报错标题、request ID 和电脑状态截图联系支持(:58-65)。

"Setting up your Grok Bot…" / "Update still running" / "Taking longer than usual" ​

原因:首次设置和电脑更新本来就要几分钟,下载大镜像或转移数据时更久(troubleshooting.md:69-75)。

解决:

  1. 进度还在变化就继续等,Keep waiting 是安全选择。
  2. 进度停止或失败,改走下面「电脑不可达」的恢复顺序。
  3. 只有更新看起来卡住、且应用给出 Recover computer 时才选它;没有这个选项就继续等(:77-80)。

Update 提示文件还没备份好:等一会儿再试,别用 Reset 强推;一直提示就联系支持(:82-85)。

"An agent couldn't pause in time, so the computer was not updated" ​

原因:有 Bot 正在干活,更新没插进去(troubleshooting.md:86-88)。

解决:让那个 Bot 把手头的活干完,再到 Settings 里选一次 Update。

"Couldn't Reach Grok Bot's Computer" / "Reconnecting" ​

原因:云电脑暂时连不上。Bot 档案和聊天记录存在电脑之外,不会因此丢失(troubleshooting.md:90-94)。

解决(官方恢复顺序,从破坏性最小的开始,:96-109):

  1. 先等,再选 Retry;这期间不要 Reset(:98-100)。
  2. 完整退出 Grok Bot,重新打开(:101)。
  3. 有更新提示时,打开 Settings → Computer,选 Update Bot's Computer(:102-103)。
  4. 还是连不上,或更新卡住且出现 Recover computer,选它——确认对话框里叫 Recover Grok Bot's Computer(:104-106)。
  5. 以上都做过才用 Reset。手机端在 Settings → Bot → Bot Computer 里选 Reset Computer;更新和恢复电脑必须用桌面端(:107-109)。

注意三点(:111-116):

  1. Reconnecting 和 Recover 通常只要几分钟,可选 Continue in Background 先去干别的。
  2. 一个 Update 或 Reset 还在跑时别开第二个;反复 Reset 可能打断还没完成的恢复。
  3. Recover 或 Reset 失败:用一次 Retry Recovery / Retry Reset,然后停下联系支持。

node_modules、Python venv 这类项目目录不会被保存,更新、恢复、重置后要重装(:129-130)。

"Automation run rate limit exceeded" ​

原因:所有 routine 合计每小时最多 300 次、单个最多 200 次,超出即失败(cursor/help-grok-bot-routines.md:77)。

解决:

  1. 某个 routine 频繁撞限额,让 Bot 收窄触发条件或拉宽调度间隔。
  2. 失败的 run 不会自动重试:桌面端用 Test 重跑,webhook 触发就把请求再发一次(cursor/help-grok-bot-routines.md:79)。

注意:自己跑得不多也可能报这个错——所有 Grok Bot routine 共享一个限额,官方已知问题,修复中(cursor/help-grok-bot-routines.md:78)。

"Voice chat failed" ​

原因:通话断线且自动重连失败;通知可能写 Connection lost、No connection 或 The call ended unexpectedly(cursor/help-grok-bot-voice-chat.md:54)。

解决:选 Dismiss,检查网络,再选 Start voice chat 重拨(cursor/help-grok-bot-voice-chat.md:55-57)。提示麦克风被拒,去系统设置允许 Grok Bot 使用麦克风;提示找不到麦克风,接一个再试(:58)。

第 3 步:集成与设置类报错,逐条对号 ​

"Local tools are turned off. The user has set local tool access to Never." ​

原因:云端电脑和本地电脑是两套权限。先看 Settings → Computer → Your computer 里 Execution on this computer 的策略——桌面端列表出现前,这项叫 Execution on Local Computer(troubleshooting.md:359-362)。

已知问题:设置已是 Always allow 或 Ask every time 仍报这个错,是 Cursor 侧的已知问题。你的设置没错,重启、重装 Grok Bot 或改设置,都不会消除报错(:367-371)。

"Zoom error 4700"(授权失败,Invalid redirect) ​

原因:从 Grok Bot 桌面端发起 Zoom 授权,当前必然失败,官方已知问题(cursor/help-grok-bot-connect-apps.md:127-128)。

解决:暂无解法,你这边怎么改都没用,等官方修复;官方会在 Zoom 能连接时更新说明(cursor/help-grok-bot-connect-apps.md:129;docs/grok-bot/computer-and-apps.md:243-245)。

"AADSTS50011"(SharePoint 连接报 redirect URI mismatch) ​

原因:Cursor 团队管理员从 dashboard Integrations 页面选 Application-level permissions 连接 SharePoint 时,Microsoft 在同意提示前报这个错。报错里点名的 Microsoft 应用属于 Grok,不是你的组织,在 Entra 管理中心改什么都没用(cursor/help-grok-bot-connect-apps.md:130-131)。

解决:改用 Delegated permissions 连接(cursor/help-grok-bot-connect-apps.md:132-137;docs/grok-bot/computer-and-apps.md:249-256):

  1. Cursor dashboard → Integrations → SharePoint 卡片,选 Connect team(已开始过设置选 Reconnect),挑 Delegated permissions。
  2. 输入 Microsoft tenant ID(如 contoso.onmicrosoft.com,或 Microsoft Entra ID > Overview 里的 GUID)。
  3. 用 Microsoft 登录;多数工作或学校租户需要 Microsoft 管理员对 Sites.Read.All 同意一次。
  4. 每个团队成员在 Bot 第一次用 SharePoint 时,用自己的 Microsoft 账号登录,只能看到自己账号本来就能打开的站点。

成员看到 "This team does not have the SharePoint integration":说明管理员还没完成上面的 Delegated 登录,完成前应用一直不可用(cursor/help-grok-bot-connect-apps.md:138)。

第 4 步:都对不上,整理材料准备升级 ​

把报错原文、出现时间、已做过的检查整理好;能复制 request ID 就右键消息选 Copy request ID,菜单里没有这一项,说明该消息没有 request ID,改附报错文字和截图(troubleshooting.md:462-465)。对照官方排错文档(docs.x.ai/grok-bot/troubleshooting)逐条核对;仍无解,进入升级条件。

升级条件 ​

重装应用能修复吗? ​

通常不能。官方明确说明重装一般解决不了登录问题,别在这上面浪费时间。

哪些问题必须直接联系支持? ​

部分会话与账号链接失败(含登录循环)、手机验证失败导致的访问封锁,官方说明无法从你这边修复。发邮件到 support@x.ai(troubleshooting.md:456),附上:完整报错原文、已尝试的步骤、问题是否始于 SuperGrok 或 X Premium+ 链接;手机验证封锁,另附封禁截图。

相关阅读 ​

搞懂AI关于我们怎么写隐私说明

独立的第三方教程,与文中提到的任何产品及其公司没有隶属或合作关系;产品名称和商标归各自所有者。价格和政策以官方页面为准。