Grok Build
手动配置 xAI Grok Build CLI 使用 OminiApi
Grok Build 是 xAI 推出的终端编码助手，配置文件是 ~/.grok/config.toml，把模型请求接到 OminiApi 的 OpenAI 兼容地址即可。
不要把真实 Key 发给别人
下面示例里的 你的 API Key 只是占位符。不要把真实 Key 截图、发到聊天群、上传到公开仓库或贴进工单。
安装 Grok Build
irm https://x.ai/cli/install.ps1 | iex安装后重新打开终端检查：
grok --version配置步骤
打开配置目录
按 Win + R，输入下面的路径后回车；目录里没有 config.toml 就手动新建：
%USERPROFILE%\.grok编辑 config.toml
[models]
default = "grok-4.7"
web_search = "grok-4.7"
[endpoints]
models_base_url = "https://omini.ominiapi.top/v1"
[model."grok-4.7"]
model = "grok-4.7"
name = "Grok 4.7"
description = "Grok 4.7 via OminiApi"
api_key = "你的 API Key"
api_backend = "responses"
supports_reasoning_effort = true # 开启后可用 /effort 调整思考等级
supports_backend_search = false # 关闭后端搜索，避免网关不支持时报错把 你的 API Key 换成在控制台 API 密钥 页面创建的 Key。
配置生效提醒
每次修改 config.toml 后都要重启 grok 才会生效：先 Ctrl + C 退出，再重新运行。
配置项说明
| 配置项 | 说明 |
|---|---|
[models] default | 新会话默认使用的模型 |
[models] web_search | 内置 web_search 工具使用的模型 |
[endpoints] models_base_url | 填 https://omini.ominiapi.top/v1，要带 /v1 |
api_key | 当前模型使用的 OminiApi Key |
api_backend | responses 表示走 Responses 接口；chat_completions 走 Chat Completions |
supports_reasoning_effort | 声明模型支持调整思考等级，不写的话 /effort 不可用 |
supports_backend_search | 设为 false，避免请求被自动附加后端搜索参数而报错 |
可用的 Grok 模型：grok-4.7、grok-4.6、grok-4.5、grok-4.5-latest。每个模型写一个 [model."模型名"] 配置块，你的密钥能用哪些以 模型广场 为准。
用环境变量保存 Key
不想把 Key 明文写进文件：把 api_key = "..." 换成 env_key = "OMINI_API_KEY"（填的是环境变量的名字），再在系统环境变量里设置 OMINI_API_KEY。
添加 Kimi 等非 Grok 模型
在 Grok Build 里使用 kimi-k3 等非 Grok 模型，除了添加对应的配置块，还必须关闭 workflows，否则无法正常对话：
[workflows]
enabled = false
[model."kimi-k3"]
model = "kimi-k3"
name = "Kimi K3"
description = "Kimi K3 via OminiApi"
api_key = "你的 API Key"
api_backend = "chat_completions"
supports_backend_search = false- workflows 是 Grok 模型专属能力，第三方模型不支持；
api_backend按模型实际支持的接口填写，Kimi、GLM 一般用chat_completions。
调整思考等级
配置块里写了 supports_reasoning_effort = true 之后：
/effort low # 低思考，响应更快
/effort medium
/effort high
/effort xhigh # 极高思考，推理更深入切换模型时也可以直接带上等级，例如 /model grok-4.7 high。无头模式用 --effort：
grok -p "只回复 ok" -m grok-4.7 --effort high