参考

故障排除

请从对数据和工作影响最小的步骤开始。即使桌面或移动应用断开连接，Bot 的云端工作也可以继续。多数问题可以通过彻底重启解决：先完全退出 Grok Bot（在 Mac 上要从菜单栏选择 Quit，仅关闭窗口还不够），重新打开并重试，再考虑其他办法。

登录未完成

1. 浏览器中进行身份验证时，保持 Grok Bot 打开。
2. 确认浏览器显示 Cursor 登录成功。
3. 如果应用没有回到前台，请手动返回应用。
4. 再次选择欢迎屏幕上的 Sign in。如果已进入应用，请在设置中选择 Sign In with Cursor。
5. 确认你的账号拥有 Grok Bot 使用权限。

如果组织使用 SSO，请完成组织登录，避免误用其他个人账号。如果使用权限来自自助开通的 Grok Business 套餐席位，请在浏览器中选择 Sign in with Grok，使用持有该席位的 Grok 账号登录。

如果登录操作反复循环或一直提示身份验证错误：

1. 将桌面应用更新到最新版本，退出账号并重新登录。
2. 清除浏览器中 cursor.com 和 x.ai 的缓存和 Cookie，然后用隐私或无痕窗口重新登录。
3. 在桌面端，也可尝试使用相同的 Cursor 账号登录 x.ai/bot。如果手机一直停留在登录循环，请先在桌面端登录。
4. 如果刚出现错误，可等待 30 至 60 分钟后重试。部分验证错误会在会话刷新后自行消失。

重新安装应用通常无法解决这类问题。部分会话和账号关联故障（包括登录循环），以及手机验证失败导致的访问限制，无法在用户端修复。请联系支持团队，提供完整的错误文字、已尝试的步骤，并说明问题是否开始于关联 SuperGrok 或 X Premium+ 时。如果手机验证导致访问受限，请附上访问被阻止页面的截图。

有关 Legacy Privacy Mode 的错误表示账号当前的数据模式不允许 Grok Bot 所需的数据存储。请更改 Cursor 账号的数据设置，或联系组织管理员。

Grok Bot 服务中断了吗？

访问 status.cursor.com，查看 Grok Bot 一行。应用内不显示服务状态，需前往状态页面查看，也可在该页面订阅更新。

如果状态页显示 Grok Bot 发生故障，请等到恢复后重新发送消息。不要对电脑执行 Reset 或重装应用。这两种操作都无法修复服务故障；如果暂时连不上电脑以保存数据，执行 Reset 还可能丢失刚刚作出的更改。

如果状态页未显示故障，而 Bot 提示 Bot failed to respond 或 Model provider is overloaded，请稍等片刻后重新发送消息。如果仍无回复，请完全退出并重新打开 Grok Bot。当电脑显示 Reconnecting 或 Couldn't Reach Grok Bot's Computer 时，Bot 也无法完成当前轮次，参见无法连接电脑。如果电脑已连接，而同一提示词仍然失败，请联系支持团队，提供错误标题、请求 ID 和电脑状态截图。

电脑仍在设置中

首次设置和电脑更新可能需要几分钟。应用显示进度时请保持打开，例如首次设置时显示 Setting up your Grok Bot…，更新时显示 Updating Grok Bot's Computer。手机主屏幕会显示 Starting your computer…。更新较慢时，可能显示 Update still running 或 Taking longer than usual。除非更新明显卡住，否则选择 Keep waiting 较为稳妥。下载较大的镜像或传输数据可能需要几分钟。

如果进度仍在变化，请继续等待。如果失败或进度不再变化，请按照无法连接电脑中的步骤操作。仅在更新看起来已卡住且应用提供 Recover computer 时，才选择 Recover；若无法恢复，请继续等待。

如果电脑文件尚未备份，Update 会提示文件尚未就绪，不会进行更改。稍等片刻再试，不要使用 Reset 强制更新。如果一直提示文件未就绪，请联系支持团队。如果 Settings 显示 An agent couldn't pause in time, so the computer was not updated，请等该 Bot 完成工作，再次选择 Update。

无法连接电脑

