跳到主要内容

Grok Build 配置

视频教程：Grok Build 配置​

如果你更习惯跟着视频操作，可以先观看下面的 Grok Build 配置教程，再按本页对应系统的文字步骤完成配置。

第一步：安装 Grok Build​

打开 PowerShell：按下 Win+R，输入 powershell，然后按回车。

在 PowerShell 中执行 xAI 提供的安装命令：

irm https://x.ai/cli/install.ps1 | iex

安装完成后，请重新打开终端。

验证安装​

在终端中执行：

grok --version

如果可以正常输出版本号，说明 Grok Build 已安装成功。

Grok Build 安装成功

第二步：配置 APINebula​

Windows 教程​

打开 PowerShell：按下 Win+R，输入 powershell，然后按回车。

配置 config.toml​

Grok Build 的配置目录是 $HOME\.grok，通常对应 C:\Users\你的用户名\.grok。无需手动打开该目录，直接在 PowerShell 中执行下面的命令。命令会自动创建目录；如果 config.toml 已存在，会直接用记事本打开；如果不存在，记事本会在保存时创建它：

New-Item -ItemType Directory -Force "$HOME\.grok" | Out-Null
notepad "$HOME\.grok\config.toml"

config.toml 是 Grok Build 的主要配置文件，用来设置默认模型、APINebula 服务地址、API Key 和请求协议。

删除 config.toml 中的原有内容，将以下示例完整粘贴并保存。这里先保留 你的API_KEY 占位文字，下一小节会说明如何复制真实 Key 并替换：

[models]
default = "grok-4.5"
web_search = "grok-4.5"

[endpoints]
models_base_url = "https://apinebula.ai/v1"

[model."grok-4.5"]
model = "grok-4.5"
name = "Grok 4.5"
description = "Grok 4.5 via APINebula"
api_key = "你的API_KEY"
api_backend = "responses"
context_window = 1000000

可在数据看板的「API 信息」模块查看服务器地址；若后续提供多个服务器，替换 models_base_url 中的域名即可。注意：models_base_url 必须保留 /v1。

查看数据看板中的服务器信息

创建 API 令牌​

打开 创建 API 令牌，选择 Grok 分组并提交。回到令牌列表后，在密钥栏直接复制完整 API Key；再回到 config.toml，只选中 你的API_KEY 并粘贴替换。

创建令牌时，建议将 模型可用列表 留空。填写后，若列表中不包含当前使用的模型，请求可能返回 403。

选择 Grok 分组

令牌列表中的复制密钥入口

模型名称以控制台为准

上方的 grok-4.5 是当前配置示例。请前往 模型广场 确认 Grok 分组实际可用的模型名称。如果名称发生变化，请同时修改 [models]、[model."..."] 和 model 三处。

使用环境变量保存 API Key​

如果不希望把 API Key 直接写入 config.toml，可以将：

api_key = "你的API_KEY"

替换为：

env_key = "APINEBULA_API_KEY"

然后在系统环境变量中创建 APINEBULA_API_KEY 并保存真实 API Key。env_key 填写的是环境变量名称，不是 API Key 本身；修改环境变量后请重新打开终端。

第三步：启动测试​

配置完成后，请在终端执行：

grok

进入交互界面后，可以输入一条简单请求，例如：

你好

如果 Grok Build 可以正常返回内容，就说明配置成功。

Grok Build 启动测试

继续阅读​

微信扫码联系我们