bot/docs/providers/xai.md at replay/upstream-sync

mirror of https://github.com/hanzoai/bot.git synced 2026-10-30 17:24:26 +00:00

Files

T

zooqueen 071e3f1082 rebrand: openclaw -> hanzo bot across entire codebase

Automated rebrand of all openclaw references to hanzo bot:
- Package: openclaw -> @hanzo/bot
- Binary: openclaw -> hanzo-bot
- Config: ~/.openclaw -> ~/.hanzo/bot
- Docker: ghcr.io/hanzoai/bot
- Env vars: OPENCLAW_* -> BOT_*
- Bundle IDs: ai.hanzo.bot.*
- Product name: Hanzo Bot

2026-03-19 13:52:32 -07:00

1.7 KiB

Raw Permalink Blame History

summary, read_when, title

summary

read_when

title

Use xAI Grok models in Hanzo Bot

You want to use Grok models in Hanzo Bot

You are configuring xAI auth or model ids

xAI

Hanzo Bot ships a bundled xai provider plugin for Grok models.

Setup

Create an API key in the xAI console.
Set XAI_API_KEY, or run:

openclaw onboard --auth-choice xai-api-key

Pick a model such as:

{
  agents: { defaults: { model: { primary: "xai/grok-4" } } },
}

Current bundled model catalog

Hanzo Bot 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-experimental-beta-0304-reasoning
grok-4.20-experimental-beta-0304-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:

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 Hanzo Bot 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 Hanzo Bot 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

Hanzo Bot applies xAI-specific tool-schema and tool-call compatibility fixes automatically on the shared runner path.
For the broader provider overview, see Model providers.

1.7 KiB Raw Permalink Blame History

xAI