第 25 章 常见问题与排错

遇到报错或卡顿，千万别盲目重装或重置，这会冲掉刚写好的环境和临时脚本。

1. 先看服务状态。
2. 再排查是本地网络、插件授权、云端环境还是每周额度的问题。

登录与身份验证

账号与订阅限制

Grok Bot 依托 Cursor 运行，与 Grok 手机端付费墙及每周额度限制（Weekly SuperGrok Limit）无关。

个人版支持 SuperGrok 与 Plus、Heavy 版本，以及 X Premium+；SuperGrok Lite 与 Grok Enterprise 无法关联个人账户，企业席位由管理员统一分配。

账户邮箱注册后无法修改，关联 Cursor 是一次性永久绑定。绑错账号无法自行转移，必须联系人工客服处理。

绑定与登录步骤

1. 个人绑定：打开 cursor.com/bot/onboarding 或在客户端进入 设置 > 用量和计费，在 管理方案 下点击 通过 Grok 获取访问权限（仅在能提升当前用量层级时显示）。

2. 企业席位：拥有 Grok Business 席位无需在方案页手动绑定，完全退出后在登录页点击 Sign in with Grok 即可。

3. 服务确认：遇到异常先访问 status.cursor.com 查看 Grok Bot 实时状态，操作要求详见登录 Grok Bot。

   服务故障时等待官方修复，切勿重装应用或重置电脑。

故障排查与验收

客户端版本过旧会引发协议不匹配；突发认证故障建议静置 30 到 60 分钟再试。验收标准是账号邮箱、订阅归属与客户端登录状态一一对应。

故障现象	正确处置路径	严禁操作
循环跳回登录页	清理 cursor.com 与 x.ai 的 Cookie，用桌面端无痕模式认证	连续卸载重装客户端
找不到关联入口	确认当前账号层级低于待绑定方案，未达上限	注册新账号重复购买
提示 Model provider is overloaded	复制报错的 Request ID，等待 2 分钟重新发送	立即点击 Reset 重置电脑
提示邮箱需变更	重新注册账号并迁移资产	尝试在设置中强改绑定邮箱

向 Bot 发送提示词确认登录状态。

请检查当前运行环境的网络连通性与 Cursor 身份验证状态，汇报当前登录的用户环境标识，但不要输出任何敏感 Token。

云端电脑与环境恢复

所有 Bot 共享同一台云端电脑。对话记录独立存在数据库，崩溃清空都不丢。

提示 Reconnecting、Couldn't Reach Grok Bot's Computer 或 Bot failed to respond 时：

1. 等 1 到 2 分钟点 Retry。
2. 彻底退出应用。Mac 按 Cmd+Q，Win/Linux 退出托盘，别只关窗口。
3. 进设置 > 计算机点更新。备份未完或 Bot 工作时切勿中断。
4. 卡住点 Recover。
5. Reset 是最后手段。快照覆盖会丢未同步修改。详见Grok Bot 电脑。

操作	现场保存	环境影响	场景
Retry	原样保留	无影响	网络抖动
Update	等备份完	全留软件；整机清自装包	官方补丁
Recover	存现场建机	移除自装应用与环境	卡死损坏
Reset	快照覆盖	丢未同步修改	连不上兜底

电脑状态变绿显示已连接、终端正常且配置完整就算修好。

• 遇到 SSO 登录，点卡片上的 Take over 手动验证，搞定点 I'm done。
• 密钥与网络：在设置 > General > Security Key 开 Use hardware security keys 插 YubiKey；遇验证码在设置 > 计算机勾“通过此计算机路由流量”。
• 本地执行：在设置 > 计算机开“在此计算机上执行”（跑命令先确认）。详见Grok Bot 设置。
• 磁盘告警：报 Computer is low on disk space 时点 Go to Disk Saver，必须人工确认才删。

请检查当前云端计算机根目录与工作目录的磁盘占用情况，找出体积超过 200MB 的文件与缓存目录，列出清单供我确认，不要擅自执行任何删除命令。

例程管理与自动化排错

例程在云端自动跑，关机也生效，支持定时、Webhook 与 Slack 推送。

1. 查状态与时区：Details 确认非 Paused（手机看 Active）；在“设置 > Bot > Timezone”手动选时区，跨国别用 Auto-detect。
2. 定时触发时机：只等下个周期（09:05 设 09:00 明早跑），即时测逻辑点 Test。
3. 校验 Webhook：POST 带 Authorization: Bearer <key>。200 仅代表入队，结果去聊天窗口看；非 200 为密钥错或暂停。
4. 收窄 Slack 触发：必须限频道与过滤词，防闲聊几小时烧光配额。详见例程。

手机端“运行历史”查 Running、Succeeded、Failed；显示 No runs yet 为未触发。

