教程 ↗

Grok Bot 开发者上手指南:使用资格、共享环境与任务设置

基于截至2026年10月的官方文档,梳理Grok Bot的使用资格、单账号共享云电脑机制与任务边界,并附带可下载的本地缺陷复现练习包,帮助开发者配置首个可核对的交接任务。

手头有一个算不对结果的中位数函数、一份规格说明和一段报错日志,想交给 Grok Bot 跑一遍并拿回一份可直接核对的复现报告——这是测试这位 AI 队友最直接的切入方式。本文依据截至 2026 年 10 月的官方公开文档编写,并配套打包了一份构造好的合成练习材料(下载 bug-reproduction-starter.zip)。示例代码本身已在本地完成核对,尚未交给 Grok Bot 执行;你可以直接用这套不含真实凭证的材料,走通从资格检查、环境设置到结果验收的完整流程。

Grok Bot 共享云电脑与独立角色关系示意 图:同一账号下的多个 Grok Bot 保持独立对话与角色上下文,但共用一台持久云电脑的文件系统与浏览器登录。

核对订阅路径与账号关联

准备派发任务前,第一步是确认当前账号拥有 Grok Bot 的使用资格。根据截至 2026 年 10 月的官方套餐说明与价格页面,能否打开并运行 Bot 取决于订阅体系、存量套餐映射以及账号是否完成关联,并不是只要在 X 上有过付费就能直接解锁。

订阅与资格路径适用条件与额度规则
The X Subscription(新体系)个人或团队席位的 Premium($30/月,税费另计)、Super、Ultra 包含 Bot;Plus 与 Free 不含。采用覆盖 Cursor、Grok 与 Bot 的每周共享池,超出可用预付 credit。
Legacy Cursor 存量订阅Legacy Cursor Pro、Pro+、Ultra 及自助式(self-serve)Teams 继续保留使用资格,按存量规则计费。
个人 Grok 与 X 账号关联个人版 SuperGrok、SuperGrok Plus、Heavy 或 X Premium+ 需关联至 Cursor 账号;若与存量 Cursor 订阅同时关联,额度不叠加,取较大的一份 grant。

对于 Grok Business 与免费试用,适用规则各自独立:Grok Business 需要分配有效的自助式(self-serve)Grok Business seat 才可使用(定制企业合约另询官方);而免费试用(free trial)提供的是 7 天窗口期内的使用额度(usage credit),并非无限期或无限量免费。此外,账号关联操作一旦完成可能无法移动,操作前建议先对照官方资格矩阵,不要盲目合并账号。

如果你已经处于上述付费层级却仍提示无权限,可以按四个步骤依次排查:

  1. 确认当前登录桌面或移动客户端的,正是承接使用资格的那个 Cursor 账号;如果资格来自个人 SuperGrok 或 X Premium+ 订阅,还需核对该 Cursor 账号关联的是实际付费的那个 Grok 或 X 账号。
  2. 若资格来自个人 SuperGrok 或 X Premium+,检查是否已在网页端完成与 Cursor 账号的关联。
  3. 核对团队席位状态:新体系 The X Subscription 的团队成员需要拥有有效的付费 seat;存量自助式(self-serve)Cursor Teams 的现有每位成员默认已包含 Bot 资格,无需再额外申请 Premium;Grok Business 则需确认已分配有效的自助式(self-serve)Grok Business seat,其他企业定制合约请直接向官方查询。
  4. 检查隐私与存储设置:所有 Grok Bot 运行都要求开启云端数据存储(requires cloud data storage),只要账号开启了 Legacy Privacy Mode 就无法使用。若核对无误仍受阻,请直接按官方支持渠道处理。

至于同生态下的其他入口,按各自用途区分即可:Grok Bot 是运行在持久云电脑上、具备跨应用操作与后台运行能力的 AI 队友;如果你需要安装在本地或流水线中通过 TUI、Headless 或 ACP 改代码的工具,应查看 Grok Build;如果要在自有服务里发请求调模型,则使用 xAI API(需 Console 账号、credits 与 API key)。至于 Telegram 或 Discord 桥接方案,需要开发者自己准备运行环境和平台凭据,不属于官方托管的 Bot 客户端。

