团队与企业

向组织部署 Grok Bot

IT 团队可以用现有的软件管理工具在成员设备上安装 Grok Bot 桌面应用：下载指定版本的安装程序、向设备推送，并决定何时升级到新版本。有关如何在仪表盘中启用 Grok Bot 并限定访问范围，请参阅面向团队和企业的 Grok Bot。有关如何部署 Cursor 编辑器，请参阅部署方式。

需要部署哪些组件

这些应用是聊天、审阅和审批的客户端。Bot 在成员的托管电脑上执行工作。设备管理工具只能管理成员设备上的应用。托管电脑在云端运行 Linux，未纳入 MDM 管理。Enterprise 团队如需在托管电脑上安装自己的工具，可以使用 Team Setup Scripts。

获取安装程序

• 前往 Download Grok Bot 一栏，所在位置是仪表盘的 Grok Bot 页面。在此可安装应用或复制链接分享给成员。
• 前往 下载页面，即可查看各平台、各格式的当前安装程序。
• 如需用脚本打包，请从版本发布源读取当前版本，下载其中指定的文件。

从发布源读取当前版本

每个平台都有一个 JSON 发布源，地址为 https://api2.cursor.sh/updates/api/download/stable/{platform}/sand：

curl -s https://api2.cursor.sh/updates/api/download/stable/darwin-arm64/sand

所需字段如下。

响应中可能还有其他字段，安装桌面应用时无需使用。

构建指定版本的 URL

macOS 和 Windows 的每个发行版本都有带版本号的安装程序 URL。请将 {version} 替换为所需的版本号：

# macOS, Apple silicon
https://downloads.cursor.com/grokbot/stable/darwin-arm64/{version}/Grok_Bot_{version}.dmg

# macOS, Intel
https://downloads.cursor.com/grokbot/stable/darwin-x64/{version}/Grok_Bot_{version}_x64.dmg

# Windows x64
https://downloads.cursor.com/grokbot/stable/win32-x64/{version}/Grok_Bot_{version}_Setup.exe

# Windows Arm64
https://downloads.cursor.com/grokbot/stable/win32-arm64/{version}/Grok_Bot_{version}_Setup.exe

Linux 软件包位于该发行版本的 commitSha 路径下，具体目录为 https://downloads.cursor.com/grokbot/stable/{commitSha}/linux/x64/ 或 .../linux/arm64/。请从 Linux 发布源中的 downloadUrl、debUrl 及 rpmUrl 字段复制准确的文件 URL。

使用设备管理工具推送桌面应用

• 在 macOS 上，可部署 .dmg 文件，使用现有的 Mac 管理工具即可，如 Jamf Pro、Kandji 或 Microsoft Intune。
• 在 Windows 上，可部署 Setup .exe 文件，使用 Intune、Configuration Manager 或其他软件分发工具，并通过以下命令静默安装：Grok_Bot_{version}_Setup.exe /S。安装程序按用户安装，目标位置为成员个人配置文件中的 %LOCALAPPDATA%\Programs，因此需在用户上下文中部署，不能以 SYSTEM 身份运行。推送前请先在试点设备上测试。
• 在 Linux 上，可以安装 .deb 或 .rpm 软件包，使用 Ansible、Puppet 或 Chef 等配置管理工具。对于集中管理的设备，建议优先选用这些软件包，以便通过包管理器按计划升级。参见Linux 软件包更新。
• 使用 iPhone 的成员可从 App Store 安装 Grok Bot，系统需为 iOS 18 或更高版本。
• 使用 Android 的成员可从 Google Play 安装 Grok Bot，系统需为 Android 9 或更高版本。要向受管设备推送，请在 Intune 或其他 Android 设备管理工具的受管理 Google Play 中批准该应用。

成员通过组织原有的 SSO 流程使用 Cursor 账号登录，Grok Bot 无需单独登录。有关如何在 Okta 或 Entra ID 中分配 Cursor 应用，请参阅分配 Cursor 应用。

选择版本

固定已测试的版本。下载该版本的安装程序，将它保存在自己的软件仓库或 MDM 软件包存储库中，并从该副本部署，确保每台新设备都安装同一构建。官方未公布旧版安装程序会保留多久，固定的构建也只能使用到停止支持为止。参见桌面应用的更新方式。

Linux 软件包 URL 中包含该发行版本的 commitSha，因此请连同版本号记录完整 URL。

要检查设备正在运行的版本，请打开应用中的账号菜单，选择 Support，再选择 About。对话框会显示 Version。选择 Copy version info 可复制版本号、发布渠道和操作系统信息。

桌面应用的更新方式

在 macOS、Windows 和通过 AppImage 安装的 Linux 版本中，没有可关闭桌面应用更新的设备策略、安装选项或仪表盘设置。成员可关闭 Automatic Updates，以便仅在选择 Restart to Update 时安装更新，但应用仍会检查和提示新版本。固定版本只决定初次安装的版本，之后应用仍会提示升级。

旧构建最终会停止工作。构建失去支持时，应用会在整个窗口上显示 Update required，直至成员完成更新。低于最低受支持版本的构建会失去支持；超过最长使用期限且已有更新版本时也会失去支持。这适用于所有安装方式，包括 Linux .deb 和 .rpm 软件包。这两项限制均由服务端设定且未公开，因此应计划定期将设备升级到当前版本。

