Grok Build

配置教程见 Grok Build 配置。

改了配置不生效Copy Anchor Link

每次修改 ~/.grok/config.toml 后都要重启 grok：先 Ctrl + C 退出再重新运行。可以用 grok inspect 确认配置是否被正确加载。

把 Key 写到 env_key 后无法使用Copy Anchor Link

env_key 只能填环境变量名，例如 OMINI_API_KEY，不能填真实 Key。想直接写在配置文件里，用：

api_key = "你的 API Key"

用 env_key 的话，设置完系统环境变量后要重新打开终端再运行 grok。

提示模型不存在或无权限Copy Anchor Link

• 密钥的分组里是否有你填的模型，以 模型广场 为准；
• models_base_url 是否为 https://omini.ominiapi.top/v1；
• [model."grok-4.7"] 里的 model = "grok-4.7" 是否和模型广场里的名字一致；
• Key 是否复制完整，前后没有多余空格。

/effort 调整思考等级不生效Copy Anchor Link

确认该模型的配置块里写了 supports_reasoning_effort = true。只有写了这一行，/effort 命令和 --effort 参数才会对该模型生效。改完重启 Grok Build。

使用 Kimi 等非 Grok 模型时无法对话Copy Anchor Link

接入 kimi-k3 等非 Grok 模型时，必须在配置文件里关闭 workflows：

[workflows]
enabled = false

workflows 是 Grok 模型专属能力，第三方模型不支持，开着会导致对话失败。同时检查该模型的 api_backend 是否填了它支持的接口（Kimi、GLM 一般用 chat_completions）。

请求报错，提示后端搜索相关参数Copy Anchor Link

在模型配置块里加上 supports_backend_search = false，避免请求被自动附加平台不支持的后端搜索参数。