理解共享云电脑与账号边界

确认资格后,需要先了解文件上传后会落在哪里。根据 2026 年 10 月 7 日更新的概览文档与常见问题,同一账号下创建的所有 Bot 共享一台属于用户的持久云端电脑,而不是每个 Bot 分配一台独立虚拟机。

官方文档关于多个 Bot 共享单台电脑的说明截图 图:官方文档说明同一账号下的所有 Bot 共享一台云端电脑、文件系统与已登录的浏览器会话(来源:Grok Bot Overview)。

这台云电脑带有浏览器、文件系统和终端。所有 Bot 都能访问其中的共享文件、浏览器会话与已保存的登录状态。与此同时,每个 Bot 拥有各自独立的对话记录、角色上下文和专属屏幕(screen);多个 Bot 可以并行开展推理、文件处理或连接器调用,而单个 Bot 在自己的屏幕上一次运行一个计算机操作(computer-use)任务。

因此,官方明确提示不能把不同的 Bot 当作安全边界。创建多个 Bot 有助于拆分不同工作角色与上下文,但任何写入云电脑的文件或登录的网页会话,对同账号下的其他 Bot 依然可见。在本次复现练习中,我们只使用公开合成材料,不上传真实 token、客户日志、私有代码或连接生产系统。

客户端准备与新建 Bot

根据 2026 年 10 月 16 日更新的上手指南,日常创建和运行任务需要使用桌面端(支持 macOS Apple Silicon/Intel、Windows x64/Arm64、Linux x64/Arm64)或移动端(iOS/Android)应用。在浏览器里阅读文档或打开共享预览,并不等于拥有完整网页操作台;而在 X 上通过 @bot 互动需要预先完成账号关联、建好自己的 Bot 且符合地区资格,生成的结果最终仍保存在 Bot 客户端里(参考 Tag on X)。

从 x.ai/bot 下载客户端后,点击 Sign in 跳转到浏览器完成 Cursor 账号认证,再返回应用即可。接着点击 New -> Create new Bot,填写三个基本字段:

  • Name:Bug Repro Analyst

  • Primary job:复现数值函数缺陷并输出可核对的对比报告

  • Description:读取上传的源码、规格说明与报错日志,在临时目录运行最小复现脚本,区分实际运行输出与静态代码推断,生成供工程师审阅的 Markdown 报告。

如果后续任务遇到网页登录、验证码或两步验证,客户端允许用户临时接管电脑输入(会话会留在共享电脑中);不过本次练习只读取随消息上传的本地文件,不需要接管浏览器。

合成练习包与已知代码缺陷

根据文件与结果文档,桌面端支持上传 CSV、JSON、YAML、源代码与纯文本,单次最多附加 6 个文件。解压本文提供的 bug-reproduction-starter.zip 后,你会看到 median.mjs、specification.md、synthetic-log.txt 以及中英文任务说明 task-zh.md、task-en.md。向 Bot 发送任务时,任选一份任务说明连同其余三个文件上传,正好是 4 个附件。

包内的 median.mjs 只导出了一个 4 行的中位数计算函数:

export function median(values) {
  const sorted = values.sort();
  return sorted[Math.floor(sorted.length / 2)];
}

对照 specification.md(规格限定输入仅为有限数字组成的数组,无需扩展成复杂通用库),这段实现存在四处具体缺陷。作者已在本地(Node v26.0.0)对这套夹具做了核对——注意 median.mjs 只导出函数,直接执行文件不会打印任何内容,本地若想自行复核,可通过单行命令导入调用(本地安装 Node 只是读者的可选核对方式,不是使用 Grok Bot 的前提):

node --input-type=module -e 'import {median} from "./median.mjs";console.log(median([2,10,3]))'