暂时无法连接电脑不会导致 Bot 资料和已保存的对话丢失。聊天记录独立于电脑存储；在重新连接期间，Bot、文件和登录信息都是安全的。

按以下顺序恢复：

1. 如果电脑显示 Reconnecting 或 Couldn't Reach Grok Bot's Computer，先等待，再选择 Retry。期间不要执行 Reset。
2. 完全退出并重新打开 Grok Bot。
3. 如果有可用更新，请打开 Settings → Computer 并选择 Update Bot's Computer。
4. 如果仍无法重新连接，或更新似乎已卡住且界面上显示 Recover computer，请选择 Recover computer（确认对话框中称为 Recover Grok Bot's Computer）。
5. 完成上述步骤后才考虑 Reset。在 iPhone 和 Android 上，Settings → Bot → Bot Computer 中有 Reset Computer；更新和恢复电脑则需要使用桌面应用。

Reconnecting 和 Recover 通常需要几分钟，你可以选择 Continue in Background。如果更新或重置正在进行，请勿再次发起更新或重置。反复重置可能中断尚未结束的恢复过程。如果 Recover 或 Reset 失败，请通过 Retry Recovery 或 Retry Reset 重试一次；若仍失败，请停止操作并联系支持团队。

Update Bot's Computer 下方的文字会说明待执行的更新类型。软件更新保留所有内容，包括已安装的应用。完整的电脑更新保留 Bot、文件和登录信息，但会移除已安装的应用和软件包，有时可安排到稍后执行。Recover computer 会尽可能保存数据，再根据已保存的数据用最新版本重建电脑。已保存的 Bot、文件和登录信息会保留，应用和软件包会被移除，运行中的工作会中断；如果无法连接电脑以保存数据，最近的更改可能会丢失。Reset 会从最近一次保存的数据重建电脑，可能丢失的内容相同。如果最近有 Bot 消失或保存失败，执行任一操作前先联系支持团队。

node_modules 或 Python 虚拟环境等项目文件夹不会保存。电脑更新、Recover 或 Reset 完成后，请重新安装这些依赖。

聊天或 Bot 似乎不见了

通常并未删除。聊天记录独立于电脑存储，电脑问题本身不会删除对话历史。请先检查：

1. 完全退出并重新打开 Grok Bot。
2. 在另一台设备上打开相同账号，也可以使用手机应用。登录同一账号的设备共享 Bot 和对话。
3. 在侧栏中打开桌面端的 Hidden Bots 或手机端的 Show Hidden Bots。Hide from sidebar 只会将 Bot 移出列表；已隐藏的 Bot 保持活跃并保留历史记录。要重新显示它，请选择桌面端的 Show in sidebar 或手机端的 Unhide。
4. 确认当前登录的是同一个 Cursor 账号。

不要通过 Recover 或 Reset 查找 Bot 或聊天。如果检查后所有设备上仍然找不到，请联系支持团队，提供 Bot 名称和侧栏截图。

电脑上的文件不见了

对话历史保存在电脑之外，因此删除电脑上的文件（包括使用 rm -rf）不会删除聊天。Grok Bot 会保留一份已同步电脑数据的持久副本，重新打开电脑时会从副本恢复，已同步文件通常会重新出现。如果 Recover 后电脑仍是空的，请停止在其中进行更改，并联系支持团队。

仅存在于你自己的 Mac 或 Windows 电脑上的文件不在此范围内。请自行备份这些文件。

电脑磁盘空间不足

此处指 Bot 的云端电脑。磁盘即将用满时，Bot 会在聊天中提醒你一次，列出占用空间最大的文件或文件夹及其大小，并询问是否删除。只有经你同意才会删除；如果拒绝，文件将保留在原处。清理只影响电脑文件，不会影响聊天。磁盘空间不足不代表数据丢失。

Bot 似乎卡住了

• 检查侧栏和对话中显示的状态。
• 打开电脑，查看 Bot 是否在某个页面上等待。
• 查找待回答的问题、审批请求、登录提示、CAPTCHA 或凭据请求。
• 如果当前方法不对，发送一条简短的消息纠正方向。
• 如果希望结束工作，请直接发送“立即停止”。

