Grok Build 接入 XXAPI

✳

让 AI 帮你完成配置

首次安装或切换到 XXAPI，都可以使用。

打开豆包 ↗

AI 打不开链接时，。

查看短提示词

我想通过 XXAPI 使用 Grok Build，请先确认我的电脑系统（Windows / macOS / Linux）。请先阅读教程： https://docs.xxapi.ai/text/grok.txt 先确认我是首次安装还是更换服务商。能操作本机时，请先检查并备份配置，再协助完成；只能聊天时，每次带我做一步，等我反馈再继续。密钥由我在本机填写，完成后验证连接。打不开链接就告诉我，我会提供完整教程。

Grok Build 是 xAI 的终端编程助手。下面使用它自带的自定义模型配置，先通过 XXAPI 完成一轮简单对话。

准备自己的 XXAPI Key，以及模型广场中支持 Responses 的 Grok 模型 ID。安装采用 xAI 官方脚本，不需要另外安装 Node.js。

1. 准备模型与 Key

打开 模型广场，选择 Grok 模型，确认支持 Responses 接口，再复制模型 ID。到 API 密钥 创建对应分组的 Key。

查看当前可用模型与分组从 XXAPI 后台读取

选择与你的 API Key 相同的分组，再复制模型名称。

✓ 完成标志

已复制模型 ID 和可访问它的 Key。

2. 安装 Grok Build

Windows 默认按 PowerShell 步骤操作。如果你已经在 WSL 里工作，请全程使用 Linux 步骤；安装、Key 和配置都放在 WSL 的 Linux 用户目录中。

Windows PowerShell 执行下面一行。

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

macOS / Linux 在终端执行下面一行。

curl -fsSL https://x.ai/cli/install.sh | bash

安装结束后重新开终端，执行版本检查。

grok --version

✓ 完成标志

显示 Grok Build 版本号。

3. 打开配置文件

Windows PowerShell

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

macOS / Linux

mkdir -p ~/.grok
nano ~/.grok/config.toml

nano 保存用 Ctrl + O、回车，退出用 Ctrl + X。已有配置先复制备份，再修改下一步指定的字段。

✓ 完成标志

已打开自己用户目录中的 .grok/config.toml。

4. 添加 XXAPI 模型

新文件可以直接使用下面内容。将 model 后的占位文字换成模型广场复制的 ID。

[models]
default = "xxapi-grok"

[model.xxapi-grok]
model = "替换为模型广场中的Grok模型ID"
name = "XXAPI Grok"
base_url = "https://xxapi.ai/v1"
env_key = "XXAPI_API_KEY"
api_backend = "responses"
supports_backend_search = false

xxapi-grok 是本地配置的名字，可以保留。发给服务器的是 model 的值。这里先关闭服务端搜索，只确认基础对话；想开启搜索时，先核对模型与渠道的支持情况。

已经配置过 Grok 或其他服务商

在现有 [models] 下修改 default，再添加 [model.xxapi-grok]，不要生成第二个 [models] 表。旧模型表可以保留。

如果原文件有全局网关地址，本页模型自己的 base_url 应明确指向 XXAPI。运行 grok inspect 核对实际读取的配置来源。若设置过 GROK_HOME，应修改它指向的目录。

✓ 完成标志

默认模型引用 xxapi-grok，其 Base URL 为 https://xxapi.ai/v1。

5. 填入密钥

继续在接下来要启动 Grok 的同一个终端里执行。

Windows PowerShell

$env:XXAPI_API_KEY = "替换为你的XXAPI_API_Key"

macOS / Linux

export XXAPI_API_KEY="替换为你的XXAPI_API_Key"

env_key 不需要改成真实 Key。它会告诉 Grok 读取这里设置的 XXAPI_API_KEY。

✓ 完成标志

已为当前窗口设置 Key。

6. 在练习目录检查并启动

继续使用设置了 Key 的那个窗口，按系统选择一组命令。

Windows PowerShell

New-Item -ItemType Directory -Force "$env:USERPROFILE\xxapi-demo" | Out-Null
Set-Location "$env:USERPROFILE\xxapi-demo"
grok inspect
grok

macOS / Linux

mkdir -p ~/xxapi-demo
cd ~/xxapi-demo
grok inspect
grok

grok inspect 会显示配置来源。确认读到自己的 .grok/config.toml，进入 Grok 输入框后，用 /model xxapi-grok 选中本页的模型。

✓ 完成标志

工作目录是 xxapi-demo，当前模型显示 XXAPI Grok。

7. 发出第一条消息

在 Grok 输入框发送：

请只回复“连接成功”，先不要读取或修改文件。

收到回复后，检查 XXAPI 使用日志中是否出现相同时间的请求。

以后处理项目时，先按 Ctrl + C 退出，再用 cd "你的项目完整路径" 进入实际项目，重新运行 grok。新开终端后需要重新设置第 5 步的 Key。

✓ 完成标志

Grok 正常回复，XXAPI 中出现对应请求。

模型只支持 Chat Completions，怎样切换？

只在模型广场明确标注该协议时，把同一模型表中的 api_backend 改为 chat_completions，并填入对应模型 ID。地址仍是 https://xxapi.ai/v1。不要同时写两行 api_backend。

接入其他模型时，还需按照 Grok 官方说明检查模型能力与工作流要求；首次先验证普通对话，不要照抄其他服务商的上下文上限和专用搜索参数。

常见问题

启动后要求登录 xAI

检查 [models].default 是否为 xxapi-grok，以及同名模型表是否保存成功。用 grok inspect 找到实际读取的文件，再确认本次启动的终端里有 XXAPI_API_KEY。

401 或缺少密钥

重新从 XXAPI 复制完整 Key。变量名必须与 env_key 一致，另开的终端需要重新设置。

响应接口报错或模型不存在

核对模型 ID、分组与 api_backend。Responses 和 Chat Completions 要与渠道说明匹配，不能用 Grok 官网账号或 Key 代替 XXAPI 的 Key。

官方文档

• Grok Build 官方安装与自定义模型
• Grok Build 官方配置