本地核对确认的四项实际表现如下:

  1. 奇数长度字典序排序错误:输入 [2, 10, 3] 时,规格期望按数值升序得到 [2, 3, 10] 并返回 3。但 values.sort() 默认按字符串字典序排成 [10, 2, 3],本地实测返回 2。
  2. 偶数长度未取中间两数均值:输入 [1, 2, 10, 20] 时,规格期望返回 (2 + 10) / 2 即 6。当前代码先按字典序排成 [1, 10, 2, 20],再直接读取索引 2 处的元素(Math.floor(4 / 2)),本地实测返回 2。
  3. 空数组未抛异常:输入 [] 时,规格要求抛出 RangeError,当前代码直接返回 undefined。
  4. 原地修改输入数组内容:规格要求不改变传入数组的内容,而调用 median([2, 10, 3]) 后,原数组内容被原地改成了 [10, 2, 3]。

包内的 synthetic-log.txt 是作者构造的练习夹具,不含任何客户或线上数据。把材料交给 Bot 时,需要看它能否把这些预先写定的期望与它在云电脑上跑出的实际记录清楚分开。

发送任务提示词

官方上手文档建议首次派发任务时写明目标结果(outcome)、输入来源(sources)、限制条件(constraints)、交付物(deliverable)以及何时交回人工审阅(review point)。完整的任务说明已放在压缩包的 task-zh.md 中;如果你想直接在对话框里输入,可以复制下面这段 7 行的精简版提示词(它概括了核心要求,并非与下载包内的长文档逐字相同):

请基于随附的只读文件 median.mjs、specification.md 和 synthetic-log.txt 核对中位数函数的缺陷。

1. 输入与目录:严禁修改或覆盖原附件;若环境有可用 Node.js,请在新建的临时目录中编写并运行最小复现脚本,记录 Node 版本、执行命令与实际输出。
2. 证据区分:若运行环境不可用或报错,如实报告原因,严禁编造输出;报告中必须标明每项结论来自“实际运行”还是“静态代码推断”。
3. 输出表格:在 reproduction-report.md 中生成逐用例对比表(含 Case、Input、Expected、Actual、Evidence),覆盖 [2,10,3]、[1,2,10,20]、[] 及原数组内容是否被修改。
4. 代码依据:分别说明字典序排序、偶数中位数、空数组处理与原数组被修改的代码原因或待验证假设。
5. 动作限制:不得修改临时目录外的文件,不得联系他人、访问外部账号,不得执行 commit/push/开 PR/deploy 或触碰生产系统。
6. 人工审阅:可在报告末尾附上修复代码提案,但写完 reproduction-report.md 后请立即停下交回人工审阅,等待下一步确认。

需要留意的是,提示词里的限制条件只是向 Bot 声明任务边界,并不能从机制上保证它绝对不会越界改写文件。因此任务停下并交回给你之后,仍然需要检查它的实际操作记录与文件状态。

验收报告与保存日常流程

拿到 reproduction-report.md 后,重点看里面有没有可复核的原始证据,而不是只看总结写得是否漂亮(关于如何核对代理交付物与最终状态,可延伸阅读站内的个人代理评估实践)。

你可以按三件事完成验收:首先看报告是否贴出了具体的导入执行命令、复现输入断言,以及 [2, 10, 3] 和 [1, 2, 10, 20] 实际输出为 2、[] 输出为 undefined 的记录;其次检查它是否用调用前后的数组内容对比证明了 values.sort() 的副作用;最后,可以在对话里追加一个未见过的有限数字样例(例如 [-5, -1, -10]),看它能否按同样标准补上一行验证结果。

但也要注意,单次合成任务跑通,并不证明提示词里的所有约束在未来都会被严格遵守。根据技能与例程文档,Skill 用于保存一套经过验证的任务方法,Routine 则用于安排某个 Bot 何时自动运行。最稳妥的下一步,是先用这类单次任务(one-time task)反复核对输入输出与操作记录,确认步骤足够稳定后,再将其保存为可复用的 Skill 或配置定期运行的 Routine。

← 返回列表