如果该 Bot 的屏幕上已有电脑操作任务在运行，可能需要先等任务结束或指示 Bot 改变方向，才能启动另一项任务。

已达到用量上限

如果 Bot 停止回复并提示已达到用量上限，说明本周额度已用完，每周会重置。如果要立即继续，可添加预付额度（The X Subscription）、开启按需用量（旧版 Cursor 套餐），或升级到更高档位。开启按需使用后，On-demand monthly limit 会限制按需用量，但已在工作的 Bot 可能要到完成任务才停下，从而略微超出上限。参见 Grok Bot 如何收费？和用量与账单。

网站反复要求登录

1. 接管电脑并自行登录。
2. 完成双因素身份验证或 CAPTCHA。
3. 确认已登录页面加载完成，再归还控制权。
4. 告诉 Bot 从当前页面继续。

不要将密码或验证码粘贴到普通聊天中。有些网站会使登录会话过期，或对每次敏感操作要求验证，这类验证不一定能避免。

指纹、Face ID、Windows Hello 以及保存在笔记本或手机上的通行密钥，均无法在 Bot 的电脑上使用。对于使用 Okta 或单点登录的工作应用，请选择 Take over，该选项位于 Computer 卡片中，卡片上标有 Action needed。使用公司允许的方法登录，例如密码加验证码或手机推送审批，然后选择 I'm done。在 Mac 和 Windows 上还可以使用硬件安全密钥：进入 Settings → General，在 Security Key 下开启 Use hardware security keys。

网站超时或无法连接

Bot 的电脑通过 Cursor 的共享网络访问互联网。有些站点和服务会丢弃来自该网络的连接，即使同一地址在你自己的设备上能够打开。Bot 可能报告超时、安全连接错误，或网页一直无法加载。Update、Recover、Reset 都无法改变这一情况，不必执行。

Settings → Computer → Your computer 下的两个选项可以让工作通过你自己的设备进行：

• Route traffic through this computer. Bot 的浏览器会使用桌面电脑的网络连接，网站看到的是你的网络和 IP 地址。此设置适用于新连接，在 Grok Bot 桌面应用打开时生效。如果此行提示先更新 Bot 的电脑，请选择 Update。如果团队管理员已关闭本地路由，开关会被锁定。参见通过桌面电脑转发流量。
• Execution on this computer. Bot 会在你的桌面电脑上运行命令和脚本，包括调用 API。选择 Ask every time 或 Always allow。

如果两个选项都不适用，请联系支持团队，提供站点地址和错误截图。

插件无法安装或验证身份

只有应用需要你登录时，Bot 才会显示连接卡片。无需等待卡片出现，可直接执行以下步骤：

1. 从侧栏打开 Connect apps，选择标题旁的已连接数量，确认该插件已列为已安装。
2. 打开应用，选择 Authenticate（手机上为 Authorize）。
3. 在约 10 分钟内，使用预期的账号在浏览器中完成授权。
4. 返回 Grok Bot 并重试任务。

如果连接卡片显示正在等待授权，选择 Reopen 可重新打开登录页面。如果提示授权未完成或失败，选择 Retry。如果应用按钮变成 Reconnect，请选择它。

Added 表示应用已安装。要确认登录状态，请查看 Connect apps：

• Needs auth 或 Disconnected：选择 Authenticate 并完成登录。
• Disabled by team admin：请联系 Cursor 团队管理员开启。
• Connected：给 Bot 发一条新消息，请它再试一次该应用。

如果仍然无效，或源服务中已撤销授权，请选择 Remove，重新添加应用并登录。另请检查连接器是否需要组织提供变量或由管理员配置。如果重新授权完成后应用仍显示未连接，请联系支持团队并提供应用名称。

X 插件已连接，但无法请求 X 私有数据

Grok Bot 内置了公开 X 数据访问功能。无需关联 X，也无需 X API 额度，即可搜索帖子、个人资料、提及、趋势和新闻。只有访问私信、书签、主页时间线以及查询哪些人赞过你的帖子等账号私有数据时，才需要 X 插件。该插件使用你自己的 X 开发者账号，需要 X API 额度。

