起步排错：登录循环、装不上、打不开
搜「Grok Bot 登录不上」的时候，你八成卡在三处之一：浏览器显示登录成功、app 却没反应；装好了，一打开被 "Update required" 全屏拦住；或者 app 干脆打不开。这节课把起步阶段会撞上的坑逐个对号入座——先 60 秒速检定位，再按报错找解法，10 分钟过完。所有解法都出自 x.ai 官方排错文档和官方登录域名公告。
先记住一个能省你半小时的事实：重装 app 通常解决不了登录问题（官方原话）。所以别急着删软件，往下走。
学完你能做什么
- 用 60 秒速检分清：服务故障、版本太旧、还是登录会话问题
- 把「Grok Bot 登录不上」对号入座：sign-in 卡住的官方 5 步自查、登录循环的清 cookie + 隐身窗口 + 等 30–60 分钟、公司网络的域名白名单
- 看到 "Update required" 全屏知道为什么出现、该点哪里；Linux 会用
apt/dnf命令更新 - 分清「等就好」（Setting up your Grok Bot…）和「要修」（启动卡死）
- 带上版本号、报错原文、request ID 去找支持，一次说清
你现在的困境
- 浏览器明明显示 Cursor 登录成功，app 停在欢迎屏幕，反复点也没用
- 装好了，一打开整个窗口被 "Update required" 盖住，点更新还下载失败
- app 打开就转圈卡死，不知道是自己电脑的问题还是服务挂了
什么时候用这一招
当你需要：
- 解开 1.3 安装 或 1.3b 安装备用方式 里卡住的那一步
- 在重装 app 之前，先把官方解法过一遍——官方明说重装通常解决不了登录问题
而且不想：
- 一报错就重装、就 Reset——这两个通常解决不了登录问题，也都不解决服务问题，Reset 还可能丢掉云电脑上没来得及保存的最新改动
- 分不清「等一等就好」和「必须动手修」，白折腾半天
🎒 开始前的准备
- 走过 1.3 安装 的流程——卡在哪一步都没关系，本课就是解卡的
- 知道自己的账号情况：Cursor 账号直登、公司 SSO、Grok Business 席位、还是 SuperGrok / X Premium+ 需要链接
- Linux 用户先分清自己是 deb 系（Debian / Ubuntu）还是 rpm 系（Fedora 等）
- 公司网络用户：知道防火墙 / 代理归谁管（可能要请 IT 放行域名）
核心思路
先分层，再对号入座。 起步阶段的问题出在三层之一，每层的第一反应不一样：
| 层 | 典型现象 | 第一反应 |
|---|---|---|
| 服务端 | 状态页有事故；Bot 突然不回复 | 等官方解决，别重装别 Reset |
| 账号 / 登录 | 登录循环、Legacy Privacy Mode 报错、白名单拦截 | 按官方登录排错步骤走 |
| 本地 app | 启动卡死、版本太旧、更新失败 | 完整退出重开 → 更新版本 |
两个先记住的事实：
- 大多数问题完整重启一次就好：官方建议从破坏性最小的步骤开始——在 Mac 上用菜单栏的 Quit 完整退出（不是只关窗口），重新打开再试。
- 重装通常解决不了登录问题：部分会话和账号链接失败（包括登录循环）、以及手机验证失败导致的访问拦截，官方明说用户侧修不了，只能带着证据找支持。
首次排查：60 秒速检
四件事按顺序过一遍，基本能定位问题在哪一层：
# 1. 完整退出再重开——官方：大多数问题这样就好了
# macOS 用菜单栏的 Quit，不是只关窗口
# 2. 服务有没有故障？浏览器打开状态页，找 Grok Bot 一行
# https://status.cursor.com
# 3. 版本是不是太旧（超过 14 天且已有新版会被强制更新）？查官方发布源当前版本
curl -s https://api2.cursor.sh/updates/api/download/stable/darwin-arm64/sand
# {platform} 换成你的平台：darwin-x64 / win32-x64-user / win32-arm64-user /
# linux-x64 / linux-arm64，再对照 app 内 Support → About 的版本号
# 4. 登录卡住：浏览器里确认显示 Cursor 登录成功，app 保持打开，手动切回去你应该看到：状态页 Grok Bot 一行没有进行中的事故；curl 返回带 version 的 JSON；app 能完整退出并重新打开。哪一步断了，就去下面对应的分组。
常见问题排查
登录不上：sign-in 卡住与账号问题
登录卡住不完成：浏览器显示成功，app 没动静
原因：登录认证在浏览器里完成，app 这边要等结果——app 中途被关掉、浏览器其实没登录成功、或者账号没有 Grok Bot 访问权，都会卡在这一步。
解决（官方 5 步，按顺序走）：
- 认证在浏览器里跑的时候，保持 Grok Bot 开着，别最小化别关。
- 确认浏览器显示的是 Cursor 登录成功。
- app 没有自动回到前台，就手动切回去。
- 还不行：欢迎屏幕再点一次 Sign in；已经进过 app 的，用 Settings 里的 Sign In with Cursor。
- 确认账号有 Grok Bot 访问权——哪个计划含 Grok Bot，看 1.2 订阅与价格。
两类账号别走错门：
| 你的情况 | 容易踩的坑 |
|---|---|
| 公司用 SSO | 走完组织登录流程，别换成另一个个人账号登 |
| 自助 Grok Business 席位 | 浏览器里选 Sign in with Grok，用持有席位的那个 Grok 账号 |
你应该看到：浏览器显示 Cursor 登录成功后，app 回到前台，进入介绍和第一个 Bot 界面。
登录循环：反复跳浏览器，就是进不了 app
原因：会话或账号链接出了问题——旧的 cookie 和缓存、桌面 app 版本太旧、或刚刷新的会话还没生效。官方明说：重装 app 通常解决不了。
解决（官方 4 招，从快到慢）：
- 把桌面 app 更新到最新版，然后退出登录再重新登录。
- 清掉 cursor.com 和 x.ai 的浏览器缓存与 cookie，换隐身 / 无痕窗口重新登录。
- 桌面端再用同一个 Cursor 账号登一次 x.ai/bot；手机上循环的，先在桌面端登好。
- 报错是刚出现的：等 30–60 分钟再试——部分认证错误会随会话刷新自己消失。
⚠️ 两种情况你修不了，直接找支持
部分会话与账号链接失败（包括登录循环），以及手机验证失败导致的访问拦截，官方明说用户侧无法修复。发邮件给 support@x.ai，带上：报错原文、已试过的步骤、问题是否出现在 SuperGrok / X Premium+ 链接过程中；手机验证拦截的，附上被拦屏幕的截图。
你应该看到：清 cookie + 隐身窗口后，浏览器一次登录成功，app 正常进入。
报错提到 Legacy Privacy Mode
原因：不是装坏了——你的 Cursor 账号在用一种不允许 Grok Bot 所需云数据存储的数据模式。Grok Bot 需要云数据存储，Legacy Privacy Mode 不在支持范围。
解决：
- 把 Cursor 账号的数据设置切到 Privacy Mode。官方口径：Legacy 账号会在开始前被提示切换，照提示做即可。
- 自己改不了就找组织管理员更新账号数据设置；团队账号由 team admin 改团队的隐私设置。
你应该看到：切换后重新打开 Grok Bot，不再出现这个报错，正常进入第一个 Bot。
公司网络登录不上：白名单没放行新登录域名
原因：2026-10-30 起，Cursor 登录页从 authenticator.cursor.sh 迁到了 accounts.spacex.ai 和 accounts.x.ai。公司防火墙 / 代理（比如 Zscaler）的白名单没跟上，这两个域名被拦，登录页就打不开。
解决：
- 让 IT 把下面这些域名加进白名单（官方建议能用通配符就用，省得以后再改）：
*.spacex.ai # 覆盖 accounts.spacex.ai 及相关认证主机
*.x.ai # 覆盖 accounts.x.ai、auth.x.ai 及相关认证主机
*.grok.com # 覆盖 auth.grok.com 和 grok.com
*.grokusercontent.com
*.grokipedia.com- 策略不允许通配符的，至少放行这几个主机：
accounts.x.ai、accounts.spacex.ai、auth.x.ai、auth.grok.com、auth.grokusercontent.com、auth.grokipedia.com、grok.com。 - Cursor 自己的域名照旧要放行：
*.cursor.sh、*.cursor-cdn.com、*.cursorapi.com、*.cursorvm.com。 - 加完后从
accounts.spacex.ai、accounts.x.ai或你们现有的 IdP 重试登录。
你应该看到：浏览器能打开新登录页并完成认证，app 正常进入。
💡 内部书签也查一下
团队收藏夹或内部文档里指向 authenticator.cursor.sh 的链接，更新成 accounts.spacex.ai 和 accounts.x.ai。已有的登录会话不受影响——这不是强制登出。
装不上与更新失败
"Update required"
原因：Grok Bot 的强制更新策略——版本超过 14 天且已有新版，app 就用 "Update required" 全屏盖住窗口，提示你的版本不再受支持。自动更新默认开着，但它只在「屏幕锁定或屏保 + 电脑空闲至少 10 分钟 + Grok Bot 不忙」时才自动安装——这些条件一直不满足，更新就一直没装，直到触发 14 天强制更新。
解决：
- 点 Update，等下载完成，再点 Restart to update——更新期间 Bots 在云端照常运行，不会断活。
- 下载失败：点 Try again，或 Download the latest version 自己下载安装。
Linux 用户：全屏可能显示一条命令让你跑——点 Copy command，在终端执行后重启 Grok Bot：
# Debian / Ubuntu（deb 安装）
sudo apt update && sudo apt install --only-upgrade grok-bot
# Fedora 或其他 RPM 系统
sudo dnf upgrade --refresh grok-bot屏幕要是提示改为下载安装最新包，照做，装完重启 Grok Bot。手机上点 Update Grok Bot，从 App Store / Google Play 拿新版本。
你应该看到：更新装完重启后，全屏消失；账户菜单 Support → About 里版本号变成新版本。
更新完了还是旧版本
原因：app 为更新关闭了，但新版本没真正装上——更新没完成，或下载的安装包没覆盖旧版。
解决（官方顺序）：
- 账户菜单 Support → About 核对当前版本号。
- 完整退出 Grok Bot（Mac 用菜单栏 Quit），重新打开。
- Settings → Updates → Check for Updates，有更新就 Restart to Update。
- 版本还是没变：从 cursor.com/dashboard/bot 下载最新版，直接覆盖安装在现在的 app 上。Bots 和聊天都挂在账号上，重装不会丢。
- Linux 跑上面那两条
apt/dnf更新命令。 - 旧版本一直回来：带版本号和平台找支持。
你应该看到：Support → About 显示新版本号，"Update required" 不再出现。
安装包对不上号：格式、架构与官方入口
原因：下载入口不对（第三方「安装包」来路不明），或格式和系统对不上——比如公司管理工具要 MSI / PKG，而官方根本没发这两种格式。
解决：
- 只从三个官方入口下载：cursor.com/dashboard/bot 的 Download Grok Bot 行、x.ai/bot、或找管理员要链接。
- 核对格式和架构：
| 平台 | 架构 | 官方安装包 |
|---|---|---|
| macOS | Apple silicon、Intel | .dmg |
| Windows | x64、Arm64 | Setup .exe |
| Linux | x64、Arm64 | .deb、.rpm、AppImage |
- 管理工具必须要 MSI / PKG？官方口径：把
.dmg或.exe包进你管理工具要求的格式里。 - 要固定版本、Windows 静默安装、Linux 包管理器安装——都在 1.3b 安装备用方式。
你应该看到：安装包正常下载，格式与系统对应，安装后开始菜单 / 启动器里出现 Grok Bot。
打不开与启动卡住
app 启动就卡死，完全没反应
原因：app 进程没有真正退干净就再次启动，或本机进程卡住。
解决：
- 完整退出再重开——Mac 用菜单栏的 Quit，不是只关窗口。
- 每次启动都卡死：找支持，带上平台和 Grok Bot 版本（Support → About → Copy version info 一键复制）。
你应该看到：完整退出后重开，app 正常出现欢迎屏幕或主界面。
"Setting up your Grok Bot…"
原因：不是故障——首次设置和云电脑更新本来就要几分钟，更新慢可能是在下载大镜像或传输数据。进度还在走，就说明没卡。
解决：
- 保持 app 开着，等进度走完；手机端主屏幕显示的是 Starting your computer…，同样等。
- 更新慢时可能显示 Update still running 或 Taking longer than usual——官方建议选 Keep waiting，除非看起来真的卡死了。
- 进度还在变：继续等。失败或进度不动了：按「云电脑连不上」的恢复顺序处理，见 云电脑维护。
- 只有更新看起来卡死、且 app 提供了 Recover computer 时才用 Recover；没提供就继续等。
你应该看到：几分钟后进度走完，进入与第一个 Bot 的聊天窗口。
怀疑服务挂了：先看状态页
原因：app 内不显示服务状态——服务端出事故时，你在 app 里看到的各种异常都像「自己坏了」。
解决：
- 浏览器打开 status.cursor.com，找 Grok Bot 一行；可以在那里订阅更新。
- 有事故：等官方解决，然后重发消息。别 Reset 云电脑、别重装 app——官方明说这两个都不解决服务问题，Reset 还可能丢掉没来得及保存的最新改动。
你应该看到：Grok Bot 一行显示正常（无进行中的事故）；如果正有事故，等它解决后你的消息能正常收到回复。
还是不行？
先收集证据，再提问。 一份带齐证据的反馈能省掉好几轮来回：
| 要收集 | 怎么拿 |
|---|---|
| 账号邮箱 | 你 Grok Bot 账号上的邮箱 |
| 版本 + 平台 | 账户菜单 Support → About → Copy version info（版本、发布通道、OS 一次复制） |
| 想做什么、Bot / routine 名 | 问题涉及哪个 Bot 或 routine，当时在做什么 |
| 报错原文 / 截图 | 逐字复制，或截报错和计划界面 |
| request ID / conversation ID | 右键消息 → Copy request ID；菜单里没有就说明那条消息没有 request ID，改带报错文字和截图 |
| 大致时间与时区 | 报错出现的时间 |
| 试过什么 | 重试、重启 app、更新云电脑……列出来 |
别放进去：密码、一次性验证码、私钥、任何 secret 值。
去哪里反馈：
| 渠道 | 入口 |
|---|---|
| 桌面 app 内 | 账户菜单 Support → Send Feedback（问题在当前对话时勾上 Include current conversation ID；Mac 也可用菜单栏 Help → Send Feedback） |
| 手机 app | Settings → Send Feedback（问题涉及某个 Bot 时选中它，保持 Include Bot ID 开着） |
| 邮件 | support@x.ai，用你 Grok Bot 账号上的邮箱发；账单和取消问题也发这里 |
登录类问题按「登录循环」一节的提示框要求带材料；手机验证拦截必须附被拦屏幕的截图。
起步之后的报错（Bot failed to respond、Model provider is overloaded、Couldn't Reach Grok Bot's Computer……）按报错原文速查：报错速查。
检查点 ✅
- 60 秒速检四步我过了，知道问题在哪一层
- 登录卡住我按官方 5 步走了；登录循环我试了清 cookie + 隐身窗口 + 等 30–60 分钟，而且没浪费时间重装
- "Update required" 我知道点 Update → Restart to update；Linux 我会用
apt/dnf命令 - "Setting up your Grok Bot…" 我知道这是正常等待，Keep waiting 最稳
- 找支持前我会带齐：版本 + 平台 + 报错原文 + request ID + 已试步骤
本课小结
✅ 起步问题先分层：服务端（看状态页，等）、账号 / 登录（官方排错步骤）、本地 app（完整退出重开 → 更新）。
✅ Grok Bot 登录不上的核心解法：sign-in 卡住走 5 步自查；登录循环清 cursor.com 和 x.ai 的 cookie、换隐身窗口、桌面端登 x.ai/bot、等 30–60 分钟——重装通常没用。
✅ "Update required" = 版本超 14 天且已有新版；Update → Restart to update，Bots 云端照常跑；Linux 用 apt / dnf。
✅ 找支持带齐证据：版本 + 平台 + 报错原文 + request ID + 已试步骤，别带密码和验证码。
关键信息回顾：
| 症状 | 第一反应 |
|---|---|
| 浏览器登录成功，app 没动静 | 保持 app 开着，手动切回，再点 Sign in |
| 登录循环 | 清 cookie + 隐身窗口 → 桌面端登 x.ai/bot → 等 30–60 分钟 |
| 报错提到 Legacy Privacy Mode | 切到 Privacy Mode，团队找管理员 |
| 公司网络登录不上 | IT 放行 *.spacex.ai、*.x.ai 等新登录域名 |
| "Update required" 全屏 | Update → Restart to update（Linux：apt / dnf） |
| 启动卡死 | 完整退出重开（Mac 菜单栏 Quit） |
| "Setting up your Grok Bot…" | 等进度走完，Keep waiting |
| 怀疑服务挂了 | status.cursor.com 看 Grok Bot 行 |
下一课预告
起步的坑排完了。下一课正式开始干活：第一个 Bot：创建、派活、看它在云电脑上干活。
你会学到：
- 登录后自动创建的第一个 Bot 怎么用
- 怎么给 Bot 派第一件活、在电脑预览里看它干活
- 什么时候该再建一个职责更聚焦的 Bot