使用 Grok Bot
使用电脑和应用
Bot 在一台配有浏览器、命令行和文件系统的持久化云端电脑上工作。即使你合上笔记本电脑,工作也会继续;文件、登录信息和浏览器会话会在任务之间保留。
一台电脑,由你的所有 Bot 共享
你账号下的每个 Bot 都使用同一台电脑:
- 浏览器 cookie 和已登录会话会共享
- 每个 Bot 都能看到文件
- 命令行凭据会共享
- 一个 Bot 可以接续另一个 Bot 保存的工作
这台电脑分配给你的用户账号,而不是某个单独的 Bot。如果你账号下的另一个 Bot 不应该使用某个凭据或文件,请不要把它放到这台电脑上。
每个 Bot 都会在共享电脑上获得自己的屏幕。因此多个 Bot 可以并行使用浏览器和桌面工具,不过一个 Bot 在自己的屏幕上同一时间只能运行一项电脑操作任务。这些屏幕是分开的工作界面,不是分开的安全边界。
不同用户之间严格隔离,每位用户都有专用且在硬件层面隔离的电脑。参见用户如何相互隔离。
查看电脑上的工作
点击对话右侧面板中的电脑预览,即可打开电脑,查看点击、输入、导航操作和当前状态。
你可以在工作继续时离开预览。关闭 Grok Bot 应用或你的笔记本电脑,不会停止云端工作。
接管敏感步骤
登录时,Bot 先使用 Vault 中保存的登录信息,再尝试已连接的密码管理器(例如 1Password),最后才会使用安全表单询问你。Vault 和安全表单中的值会直接填入网页,Bot 看不到这些值。网站通过邮件发送一次性验证码时,Bot 可以从已连接的 Gmail 或 Outlook 账号,或从自己的收件箱读取。结账时,Bot 可以使用 Vault 中保存的卡、你通过安全表单输入的卡,或已连接的 Link、X Money 等钱包。参见付款。
当表单无法完成某个步骤时,Bot 会将电脑交给你,例如:
- 单点登录或使用通行密钥
- 它无法通过的 CAPTCHA 验证
- 在另一台设备上批准操作,或扫描二维码
- 银行卡验证
- 网站明确要求真人操作
打开电脑,取得控制权,只完成卡住的那个步骤,然后让 Bot 继续。切勿将密码或一次性验证码粘贴到普通聊天中。对于 API 密钥或其他秘密信息,请在 Bot 提供的安全凭据卡中输入;字段会遮蔽输入,凭据不会写入聊天或展示给 Bot。参见 API 密钥和其他凭据。
登录一次
浏览器会话会持久保留,因此你通常不需要为每个任务重新登录。由于浏览器是共享的,为一个 Bot 登录后,其他 Bot 也可以使用该会话。
有些网站会让会话过期、强制短超时,或再次请求验证。请让 Bot 暂停并通知你,而不是尝试绕过检查。
连接应用
应用为 Bot 提供了操作 Gmail、Notion 和 Slack 等服务的结构化接口,比逐步点击网页更可靠。如果服务没有配套应用,或某项操作必须通过界面完成,可以使用浏览器。应用连接归属于登录 Grok Bot 所使用的同一账号。
- 在侧栏打开 Connect apps,或点击聊天中的 Connect 卡片。移动端请轻点左上角的头像,选择 Connect apps。
- 浏览或搜索所需应用,然后添加。
- 当 Grok Bot 提示 Authorize 或 Authenticate 时,在浏览器中完成服务提供方的登录流程。
- 如果登录未完成,在应用上选择 Reconnect,或在聊天卡片上选择 Reopen,重新打开登录页面。
- 确认该应用出现在 Installed 中。
在聊天中输入 @ 即可将应用添加到任务。
Added 表示应用已安装。登录需要另行完成。如果 Bot 提示找不到应用,请打开该应用,选择 Authenticate(手机上为 Authorize);需要这样操作的状态为 Needs auth 或 Disconnected。
也可以让 Bot 代为处理,例如“添加 Linear 应用”。Bot 会搜索目录,将应用安装到你的账号,并在需要你登录时显示 Connect 卡片。从你的下一条消息起,应用中的工具即可使用。Bot 还可以添加不在目录里的 MCP 服务器,既可通过 URL 添加,也可通过在 Bot 电脑上执行命令启动。由命令启动的服务器也可供你的其他 Bot 使用。添加位于私网或使用私有证书颁发机构的服务器前,会先请求你的批准。
当 Bot 代你移除应用时,该应用添加的内容也会一并移除,而且你会退出登录;重新安装后需要再次登录。团队要求保留的应用无法移除。
- 应用由整个账号共享。 你运行的所有 Bot 都可以使用已连接的应用。队友的共享 Bot 使用你的账号前会先询问。
- 登录凭据保存在电脑之外。 OAuth token 由 Cursor 的连接器后端保管,Bot 不会拿到 token 本身,但可调用工具。
- 团队策略同样生效。 被团队连接器策略禁用的应用会显示 Disabled by team admin。请联系管理员启用。禁用应用不会阻止访问该服务的网站;要封锁网站,需要使用仅 Enterprise 套餐提供的 Network Controls。参见网络策略。
Email 应用有所不同,它会为 Bot 提供自有邮箱地址,无需连接你已有的邮箱账号。
已连接的应用能做什么
应用使用你授权的账号,只能执行该账号在相应服务中已有权限的操作。它不能提升你的访问权限,也不能更改共享权限。
- Google 日历: Bot 可以读取你有权查看的日历,创建和更新活动,查询空闲时段,以及回复你有权编辑的日历中的邀请。它不能更改 Google Meet 的等候室或主持人控制等设置,也不能添加 Zoom 链接,因为应用无法使用 Google 的 Zoom 插件。你可以自行把 Zoom 链接填入活动地点或描述,或先在日历中创建活动,再让 Bot 更新其他字段。
- Google Sheets: 对于关联的 Google 账号有权编辑的电子表格,Bot 可读取和编辑单元格。以 Viewer 权限共享的文件仍然只读。查找和打开文件使用 Google Drive 应用,它可以搜索和读取该账号有权打开的文件。
- Slack: 应用以你关联的 Slack 用户身份发帖,无需另行邀请一个机器人。它只能向该用户有权发帖的频道发送消息。要使用另一个 Slack 工作区,请连接对应的工作区。此功能与通过 Slack 消息启动例行任务相互独立。
- Gmail: 应用可以在已连接的邮箱中搜索和阅读邮件、起草和发送邮件,以及添加标签。Gmail 每次只能连接一个邮箱。要更换邮箱,先断开当前邮箱,再授权另一个。如果不希望 Bot 使用某个邮箱,请断开 Gmail。其他某些应用(如 Notion)允许连接第二个账号。
- X: 使用 X 插件需要在 X 开发者账号中有可用的 X API 额度。
如果 Google 提示需要管理员审核 Grok
使用公司 Google 账号时,在 Gmail、日历、Drive、Docs、Sheets 或 Slides 完成登录前,连接可能就被拦截了。Grok Bot 向 Google 登录时显示的应用名称为 Grok,并非 Cursor。此限制与 Cursor 的 Disabled by team admin 控制项相互独立。
如果 Google 页面显示 Your admin needs to review Grok,说明该 Workspace 尚未批准 Grok。如果页面上有申请访问按钮,请提交申请,等待管理员批准后再尝试 Authorize。IT 管理员可在 Google 管理控制台中批准 Grok:
- 打开 Security,依次进入 Access and data control、API controls。
- 打开 App access control,然后选择 Manage third-party app access。
- 添加名为 Grok 的应用。如果按名称找不到,请使用被拦截页面或管理员审核邮件中的客户端 ID。
- 为需要使用 Grok Bot 的人员将 Grok 设为 Trusted。
这项批准适用于这些人员连接的 Google 应用,但不会重新启用已在 Cursor 中关闭的应用。
如果页面显示 Access blocked,说明 Google 拒绝了登录。个人 Gmail 账号不需要公司管理员批准。对于公司账号,常见原因是 Grok 未被加入白名单,或管理员已阻止第三方应用。请 Google 管理员按上述步骤信任 Grok。更换浏览器或重新连接应用都无法解除 Google 管理员设置的限制。如果页面仍显示访问受阻,请联系支持团队,提供 Google 账号邮箱和被拦截页面的截图。
连接 1Password
通过 1Password,你的 Bot 可以使用 1Password 账号中的登录信息,在它们的电脑上登录网站。每次使用登录信息均由你在 1Password 中批准,并由 1Password 代填,Bot 看不到具体值。新版 1Password 集成正在逐步推出,支持 1Password 个人及 Family 账号,需要 1Password 8.12.42 或更高版本。
- 选择 Connect apps,打开 1Password(位于 Password Managers 下)。
- 在你的电脑上选择 Connect 1Password。
- 浏览器打开后,请在那里登录 1Password 并批准 Grok Bot。完成后 Grok Bot 会更新连接状态。
手机上可在 Password Managers 分组中打开 1Password(该分组位于 Connect apps),也可搜索它,然后在 1Password 中批准连接。如果手机显示 1Password can only be set up on a Mac,说明你的账号尚未开通新版集成,请改在电脑上的 Grok Bot 中设置。要停止使用,请在 Connect apps 中打开 1Password 并选择 Disconnect。
如果 Vault 中没有保存相应登录信息,Bot 会在聊天中发送标明网站名称的卡片:
- 选择 Review in 1Password。系统会打开 1Password 应用;如果该电脑未安装应用,则通过浏览器打开。
- 在 1Password 中选择本次要共享的具体登录条目,并批准请求。
- 1Password 将登录信息填入 Bot 的浏览器。
你共享过的登录信息可在以后的聊天中继续使用。如果 1Password 之后不再允许使用,Bot 会再次询问。1Password 不会填入支付卡信息;遇到它无法完成的步骤(例如使用通行密钥、单点登录或验证码)时,Bot 仍会请你帮忙。
1Password 只提供你自己 Personal 保险库中的登录条目(Family 账号中称为 Private),不提供共享保险库中的条目。请将登录条目移入或复制到这个保险库,再让 Bot 重试。如果完全没有出现审批提示,请将 1Password 应用更新到 8.12.42 或更高版本。
新版集成不再使用服务账号。此前已将 1Password 与 Grok Bot 配合使用的用户需要重新连接。以前共享给旧版集成的保险库中的登录条目,需要移至 Personal 或 Private 保险库才能使用。Connect apps 的 1Password 页面会显示涉及多少个条目。在 Mac 上,也可以选择 Move to Private;如果 1Password 提示需要批准,请予以确认。旧保险库仍会保留在 1Password 中。
| 提示 | 处理方法 |
|---|---|
| 1Password didn't finish connecting | 重新发起连接。如果你在手机上已有 1Password 账号,请选择 I already have 1Password 并用该账号登录。 |
| This 1Password account is already connected to another Grok Bot account | 先从其他 Grok Bot 账号断开 1Password,或连接另一个 1Password 账号。 |
| Reconnect required | 1Password 不再接受当前连接,选择 Reconnect。 |
| Sign in to the 1Password account you connected to Grok Bot, then try again | 登录之前关联的 1Password 账号,再让 Bot 重试。 |
| Access requests aren't turned on for your 1Password account | 请 1Password 管理员启用访问请求。 |
| This request already ended in 1Password | 让 Bot 重试,它会发送新请求。 |
| 1Password could not be opened | 自行打开 1Password 应用以审核请求。 |
| 提示你在 1Password 的 Integrations 下撤销 Grok Bot 的访问权限 | 在 1Password 的 Integrations 下撤销 Grok Bot 的访问权限,然后重新连接 1Password。 |
已知的应用问题
- Zoom 错误 4700: 目前从 Grok Bot 桌面应用发起 Zoom 授权会遇到错误 4700(Invalid redirect)。暂时没有替代方案,用户侧的更改无法解决。
- SharePoint AADSTS50011: Cursor 团队管理员在仪表盘的 Integrations 页面使用 Application-level permissions 连接 SharePoint 时,Microsoft 会在显示同意提示前报重定向 URI 不匹配。此问题与租户配置无关。请改用 Delegated permissions:在 SharePoint 卡片上选择 Connect team(或 Reconnect),选择 Delegated permissions,输入 Microsoft 租户 ID,然后登录 Microsoft。大多数工作或学校租户需要 Microsoft 管理员对 Sites.Read.All 执行一次同意。之后,每位成员在 Bot 第一次使用 SharePoint 时用自己的 Microsoft 账号登录,只能看到该账号原本就能打开的站点。如果成员看到“This team does not have the SharePoint integration”,管理员需先完成委托权限登录。
更多设置说明见连接应用。
为 Bot 申请邮箱地址
你可以在 mail.grokbot.com 为自己的 Bot 申请一个邮箱地址,例如 yourname@mail.grokbot.com。Bot 可以通过它收发、阅读和搜索邮件。有了邮箱地址,Bot 可以:
- 用自己的地址注册服务,获你同意后读取验证码或验证链接
- 收集收据、新闻简报和报告,并汇总给你
- 为你起草邮件(如摘要或进展更新),以及起草回复
- 从收件箱转发邮件并保留原有格式、图片和附件,此功能需要 Grok Bot 0.75.2 或更高版本
- 收到邮件时运行例行任务,也可限定只响应特定发件人
要申请地址,可以告诉 Bot:“给自己申请一个电子邮箱。”它会询问想用的名称,检查可用性并显示审批卡。只有你批准后才会实际申请。也可以打开 Connect apps,选择 Email,在 Choose a name 中输入名称(位于 Email address 下),然后选择 Create address。在 iPhone 和 Android 上,打开 Settings → Connect apps → Email。申请完成后,应用会显示邮箱地址及复制按钮。
名称可使用小写字母、数字、点、连字符和下划线,必须以字母或数字开头和结尾,最长为 64 个字符。不得使用 support、admin、billing、security、help、info、team、cursor、grok、xai 等保留字。
该地址也支持带加号的别名。发往 yourname+receipts@mail.grokbot.com 的邮件将进入与 yourname@mail.grokbot.com 相同的收件箱,因此无需额外申请地址即可为各服务分配不同别名。Bot 也可以从别名发信。监听某个别名的例行任务只处理发送给该别名的邮件,而监听基础地址的任务会处理所有来信。别名仅用于标记,任何人都能向其写信。如果任务只应处理特定人员的邮件,请保留发件人筛选条件。
- 地址一经申请即固定。 你只能拥有一个地址,不能重命名或删除。即使申请它的账号被删除,地址也永远不会重新分配。
- 邮箱归你账号下的所有 Bot 共用。 在你自己的聊天和例行任务中,所有 Bot 都可使用该地址。它不用于 Slack 消息串或他人与 Bot 的聊天,共享 Bot 也没有团队邮箱地址。
- 阅读邮件。 任何人均可来信。未通过垃圾邮件或病毒扫描的邮件会被去除正文和附件后保存,且不会触发例行任务。系统不提供收件箱视图或新邮件通知,可直接询问 Bot,例如“你的收件箱今天收到了什么?”最近一分钟内收到的邮件可能暂时无法搜到。每封来信最多接受 10 个附件,每个最多 10 MB,总计最多 25 MB;超过限制的附件会被跳过。
- 处理邮件。 新邮件本身不会开启聊天或唤醒 Bot。如需自动处理,请设置例行任务,监听任意发件人、指定地址或整个域名(如
*@example.com)的来信。默认仅通过标准邮件身份验证检查的发件人才会触发任务,不支持按主题筛选。 - 发送邮件。 在聊天中要求 Bot 发送邮件时,Auto Review 放行后就会发送;若需你确认,会先显示审批卡。例行任务生成的邮件,以及任何并非由你通过该发信请求启动的轮次所生成的邮件,都会一直保留为草稿,直到你按下 Send,无法设置无人值守发送。如果还连接了 Gmail 或 Outlook,且两种账号均可使用,Bot 会询问你使用哪个账号发送。
- 安全。 他人的来信会被 Bot 视为信息。它读到的每封邮件都会标记发件人是你还是他人;邮件里的指令绝不能用作你同意发送邮件或执行操作的依据。
发送限制:
- 每封邮件的 To、Cc 和 Bcc 收件人合计最多 50 人
- 最多 10 个附件,每个最多 10 MB,总计最多 25 MB;不能附加可执行文件
- 新闻简报和首次联系邮件每封只能发给一位收件人,并附带一键退订链接
- 如果邮件退回、收件人退订或标记为垃圾邮件,Bot 会停止给该地址发信,并告诉你跳过了谁
- 为防止地址被标记为垃圾邮件来源,可以首次发信联系的人数也有限制
如果删除 Grok Bot 账号,邮件和附件也会被删除,邮箱地址随之停用且不再分配。
在 Cursor 团队中,Agent 邮箱默认关闭。成员申请地址前需由管理员开启 Agent Email。管理员之后如果关闭它,Bot 会失去邮件工具,邮件例行任务也会停止运行;现有地址仍会接收和保存来信,成员也会保留这些地址。
| 提示 | 处理方法 |
|---|---|
| Agent email is not enabled for this account. | 你的账号尚未开通 Agent 邮箱。 |
| Your team admin has turned off Grok Bot agent email, so this account cannot claim or use an agent email address. | 请团队管理员开启 Agent Email。 |
| That address is taken, and addresses are never reissued, so retrying it cannot succeed. Choose a different name. | 请选择其他名称。 |
| 提示字符、长度或保留字不合规 | 请根据上述规则选择名称。 |
| You can have one agent email address. | 你已经有了一个地址。询问 Bot 或打开 Email 应用即可查看。 |
| Couldn't create your email address. Try again.(手机端) | 检查命名规则,或改在桌面端尝试;桌面端会显示具体原因。 |
| Too many email addresses checked in the last minute. | 等待一分钟后重试。 |
搜索和阅读 X
无需连接 X 账号,Bot 即可搜索和阅读 X 上的公开内容。你可以让它搜索帖子、根据链接打开帖子、阅读某个账号的帖子和提及内容、查看谁引用或转发了某条帖子、统计某个话题近期的帖子数,或查看趋势和新闻。
上述访问为只读,也不以你的身份登录。要访问私信、书签、主页时间线,或查看谁点赞了你的帖子,请在 Connect apps 中添加 X 插件并用 X 账号登录。
使用文件
这台电脑在 /workspace 有一个共享工作区。让 Bot 把持久项目文件保存在那里,并使用清晰的项目文件夹。
文件、浏览器状态和受支持的登录状态设计上会在正常电脑更新和恢复后保留。请把临时目录、手动安装的软件包和未提交的应用状态视为可替换内容。将重要结果复制到共享工作区,或附加到对话中。
聊天记录保存在电脑之外,删除电脑中的文件(包括执行 rm -rf)不会删除对话。Grok Bot 会保留已同步电脑数据的持久副本;重新打开电脑时会从该副本恢复,因此同步过的文件通常会重新出现。项目中的 node_modules 目录、Python 虚拟环境等不会被保存,电脑更新、Recover 或 Reset 后需重新安装。仅存在于你的 Mac 或 Windows 设备上的文件不在备份范围内,请自行备份。
磁盘即将用满时,Bot 会在聊天中提醒一次,列出占用空间最大的文件或文件夹及其大小,并询问是否删除。只有你同意才会删除。剩余空间不足不代表数据丢失,清理仅针对电脑文件,不涉及聊天。
更新、恢复或重置电脑
在 Settings → Computer 中打开 Bot's computer 下的电脑控制选项。如果重连页面提供 Recover,也可以从那里恢复。应用和云端电脑各自独立更新。
| 操作 | 作用 | 保留的内容 | 移除的内容 |
|---|---|---|---|
| Update | 更新至最新版本。有些更新只更新 Grok Bot 软件,有些会替换整台电脑;后者有时可安排稍后执行。查看 Update Bot's Computer 下方的文字可判断待执行的是哪种更新。 | 软件更新:保留全部内容,包括已安装应用。电脑更新:保留 Bot、文件和登录信息。 | 软件更新:不移除任何内容。电脑更新:移除已安装的应用和软件包。 |
| Recover | 尽可能先保存数据,再根据已保存数据以最新版本构建新电脑。进行中的工作会被中断。 | 已保存的 Bot、文件和登录信息 | 已安装的应用和软件包;如果电脑无法连接并保存数据,最近的更改也会丢失 |
| Reset | 根据最近一次保存的数据,以最新版本构建新电脑。进行中的工作会被中断。 | 已保存的 Bot、文件和登录信息 | 已安装的应用和软件包;如果电脑无法连接并保存数据,最近的更改也会丢失 |
对话保存在电脑之外,即使重置也会保留。如果最近有 Bot 消失,或数据未能成功保存,请先联系支持团队,再使用 Recover 或 Reset。
电脑无法连接时,请从影响最小的选项开始:
- 先等待,如果显示无法连接,可选择 Retry。可能的提示包括 Reconnecting 或 Couldn't Reach Grok Bot's Computer。也可以重新打开对话。重连时 Bot、文件和登录信息都很安全,此时不要选择 Reset。
- 完全退出 Grok Bot,再重新打开,并检查应用更新。在 Mac 上要从菜单栏选择 Quit,只关闭窗口不等于退出。
- 如果有更新,可以选择 Update Bot's Computer(位于 Settings → Computer)。
- 如果仍无法重连,选择 Recover computer(在确认对话框中称为 Recover Grok Bot's Computer)。如果更新似乎卡住,并且出现 Recover computer,也可以使用此选项。更新只是缓慢时,安全的默认选择是 Keep waiting。
- 只有上述步骤均已尝试后,才使用 Reset Bot's Computer。
更新或重置尚在进行时,不要再启动另一项更新或重置。重复重置可能会打断即将完成的恢复。Reconnecting 和 Recover 通常需要几分钟,可以选择 Continue in Background。Update 也可能需要几分钟;如果显示 Update still running,请继续等待。如果 Recover 或 Reset 失败,使用 Retry Recovery 或 Retry Reset 重试一次;仍失败则停止重试并联系支持团队。
如果电脑文件尚未备份,Update 会提示文件未就绪,并不会作出更改。稍等片刻后重试,请勿直接重置。如果设置页面显示 An agent couldn't pause in time, so the computer was not updated,请等待该 Bot 完成工作,然后再次选择 Update。
电脑显示 Reconnecting 或 Couldn't Reach Grok Bot's Computer 时,Bot 无法完成当前轮次。请按上述步骤修复连接,然后重新发送消息。有关聊天丢失和何时联系支持团队,请参见故障排除。
你的本地电脑是独立的
Grok Bot 云端电脑与面前的 Mac 或 Windows 设备相互独立。Bot 只有在本地执行功能已启用、且满足本地电脑策略的授权条件时,才会在本机执行命令。默认选项 Ask every time 要求逐条命令审批,你也可以选择 Always allow 或 Never allow。本地策略和云端电脑的工作审批分别设置。
请在审批、安全与隐私中查看本地电脑权限。