1. 打开 console.x.com，使用你在 Grok Bot 中关联的同一个 X 账号登录。
2. 检查 X API 额度余额。如果显示 $0.00，请在那里向 X 购买预付额度。
3. 在 Grok Bot 中重新发送请求，无需重新连接插件。

重新连接插件或更改 Grok Bot、Cursor 套餐都不会增加 X API 额度。目前关联 X 不一定会自动获得初始 X API 额度，因此在添加额度前，console.x.com 可能会显示 $0.00。

保存的凭据值似乎不见了

保存后不会再次显示凭据值，在 Shell 中也看不到。对于共享 Bot，如果名称仍列在 Secrets 下，凭据就仍然保存着。参见 Vault。

无法读取附件

请检查：

• 文件大小未超过限制：单张图片 25 MB，单份文档、音频或其他文件 250 MB，单个视频 1 GB。每条消息的图片总量上限为 200 MB。
• 桌面端每条消息最多附加 20 个文件。
• 文件没有加密，也没有设置密码保护。
• 发送前已完成上传。
• 文件类型受支持。

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

例行任务没有运行

打开例行任务，检查以下各项：

• 任务已启用，没有处于 Paused 状态。
• When to run 显示的计划和时区符合预期。
• 负责该任务的 Bot 仍然存在。
• 必需的插件仍已获授权。
• 电脑可以访问源系统。
• 用量和账号访问权限均未暂停。

查看最近的运行历史是否有失败记录。如果桌面应用显示 Test，请只用安全的输入测试；测试运行也可能执行真实的外部操作。许多例行任务没有 Test，可以在聊天中给 Bot 一份安全的输入，请它单独执行一次相同的工作。

对于事件触发的例行任务，请确认源频道、仓库和匹配规则仍然有效。如果例行任务没有暂停，却在至少 24 小时内都未运行，也没有报错，请报告问题，并提供 Bot 名称和例行任务详情。

任务运行报错

从消息中复制请求 ID，然后重新尝试。如果在一次全新的运行中，同一提示词仍然失败，请报告问题，附上错误文字和请求 ID。

审批请求过期或被阻止

在你参与的聊天中发起的审批请求会一直等你。由例行任务、触发器或其他 Bot 发来的消息等自行启动的工作产生的审批请求，约 30 分钟后过期。届时卡片会显示 Expired，操作不会执行。为及时处理审批，可为执行例行任务的 Bot 开启 Notifications，对信任的操作选择 Always allow；如果审批过期，请让 Bot 再试一次。

如果卡片已无法操作，请先阅读拟执行操作的目标和参数，然后：

1. 如果有相应的选项，请拒绝或取消。
2. 向 Bot 提供替代指令。
3. 要求它按修正后的范围重新生成操作。

如果某项操作反复要求批准，请检查 Custom Rules（位于 Settings → General → Bot 下），看是否有匹配的 Ask first 规则，包括管理员要求执行的团队规则。Ask first 规则优先于 Allow automatically 规则。

在本地电脑上执行操作被拒绝

云端电脑和本地电脑使用不同的权限。打开 Settings → Computer → Your computer，找到该桌面电脑的 Execution on this computer（在尚未列出桌面电脑时显示 Execution on Local Computer），查看策略。

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

即使已将 Execution on this computer 设置为 Always allow 或 Ask every time，Bot 也可能提示“Local tools are turned off. The user has set local tool access to Never.”。这是 Cursor 端的已知问题。你的设置正确，重启或重装 Grok Bot，以及更改该设置，都无法清除此错误。

Bot 无法使用手机上的应用

Bot 工作时，请在手机上保持 Grok Bot 打开，并通过你与自己拥有的 Bot 之间的私聊提出请求。在手机上打开 Settings → Connect apps，选择 iPhone 或 Android（位于 All 旁）。如果应用显示 Denied，选择 Open Settings 开启权限。参见让 Bot 使用手机上的应用。

@bot 在 X 上没有回复

部分地区尚不支持提及 @bot。如果帖子含视频、同时提及 @grok 或未通过内部审核，@bot 也会保持静默。参见在 X 上提及 @bot，了解常见原因及 @bot 各种回复的含义。

