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 theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}}
openclaw onboard –auth-choice xai-api-key

3. Pick a model such as:

```json5  theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
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.