Grok App
免费下载

安装指南

下载、安装、第一次打开

开源 Grok App 是本机 Grok Build CLI 的桌面工作台。从 GitHub Releases 取当前发行包，按系统装好，再完成本机 CLI 登录。也有人搜 Grok Desktop、Grok GUI 或桌面客户端。

选择系统并下载

安装包只在 GitHub Releases。下面按钮指向 latest/download 稳定文件名；版本号来自构建时清单。本站不托管、也不反代安装包。预编译包不需要 Node.js、pnpm 或 Rust。应用包名是 Grok。

所有版本（GitHub Releases）

在 macOS 上安装

Apple Silicon（M1–M4）用 aarch64 DMG，Intel Mac 用 x64 DMG。不要把 ARM 机默认导向 Intel 包。

  1. 下载对应架构的 DMG（稳定名 Grok_mac_aarch64.dmg 或 Grok_mac_x64.dmg）。
  2. 打开 DMG，把 Grok 拖进「应用程序」。
  3. 从「应用程序」打开 Grok。自 v0.2.19 起，正式 Release 已 Apple Developer ID 签名并完成公证。

在 Windows 上安装

提供 Windows 10/11 的 64 位安装版与绿色版。没有 Windows ARM 包。

  1. 主按钮下载安装版 Grok_windows_x64-setup.exe 并运行。
  2. 不想写入系统可用绿色版 Grok_windows_x64-portable.zip，解压后运行。
  3. 需要 WebView2 Runtime。Windows 11 通常已有；若缺失，安装包会引导安装。

在 Linux 上安装

x64 提供 AppImage（通用 / Arch）、DEB（Debian / Ubuntu / Mint / Pop!_OS）和 RPM（Fedora / RHEL / openSUSE）。没有 Linux aarch64、AUR、Flatpak 或 Snap。

  1. 通用 / Arch：下载 Grok_linux_x64.AppImage，chmod +x 后运行。
  2. Debian 系：安装 Grok_linux_x64.deb。
  3. Fedora / RHEL 系：安装 Grok_linux_x64.rpm。

官方 AppImage 不打包宿主 EGL / WebKit / 托盘库。干净的 Debian / Ubuntu 上可能一启动就因缺少 libEGL.so.1 退出。先装运行时库，再 chmod +x 运行。 

sudo apt-get install -y libegl1 libgles2 libwebkit2gtk-4.1-0 libayatana-appindicator3-1
chmod +x Grok_linux_x64.AppImage
./Grok_linux_x64.AppImage

首次启动与本机 CLI

完整能力需要本机已安装并登录的 Grok Build CLI。应用不会替代 CLI。首次向导可协助检测和安装 CLI。

  1. 打开应用。向导会检查本机是否已有 Grok Build CLI（支持多源快速安装）。
  2. 登录官方账号、填写 API Key，或配置自定义中转。若本机 grok 已登录，选「使用现有 CLI 登录」。
  3. 选择并信任一个项目工作目录。
  4. 连接 Agent，选择 Ask 或 YOLO 权限模式，开始工作。

需要 Grok Build CLI（grok）0.2.112 或更高。可在终端运行 grok update。网络受限时，到「设置 → 运行环境 → 网络」配置 HTTP/SOCKS 代理并点「测试连接」。

怎么确认装好了

能打开名为 Grok 的应用；向导确认 CLI 可用，或已选「使用现有 CLI 登录」；已信任一个项目目录；能发出第一条消息（Ask 模式下会弹出权限确认）。

校验安装包

每个 Release 带 SHA256SUMS。下载后可按下面命令核对，不要把 SHA256SUMS 当成「下载 App」。

macOS / Linux

shasum -a 256 -c SHA256SUMS --ignore-missing

Windows（PowerShell）

Get-FileHash .\Grok_*_x64-setup.exe -Algorithm SHA256

常见卡住

macOS 提示无法打开或「已损坏」：到「系统设置 → 隐私与安全性」允许打开，或按住 Control 点按图标选「打开」。也可清除隔离属性后再打开。只从 GitHub Releases 取包。 

xattr -cr /Applications/Grok.app
open /Applications/Grok.app

Windows SmartScreen 提示未知发布者：点「更多信息 → 仍要运行」。可用 SHA256SUMS 核对哈希。确认已有 WebView2。

AppImage 报缺 libEGL.so.1：先装宿主运行时库。Wayland（如 Hyprland + AMD）显示异常时，优先用 .deb / .rpm；或加 WEBKIT_DISABLE_DMABUF_RENDERER=1 再运行 AppImage。 

WEBKIT_DISABLE_DMABUF_RENDERER=1 ./Grok_linux_x64.AppImage

Ubuntu 24.04+ 上 Agent 沙箱起不来：可启用非特权用户命名空间，或在「设置 → 运行环境 → 沙箱」关掉沙箱。 

sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0
echo 'kernel.apparmor_restrict_unprivileged_userns=0' | sudo tee /etc/sysctl.d/99-userns.conf

接下来

装好之后可以看问答、Release 说明、源码，或给工作台换皮肤。

常见问题 GitHub Releases 源码仓库 社区皮肤