mirror of
https://github.com/openclaw/openclaw.git
synced 2026-03-26 09:21:55 +00:00
916f496b51
Merged via squash.
Prepared head SHA: 095e645ea5
Co-authored-by: Jaaneek <25470423+Jaaneek@users.noreply.github.com>
Co-authored-by: huntharo <5617868+huntharo@users.noreply.github.com>
Reviewed-by: @huntharo
61 lines
1.7 KiB
Markdown
61 lines
1.7 KiB
Markdown
---
|
|
summary: "Use xAI Grok models in OpenClaw"
|
|
read_when:
|
|
- You want to use Grok models in OpenClaw
|
|
- You are configuring xAI auth or model ids
|
|
title: "xAI"
|
|
---
|
|
|
|
# xAI
|
|
|
|
OpenClaw ships a bundled `xai` provider plugin for Grok models.
|
|
|
|
## Setup
|
|
|
|
1. Create an API key in the xAI console.
|
|
2. Set `XAI_API_KEY`, or run:
|
|
|
|
```bash
|
|
openclaw onboard --auth-choice xai-api-key
|
|
```
|
|
|
|
3. Pick a model such as:
|
|
|
|
```json5
|
|
{
|
|
agents: { defaults: { model: { primary: "xai/grok-4" } } },
|
|
}
|
|
```
|
|
|
|
## Current bundled model catalog
|
|
|
|
OpenClaw now includes these xAI model families out of the box:
|
|
|
|
- `grok-4`, `grok-4-0709`
|
|
- `grok-4-fast-reasoning`, `grok-4-fast-non-reasoning`
|
|
- `grok-4-1-fast-reasoning`, `grok-4-1-fast-non-reasoning`
|
|
- `grok-4.20-reasoning`, `grok-4.20-non-reasoning`
|
|
- `grok-code-fast-1`
|
|
|
|
The plugin also forward-resolves newer `grok-4*` and `grok-code-fast*` ids when
|
|
they follow the same API shape.
|
|
|
|
## Web search
|
|
|
|
The bundled `grok` web-search provider uses `XAI_API_KEY` too:
|
|
|
|
```bash
|
|
openclaw config set tools.web.search.provider grok
|
|
```
|
|
|
|
## Known limits
|
|
|
|
- Auth is API-key only today. There is no xAI OAuth/device-code flow in OpenClaw yet.
|
|
- `grok-4.20-multi-agent-experimental-beta-0304` is not supported on the normal xAI provider path because it requires a different upstream API surface than the standard OpenClaw xAI transport.
|
|
- Native xAI server-side tools such as `x_search` and `code_execution` are not yet first-class model-provider features in the bundled plugin.
|
|
|
|
## Notes
|
|
|
|
- OpenClaw applies xAI-specific tool-schema and tool-call compatibility fixes automatically on the shared runner path.
|
|
- For the broader provider overview, see [Model providers](/providers/index).
|