Linux 软件包更新

安装 .deb 会添加带签名的 apt 仓库，配置文件为 /etc/apt/sources.list.d/grok-bot.sources；安装 .rpm 会添加带签名的软件仓库，配置文件为 /etc/yum.repos.d/grok-bot.repo。此后，设备每次升级软件包时都可获取新的 Grok Bot 版本。

如需控制 Linux 设备的升级时间，可选择以下一种方式：

• 用包管理器锁定软件包，例如执行 apt-mark hold grok-bot，准备升级时再解除锁定。
• 禁用仓库：将 Enabled: no 写入 grok-bot.sources，或将 enabled=0 写入 grok-bot.repo。每次安装或升级时，软件包都会重写这些文件，并保留你的选择。之后，由你自行分发经过测试的新版本软件包。

无论选择哪种方式，都应在已安装版本失去支持前升级。即使软件包已锁定，仍会出现 Update required 屏幕。

使用 .deb 或 .rpm 安装时，Update required 屏幕会显示应执行的命令，并提供 Copy command：

• .deb：sudo apt update && sudo apt install --only-upgrade grok-bot
• .rpm：sudo dnf upgrade --refresh grok-bot

如果仓库中尚无新版本，例如已禁用该仓库，屏幕会提示成员改为下载并安装最新软件包，并给出链接。执行更新命令或手动安装后，成员需重启 Grok Bot。

更新托管电脑

托管电脑的镜像由服务方维护，无法固定版本或自备镜像。电脑会通过以下三种方式之一迁移到较新的镜像：

运行中的电脑大约每天读取一次 Team Setup 清单的变更。如需提前应用，请重建电脑。在 Enterprise 中，审计日志会将电脑更新、重置、重建和终止记为 grok_bot_vm 事件，将涉及多位成员的操作记为 grok_bot_vm_bulk。

开放网络访问路径

设备从 cursor.com 和 downloads.cursor.com 下载安装程序及桌面更新。应用通过以下列表中的域名访问 API 和成员的托管电脑：允许这些域名模式。推送应用前，请允许所有列出的域名，包括嵌套的 *.*.cursorvm.com 模式，并将它们排除在 TLS 检查之外。

部署清单

1. 退出 Privacy Mode (Legacy)，此模式会完全阻止 Grok Bot 运行。参见部署前的准备工作。
2. 打通网络：在网关上允许 Grok Bot 域名，并将这些域名排除在 TLS 检查之外。参见配置执行 TLS 检查的代理。
3. 在身份提供方中分配 Cursor 应用，因为 Grok Bot 使用你的 SSO 登录。参见分配 Cursor 应用。
4. 启用 Grok Bot 并指定使用者。在 Enterprise 中，由管理员从仪表盘启用 Grok Bot，再通过 Manage Group Access 限定范围；在 Teams 套餐中，所有成员均已获得访问权限。参见为团队启用 Grok Bot。
5. 应用推荐配置：按推荐配置所述，在成员开始使用前设置管理选项。
6. 先试装：在每个平台上各选几台设备安装选定版本，登录后确认应用能连接到托管电脑。
7. 向设备推送：将经过测试的安装程序部署到所有获准成员的设备。
8. 规划更新：确定设备升级到新版本的频率。对于 Linux，还要决定通过 Grok Bot 仓库升级，还是分发自测软件包。

常见问题

可以关闭桌面应用的自动更新吗？

在 macOS、Windows 和使用 AppImage 安装的 Linux 上，无法关闭更新检查和提示。每位成员可以关闭 Automatic Updates，使更新仅在选择 Restart to Update 时安装，但管理员没有对应的控制选项。Linux .deb 和 .rpm 安装的版本不会自行更新，可以通过包管理器控制。参见桌面应用的更新方式。

是否提供 MSI 或 PKG 安装程序？

已发布的安装程序包括 macOS 使用的 .dmg、Windows 使用的 Setup .exe，以及 Linux 使用的 .deb、.rpm 或 AppImage。如果管理工具要求特定的软件包格式，可将 .dmg 或 .exe 封装成该格式。

设备管理工具可以管理托管电脑吗？

不能。托管电脑在云端运行 Linux，未纳入 MDM 管理。Enterprise 团队可以通过 Team Setup Scripts 在上面安装自己的工具。如果身份提供方要求受管设备，请参阅允许在托管电脑上登录 IdP 应用。

可以固定托管电脑的镜像吗？

不能。镜像由服务方维护，电脑会在后台迁移到新镜像。Enterprise 管理员可在选定的时间通过以下入口重建电脑：Manage Member Computers and Data。

成员可以不经 IT 自行安装 Grok Bot 吗？

可以，除非设备策略明令禁止。成员可使用管理员从仪表盘分享的链接下载应用，也可前往下载页面。访问权限仍取决于套餐；Enterprise 还取决于 Manage Group Access。

相关页面

• 面向团队和企业的 Grok Bot
• 配置身份与访问权限
• 配置执行 TLS 检查的代理
• 管理 Grok Bot 电脑
• 设置与通知
• 部署方式

有关启用 Enterprise、规划部署以及获得安全审查支持，请联系你的客户团队。