故障	原因	修复
无动静	Paused/未到点/时区偏差	查 Active，点 Test，校对 Timezone
401/403	漏 Token/密钥重置/例程已删	重新复制 header 覆盖配置
Slack 无回应	旧消息/频道或词未命中	只认新消息，核对频道白名单与短语
配额消耗快	间隔过短/大群无过滤词	暂停例程，拉长间隔，限定运维频道

创建与修正自动化例程提示词：

请修改名为“工单同步”的例程：仅在 #ops-alert 频道出现包含“[P0-Error]”文字的新消息时才触发，忽略其他日常聊天，并列出更新后的 When to run 描述。

用量异常与配额控制

Grok Bot 配额按周重置。基础额度用完会中断回复，这属于正常的配额熔断。一次性试用额度跑复杂任务耗尽后无法恢复。

操作与防坑

1. 恢复额度：等每周刷新，或在 设置 > 用量和计费 开按需用量，也可升订阅。
2. 设定封顶：客户端或网页 cursor.com/dashboard 设限。在跑任务不强切，扣费微超几个百分点属正常。
3. 额度对齐：外部账号不叠加取高者（Pro 对应 SuperGrok/X Premium+，Pro+ 对应 SuperGrok Plus，Ultra 对应 SuperGrok Heavy）。
4. 移动端退订：多端共享订阅。商店付款需在 Apple ID 或 Google Play 退，官方不直退，见方案和计费。

验收标准

场景	操作	边界与坑点
防超额	客户端或控制台设月度限额	封顶拒新请求，在跑任务跑完才停
查用量	Bot 内部设置查实时剩余	外部 Grok 看板不互通
试用清零	排查大工程扫描或重构	一次性耗尽不恢复

请列出你当前账号下所有处于活跃状态的例程，评估它们各自的执行频率与触发条件，指出哪一个例程最容易引发高额用量消耗。

群聊、协作与辅助 Bot 治理

辅助 Bot 会进侧边栏并弹通知，改文件或连外网会触发 Auto-review 审批。

操作与审批

1. 降噪隐藏：桌面端右键选 Hide from sidebar 或发指令关通知；手机端进配置关通知。

2. 恢复误藏：桌面在 隐藏的机器人 选 Show in sidebar，手机选 Unhide。严禁为找 Bot 去点云端 Recover 或 Reset。

3. 审批与白名单：高频操作点 始终允许（存入 设置 > Bot > 自定义规则）；冲突先询问，显示“由管理员强制要求”的不可跳过。

   规范见 Grok Bot 操作指南。

验收标准

侧边栏无杂乱 Bot，日常高频免打扰自动通过。

场景	超时	表现	对策
前台人工	永久等待	持续挂起	核对后允许或拒绝
后台/Webhook	约 10 分钟	变 Expired 取消	配“始终允许”或开通知
管理员强制	视场景	无法跳过	必须人工授权

请梳理我们在此会话中频繁执行的文件读取与构建指令，为它们生成一组最小权限的安全规则建议，以便我添加到 Auto-review 的自定义白名单中。

插件与外部应用连接

授权排错

Added 只表示已安装，不等于已登录。卡片没弹去侧边栏手动验证。授权须在 10 分钟内完成，超时点 Reopen；持续报错点 Remove 删掉重装。

状态	处理
Added / Needs auth	点「验证身份」去浏览器登录
Connected 报错	发送带插件名的指令刷新会话
Disabled by team admin	找团队管理员解禁

多账号与验收

1. 多账号：在「连接应用」> 插件 > Accounts 点 Add Another Account（手机端点 Authorize new account）并打标签。对话指明标签调用；无按钮则仅支持单账号。
2. 验收：状态显示绿色 Connected 且标签清晰，发指令能一次准确调用。

详见连接插件。

请刷新当前已连接的插件列表，使用带有“工作”标签的账户连接，读取最近更新的 3 个页面，确认授权是否正常。

账号注销与数据清理

Grok Bot 共用 Cursor 账号，删号不可逆，无法单独保留 Cursor。换电脑用直接退出登录或卸载就行。

终端注销步骤

注销前务必取消自动续费，避免账单纠纷。

1. 手机端（iOS/Android）：点头像进“设置” > 账户信息 >“删除账户”，网页验证中键入“删除”两字确认。
2. 桌面与网页端：客户端无法直接注销。登录 cursor.com/dashboard >“设置” >“更多” >“删除账户”确认。
3. 企业或团队席位：个人无法独立注销，必须联系管理员解绑或提工单。条款见删除你的 Grok Bot 账户。

资产清理与避坑

资产与订阅	处置结果	必做处理
云端对话与环境	30 天内物理擦除，快照销毁	提前导出代码和对话，下载文件
本地文件	完好无损	无需处理
商店与 X 独立订阅	不会自动取消	需去 Apple、Google 或 x.ai 手动退订

获取官方支持与工单规范

怎么做

本地排查没用时，发邮件到 hi@cursor.com。别只发“我的 Bot 坏了”这类模糊描述，邮件里带齐这六项。

