中文文档
API Console

开始

开始使用

查看 Markdown
创建 API Key 了解 Grok 4.7

设置 Grok Bot，创建你的第一个 Bot，并交给它一个有用的任务。

开始之前

你需要：

  • 符合条件的套餐：任一 Cursor 个人付费套餐或 Cursor Teams 套餐，或者与 Cursor 账号关联的个人 SuperGrok、SuperGrok Plus 或 SuperGrok Heavy 订阅（参见套餐与计费）

  • 适用于 macOS、Windows 或 Linux 的 Grok Bot 桌面应用

  • 一个可供首个 Bot 开展实际工作的应用或网站

你也可以在移动设备上设置并使用 Grok Bot。

Grok Bot 需要云端数据存储。使用 Legacy Privacy Mode 的账号必须切换到受支持的 Cursor 数据设置，Grok Bot 才能启动。打开 Cursor 隐私设置查看账号设置。

1. 安装桌面应用

打开 Grok Bot 下载页面，选择适合你的电脑的下载版本。

macOS

  1. 选择 Apple silicon 或 Intel 下载版本。

  2. 打开下载的磁盘映像。

  3. 将 Grok Bot 拖到 Applications。

  4. 打开 Grok Bot。如果 macOS 要求确认，选择 Open。

要确认需要哪个下载版本，请打开 Apple menu → About This Mac。如果有 Chip 字段，说明是 Apple silicon；如果有 Processor 字段，说明是 Intel。

Windows

  1. 选择 x64 或 Arm64 下载版本。

  2. 运行安装程序。

  3. 从 Start 菜单打开 Grok Bot。

要确认架构，请打开 Settings → System → About → System type。

Linux

每个稳定版本都会发布 Linux 构建。可在更多下载中获取，页面为 x.ai/bot。

  1. 根据发行版选择 x64 或 Arm64 下载格式：Debian 和 Ubuntu 使用 .deb 软件包，Fedora 和 RHEL 使用 .rpm 软件包，其他发行版可使用 AppImage。

  2. 使用包管理器安装 .deb 或 .rpm，或为 AppImage 添加执行权限后运行。

  3. 从应用启动器打开 Grok Bot。

要检查架构，请在终端运行 uname -m：x86_64 表示 x64，aarch64 表示 Arm64。

Grok Bot 会自动检查更新。你也可以在 Settings → Updates 中使用 Check for Updates。

2. 登录

  1. 在欢迎界面选择 Sign in。如果已进入应用，在 Settings 中使用 Sign In with Cursor。

  2. 在打开的浏览器窗口中完成身份验证。

  3. 浏览器确认登录后，返回 Grok Bot。

  4. 如果你的访问权限来自 SuperGrok 订阅，请在应用提示时关联订阅。在 iPhone 和 Android 上，访问页面先提供 Link Grok Account，随后提供 Finished Linking? Refresh My Status；在桌面端，Settings → Usage & Billing 中提供 Link SuperGrok Heavy（标签会显示适用于你账号的 SuperGrok 套餐名称）。

Grok Bot 使用你的 Cursor 账号。如果你的组织要求单点登录（SSO），请完成正常的组织登录流程。

首次使用时，Grok Bot 会介绍 Bot、共享电脑和 routine，然后询问你使用哪些工具。这些回答会影响第一批队友建议；它们不会自行连接或修改这些工具。电脑设置会在后台运行，最后一步会打开 Meet a future teammate。

3. 创建你的第一个 Bot

从 Meet a future teammate 选择一个建议的队友，或选择 Create your own，并为 Bot 提供：

  • 一个简短名称

  • 一个主要工作

  • 一段说明，描述它应如何工作

例如：

Name: Piper
Job: Product performance
Description: 使用我们的可观测性工具调查产品性能问题。保留链接和截图，区分证据与假设，并返回一份简短摘要，把影响最大的问题放在最前面。绝不要更改生产设置。

专注于明确职责的 Bot 比包揽所有工作的 Bot 更容易积累有用的上下文。工作自然拆分成不同角色后，可以通过 New → Create new Bot 添加更多 Bot。

4. 给它第一个任务

在输入框中输入内容，或使用 Start voice input 口述（桌面端快捷键为 Cmd/Ctrl+D；iPhone 和 Android 上为 Start dictation）。你也可以选择 Start voice chat 开始实时对话。

一个好的请求包含：

  1. 结果： 应该完成什么？

  2. 来源： 哪些应用、网站、文件或对话重要？

  3. 约束： Bot 必须避免什么，或在做什么之前必须询问？

  4. 交付物： 它应该返回什么？

  5. 审阅点： 它应该在什么时候停下来等你？

如果想要一个五分钟内可得到、且不需要连接器或网站登录的首次结果，可以附上一份文档并尝试：

用五个要点总结这份文档。把每个日期、决定和未决问题列在单独章节。为每一项引用对应页面或章节。不要更改源文件。

然后再尝试一个需要使用你某个工具的任务：

打开我们的分析仪表盘，对比本周与过去四周的新用户激活情况。找出步骤层面变化最大的环节，并起草一份简短调查计划，包含相关图表链接。不要更改任何仪表盘。如需登录，请让我登录。

在允许外部变更之前，请查看审批、安全和隐私。

5. 登录它需要的工具

当 Bot 到达一个需要身份验证的应用时，它可能会请你接管电脑。

  1. 从对话中打开 Agent Computer。

  2. 选择接管控制。

  3. 自己输入密码、passkey、双因素验证码，或完成 CAPTCHA。

  4. 将控制权还给 Bot。

浏览器会话会保留在你的共享 Grok Bot 电脑上，因此在合适的情况下，其他 Bot 也可以使用同一个已登录会话。

对于受支持的服务，你也可以从侧栏的 Marketplace 安装插件，并在浏览器中完成身份验证。

6. 审阅结果

要求 Bot 修改任何不完整或格式错误的内容。明确说出应长期保留的偏好：

以后每周报告都使用这种格式：五个要点，源链接内联，最后一节命名为“需要决定”。

当流程稳定后，让 Bot 将其保存为 skill，或创建 routine。

后续步骤

最后更新：2026 年 9 月 21 日