应用启动时卡住

完全退出并重新启动应用。在 Mac 上请使用菜单栏的 Quit。如果每次启动都卡住，请联系支持团队，提供你的平台和 Grok Bot 版本。

Grok Bot 提示需要更新

如果当前版本已发布超过 14 天且有更新的版本，Grok Bot 会要求更新。窗口会被 Update required 提示覆盖，说明当前版本已不再受支持。选择 Update 并等待下载，然后选择 Restart to update。整个过程中，你的 Bot 会继续在云端运行。如果下载失败，选择 Try again，或选择 Download the latest version 自行安装。

在 Linux 上，该屏幕可能会显示一条命令。选择 Copy command，在终端中运行，再重启 Grok Bot：

• Debian 或 Ubuntu：sudo apt update && sudo apt install --only-upgrade grok-bot
• Fedora 或其他使用 RPM 的系统：sudo dnf upgrade --refresh grok-bot

如果提示下载并安装最新软件包，请按提示操作，再重启 Grok Bot。

在 iPhone 和 Android 上，选择 Update Grok Bot，从 App Store 或 Google Play 获取新版本。

更新 Grok Bot

Grok Bot 应用和 Bot 的电脑分别更新。

• 桌面应用会自行检查更新。如果有更新就绪，账号菜单会显示 New update available。选择 Install，再选择 Restart to update。
• 要手动检查，请打开 Settings → Updates → Check for Updates。如果更新已就绪，请选择 Restart to Update。默认开启 Automatic Updates，下载完成的更新也会在你离开电脑时安装。
• 通过 Linux .deb 或 .rpm 软件包安装时，Check for Updates 只会提示有新版本。请使用包管理器更新，例如运行 sudo apt update && sudo apt install --only-upgrade grok-bot 或 sudo dnf upgrade --refresh grok-bot。
• 手机应用通过 App Store 或 Google Play 更新。
• 要重建云端电脑，请打开 Settings → Computer 并选择 Update Bot's Computer。

更新桌面应用不会重置云端电脑。产品变更见更新日志。

如果 Grok Bot 为更新而关闭，但仍停留在旧版本，请在账号菜单的 Support → About 下查看版本，完全退出并重新打开 Grok Bot，然后再次选择 Check for Updates 和 Restart to Update。如果版本仍未变化，可从 cursor.com/dashboard/bot 下载最新版本并覆盖安装。Bot 和聊天归属你的账号，重装后仍然保留。在 Linux 上，请执行对应系统的更新命令。如果每次都回到旧版本，请联系支持团队，提供版本号和平台。

联系支持团队之前

要从桌面应用报告问题，请打开账号菜单，选择 Support → Send Feedback。Mac 上也可以从菜单栏选择 Help → Send Feedback。如果问题发生在当前对话中，请确认已勾选 Include current conversation ID。在手机应用中，打开 Settings，轻点 Send Feedback；如果问题只涉及一个 Bot，请选择它并保持 Include Bot ID 开启。

如果需要支持团队协助，请使用 Grok Bot 账号的邮箱发邮件至 support@x.ai。询问计费和取消订阅时也使用该地址，简要说明问题即可。

要查看版本，请打开账号菜单，选择 Support → About，再选择 Copy version info，即可复制版本号、发布通道和操作系统信息。要复制请求 ID，请右键点击消息并选择 Copy request ID，或将鼠标移到消息上，打开 More message actions 并选择 Copy request ID。如果菜单没有这个选项，说明消息没有请求 ID，请改为附上错误文字和截图。

请准备：

• Grok Bot 账号的邮箱地址
• Grok Bot 版本及平台：Mac、Windows、Linux、iOS 或 Android
• 你原本要执行的操作，以及 Bot 或例行任务的名称
• 完整的错误消息，或错误页面、套餐页面的截图
• 问题发生的大致时间和时区
• 完整的请求 ID 或对话 ID（如果有显示）
• 已尝试的排查步骤，如重试、重启应用或更新 Grok Bot 的电脑

请勿提供密码、一次性验证码、私钥或其他秘密值。