From f4ef70f6fc6232e49c1d7fbe9eab2eebe6f21108 Mon Sep 17 00:00:00 2001 From: Jaaneek Date: Tue, 16 Jun 2026 17:09:06 +0000 Subject: [PATCH] docs(xai): update default model references to grok-build-0.1 Reflect the default-model change in the xAI Grok OAuth guide, the web search docs (EN + zh-Hans), and the web provider docstring. grok-4.3 is kept in the model tables as the previous default; the Nous/OpenRouter aggregator catalog still lists grok-4.3 and is left unchanged. --- plugins/web/xai/provider.py | 2 +- website/docs/guides/xai-grok-oauth.md | 15 ++++++++------- website/docs/user-guide/features/web-search.md | 2 +- .../current/guides/xai-grok-oauth.md | 15 ++++++++------- .../current/user-guide/features/web-search.md | 2 +- 5 files changed, 19 insertions(+), 17 deletions(-) diff --git a/plugins/web/xai/provider.py b/plugins/web/xai/provider.py index 5cec39b91f5..9e163a228d6 100644 --- a/plugins/web/xai/provider.py +++ b/plugins/web/xai/provider.py @@ -19,7 +19,7 @@ Optional knobs (under ``web.xai`` in ``config.yaml``):: web: xai: - model: "grok-4.3" # reasoning model required by web_search + model: "grok-build-0.1" # reasoning model required by web_search allowed_domains: ["x.ai"] # max 5 — mutually exclusive with excluded_domains excluded_domains: ["bad.com"] # max 5 — mutually exclusive with allowed_domains timeout: 90 # seconds (default 90) diff --git a/website/docs/guides/xai-grok-oauth.md b/website/docs/guides/xai-grok-oauth.md index bd30e5db15f..d38a7601c51 100644 --- a/website/docs/guides/xai-grok-oauth.md +++ b/website/docs/guides/xai-grok-oauth.md @@ -22,7 +22,7 @@ The same OAuth bearer token is also reused by every direct-to-xAI surface in Her | Display name | xAI Grok OAuth (SuperGrok / X Premium+) | | Auth type | Browser OAuth 2.0 PKCE (loopback callback) | | Transport | xAI Responses API (`codex_responses`) | -| Default model | `grok-4.3` | +| Default model | `grok-build-0.1` | | Endpoint | `https://api.x.ai/v1` | | Auth server | `https://accounts.x.ai` | | Requires env var | No (`XAI_API_KEY` is **not** used for this provider) | @@ -47,7 +47,7 @@ hermes model # → Select "xAI Grok OAuth (SuperGrok / X Premium+)" from the provider list # → Hermes opens your browser to accounts.x.ai # → Approve access in the browser -# → Pick a model (grok-4.3 is at the top) +# → Pick a model (grok-build-0.1 is at the top) # → Start chatting hermes @@ -116,13 +116,13 @@ The `◆ Auth Providers` section will show the current state of every provider, ```bash hermes model # → Select "xAI Grok OAuth (SuperGrok / X Premium+)" -# → Pick from the model list (grok-4.3 is pinned to the top) +# → Pick from the model list (grok-build-0.1 is pinned to the top) ``` Or set the model directly: ```bash -hermes config set model.default grok-4.3 +hermes config set model.default grok-build-0.1 hermes config set model.provider xai-oauth ``` @@ -132,7 +132,7 @@ After login, `~/.hermes/config.yaml` will contain: ```yaml model: - default: grok-4.3 + default: grok-build-0.1 provider: xai-oauth base_url: https://api.x.ai/v1 ``` @@ -176,7 +176,8 @@ The `x_search` toolset auto-enables whenever xAI credentials (a SuperGrok / X Pr | Tool | Model | Notes | |------|-------|-------| -| Chat | `grok-4.3` | Default; auto-selected when you log in via OAuth | +| Chat | `grok-build-0.1` | Default; auto-selected when you log in via OAuth | +| Chat | `grok-4.3` | Previous default | | Chat | `grok-4.20-0309-reasoning` | Reasoning variant | | Chat | `grok-4.20-0309-non-reasoning` | Non-reasoning variant | | Chat | `grok-4.20-multi-agent-0309` | Multi-agent variant | @@ -186,7 +187,7 @@ The `x_search` toolset auto-enables whenever xAI credentials (a SuperGrok / X Pr | Video | `grok-imagine-video-1.5-preview` | Image-to-video; dated alias `grok-imagine-video-1.5-2026-05-30` | | TTS | (default voice) | xAI `/v1/tts` endpoint | -The chat catalog is derived live from the on-disk `models.dev` cache; new xAI releases appear automatically once that cache refreshes. `grok-4.3` is always pinned to the top of the list. +The chat catalog is derived live from the on-disk `models.dev` cache; new xAI releases appear automatically once that cache refreshes. `grok-build-0.1` is always pinned to the top of the list. ## Environment Variables diff --git a/website/docs/user-guide/features/web-search.md b/website/docs/user-guide/features/web-search.md index 161b91ec83c..8058fd24d70 100644 --- a/website/docs/user-guide/features/web-search.md +++ b/website/docs/user-guide/features/web-search.md @@ -305,7 +305,7 @@ web: web: backend: "xai" xai: - model: grok-4.3 # reasoning model required by web_search (default) + model: grok-build-0.1 # reasoning model required by web_search (default) allowed_domains: # optional, max 5 — mutex with excluded_domains - arxiv.org excluded_domains: # optional, max 5 diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/xai-grok-oauth.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/xai-grok-oauth.md index 1d3fd02f4d6..9861ce97652 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/xai-grok-oauth.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/xai-grok-oauth.md @@ -22,7 +22,7 @@ Hermes Agent 通过基于浏览器的 OAuth 登录流程支持 xAI Grok，认证 | 显示名称 | xAI Grok OAuth (SuperGrok / X Premium+) | | 认证类型 | 浏览器 OAuth 2.0 PKCE（回环回调） | | 传输层 | xAI Responses API（`codex_responses`） | -| 默认模型 | `grok-4.3` | +| 默认模型 | `grok-build-0.1` | | 端点 | `https://api.x.ai/v1` | | 认证服务器 | `https://accounts.x.ai` | | 需要环境变量 | 否（此 provider 不使用 `XAI_API_KEY`） | @@ -47,7 +47,7 @@ hermes model # → 从 provider 列表中选择 "xAI Grok OAuth (SuperGrok / X Premium+)" # → Hermes 在浏览器中打开 accounts.x.ai # → 在浏览器中批准访问 -# → 选择模型（grok-4.3 在列表顶部） +# → 选择模型（grok-build-0.1 在列表顶部） # → 开始对话 hermes @@ -114,13 +114,13 @@ hermes doctor ```bash hermes model # → 选择 "xAI Grok OAuth (SuperGrok / X Premium+)" -# → 从模型列表中选择（grok-4.3 固定在顶部） +# → 从模型列表中选择（grok-build-0.1 固定在顶部） ``` 或直接设置模型： ```bash -hermes config set model.default grok-4.3 +hermes config set model.default grok-build-0.1 hermes config set model.provider xai-oauth ``` @@ -130,7 +130,7 @@ hermes config set model.provider xai-oauth ```yaml model: - default: grok-4.3 + default: grok-build-0.1 provider: xai-oauth base_url: https://api.x.ai/v1 ``` @@ -174,7 +174,8 @@ hermes tools | 工具 | 模型 | 说明 | |------|-------|-------| -| 对话 | `grok-4.3` | 默认；通过 OAuth 登录时自动选择 | +| 对话 | `grok-build-0.1` | 默认；通过 OAuth 登录时自动选择 | +| 对话 | `grok-4.3` | 之前的默认 | | 对话 | `grok-4.20-0309-reasoning` | 推理变体 | | 对话 | `grok-4.20-0309-non-reasoning` | 非推理变体 | | 对话 | `grok-4.20-multi-agent-0309` | 多 agent 变体 | @@ -184,7 +185,7 @@ hermes tools | 视频 | `grok-imagine-video-1.5-preview` | 图像转视频；日期别名 `grok-imagine-video-1.5-2026-05-30` | | TTS | （默认音色） | xAI `/v1/tts` 端点 | -对话模型目录从磁盘上的 `models.dev` 缓存实时获取；缓存刷新后，新的 xAI 模型会自动出现。`grok-4.3` 始终固定在列表顶部。 +对话模型目录从磁盘上的 `models.dev` 缓存实时获取；缓存刷新后，新的 xAI 模型会自动出现。`grok-build-0.1` 始终固定在列表顶部。 ## 环境变量 diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/features/web-search.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/features/web-search.md index 70b378bedd1..8bd34cc2b4e 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/features/web-search.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/features/web-search.md @@ -305,7 +305,7 @@ web: web: backend: "xai" xai: - model: grok-4.3 # web_search 所需的推理模型（默认） + model: grok-build-0.1 # web_search 所需的推理模型（默认） allowed_domains: # 可选，最多 5 个——与 excluded_domains 互斥 - arxiv.org excluded_domains: # 可选，最多 5 个