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.
This commit is contained in:
Jaaneek 2026-06-16 17:09:06 +00:00 committed by Teknium
parent bbc842d31e
commit f4ef70f6fc
5 changed files with 19 additions and 17 deletions

View file

@ -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)

View file

@ -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

View file

@ -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

View file

@ -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` 始终固定在列表顶部。
## 环境变量

View file

@ -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 个