1. 账号凭证：注册邮箱。
2. 运行环境：平台与客户端版本号。从账户菜单 > 支持 > 关于，点 Copy version info 复制。
3. 准备执行的操作：说明故障前想跑什么任务。
4. 真实报错凭据：完整错误弹窗、控制台报错或计费截图。
5. 排查记录：写明做过哪些排查，避免客服给重复建议。
6. Request ID：右键报错消息或悬停点 More message actions 选 Copy request ID。若没有该项，必须附原始报错文本与全屏截图。

Linux 若弹 Update required 且自动更新失败，按发行版在终端执行更新指令：

• Debian / Ubuntu：sudo apt update && sudo apt install --only-upgrade grok-bot
• Fedora / RPM 系列：sudo dnf upgrade --refresh grok-bot

怎么做

收件人：hi@cursor.com
主题：【Grok Bot 故障申报】云端电脑持续重连且 Recover 失败 - [你的账号邮箱]

支持团队：
我的账号遇到了云端电脑无法连通的故障，无法正常执行任务，以下是详细环境与排查信息：

1. 账号邮箱：developer@example.com
2. 版本信息：Version 1.2.4 (Channel: stable, OS: Darwin x64 23.4.0)
3. 故障发生场景：我尝试让 Bot 运行自动化部署脚本，终端在拉取镜像时中断。
4. 核心报错信息：界面持续提示“Couldn't Reach Grok Bot's Computer”，伴随“Bot failed to respond”。
5. 已尝试的排错操作：
   - 已彻底 Quit 应用并重启；
   - 尝试在“设置 > 计算机”执行 Update，提示备份未就绪；
   - 尝试点击 Recover，重试一次后依然在进度条处卡住报错；
   - 查看 status.cursor.com 确认官方各项服务状态正常。
6. 请求 ID (Request ID)：req_98af7c32e01b44d7a1
7. 附件：包含当前报错卡片截图及“设置 > 计算机”面板状态截图。

请协助在后台检查该实例的宿主节点状态，谢谢。

做到什么程度算好

发信后能收到自动回执，且技术无需二次追问即可调出日志。详细规范见获取帮助。

典型故障排错案例

案例一：云端电脑 Reconnecting 循环

报 Couldn't Reach Grok Bot's Computer 时，千万别先点破坏性的 Reset。

1. 访问 status.cursor.com 确认服务正常，按 Cmd+Q 重启应用。
2. 进设置 > 计算机，若提示未及时暂停，等约 5 分钟让后台超时。
3. 待 Recover 电脑亮起后点击恢复并重跑安装脚本，保全历史脚本与登录态。

案例二：Slack 触发器用量雪崩

因监听 3000 多人的 #general 全量闲聊，每周用量在 24 小时内归零。

1. 先在支出面板设死按需月度限额，防止信用卡扣费。
2. 将例程切为 Paused 止血。
3. 规则收窄为“仅在 #bot-help 且被 @Grok 时触发”。
4. 点 Test 单次验证后再恢复上线。

案例三：Notion 认证失效与接管登录

Notion 报 Action needed 且 Okta SSO 拦截时，必须用 Take over 在内置浏览器闭环认证。

1. 见 Needs auth 提示后，点击卡片中的 Take over 接管。
2. 在云端内置浏览器输工号过二次验证，点 I'm done。
3. 在 Accounts 点 Add Another Account 授权个人空间，打上“个人库”标签防凭证冲突。

容易踩的坑

1. 丢聊天别点 Reset，会抹掉代码。找回先退出重启，核对 Cursor 账号或看隐藏机器人。
2. 14:05 设 14:00 例程次日才跑，测逻辑点 Test。
3. Slack 大群无触发词监听，打招呼会烧光整周额度。
4. 删 App 仍会扣费，退订去 Apple ID 或 Google Play 订阅中心取消。
5. Updating 时点 Reset 会损坏文件系统，只能找人工。
6. 插件 Added 需确认 Connected；显示 Needs auth 需浏览器授权。
7. 更新、Recover 或 Reset 清空 node_modules 与 .venv，依赖写进初始化脚本。
8. 审批卡片 10 分钟后 Expired 终止，记得开通知或设“始终允许”。

做完怎么验收

• 查 status.cursor.com 无故障且邮箱正确。
• 进设置 > 计算机看绿灯，给 Bot 发基础 Linux 命令测回包。
• 例程保持激活，核对 When to run 时区，点 Test 跑通。
• 进设置 > 用量与计费，必须设定按需用量月度限额防天价账单。
• 连接应用显 Connected，写操作能弹 Auto-review 且手机有推送。
• 工单只留 Request ID 和 Copy version info，切勿泄露 Bearer Token 请求头。

延伸阅读

• Grok Bot 常见问题官方解答
• Grok Bot 操作与排错指南
• Grok Bot 电脑环境管理与灾难恢复
• 自动化例程与触发器详细配置
• 账号体系与注销说明
• 支持团队联系与工单规范
• Grok Bot 系统全局设置参考