Caricamento in corso...
Caricamento in corso...
Last synced: Today, 22:00
Technical reference for the OpenClaw framework. Real-time synchronization with the official documentation engine.
Use this file to discover all available pages before exploring further.
OpenClaw ships a bundled
xaitext```bash} openclaw onboard --auth-choice xai-api-key ```
OpenClaw includes these xAI model families out of the box:
| Family | Model ids |
|---|---|
| Grok 3 | text grok-3text grok-3-fasttext grok-3-minitext grok-3-mini-fast |
| Grok 4 | text grok-4text grok-4-0709 |
| Grok 4 Fast | text grok-4-fasttext grok-4-fast-non-reasoning |
| Grok 4.1 Fast | text grok-4-1-fasttext grok-4-1-fast-non-reasoning |
| Grok 4.20 Beta | text grok-4.20-beta-latest-reasoningtext grok-4.20-beta-latest-non-reasoning |
| Grok Code | text grok-code-fast-1 |
The plugin also forward-resolves newer
grok-4*grok-code-fast*The bundled plugin maps xAI's current public API surface onto OpenClaw's shared provider and tool contracts. Capabilities that don't fit the shared contract (for example streaming TTS and realtime voice) are not exposed — see the table below.
| xAI capability | OpenClaw surface | Status |
|---|---|---|
| Chat / Responses | text xai/<model> | Yes |
| Server-side web search | text web_searchtext grok | Yes |
| Server-side X search | text x_search | Yes |
| Server-side code execution | text code_execution | Yes |
| Images | text image_generate | Yes |
| Videos | text video_generate | Yes |
| Batch text-to-speech | text messages.tts.provider: "xai"text tts | Yes |
| Streaming TTS | — | Not exposed; OpenClaw's TTS contract returns complete audio buffers |
| Batch speech-to-text | text tools.media.audio | Yes |
| Streaming speech-to-text | Voice Call text streaming.provider: "xai" | Yes |
| Realtime voice | — | Not exposed yet; different session/WebSocket contract |
| Files / batches | Generic model API compatibility only | Not a first-class OpenClaw tool |
/fast onagents.defaults.models["xai/<model>"].params.fastMode: true| Source model | Fast-mode target |
|---|---|
text grok-3 | text grok-3-fast |
text grok-3-mini | text grok-3-mini-fast |
text grok-4 | text grok-4-fast |
text grok-4-0709 | text grok-4-fast |
Legacy aliases still normalize to the canonical bundled ids:
| Legacy alias | Canonical id |
|---|---|
text grok-4-fast-reasoning | text grok-4-fast |
text grok-4-1-fast-reasoning | text grok-4-1-fast |
text grok-4.20-reasoning | text grok-4.20-beta-latest-reasoning |
text grok-4.20-non-reasoning | text grok-4.20-beta-latest-non-reasoning |
The xAI media paths are covered by unit tests and opt-in live suites. The live commands load secrets from your login shell, including
~/.profileXAI_API_KEYbashpnpm test extensions/xai OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_TEST_QUIET=1 pnpm test:live -- extensions/xai/xai.live.test.ts OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_TEST_QUIET=1 OPENCLAW_LIVE_IMAGE_GENERATION_PROVIDERS=xai pnpm test:live -- test/image-generation.runtime.live.test.ts
The provider-specific live file synthesizes normal TTS, telephony-friendly PCM TTS, transcribes audio through xAI batch STT, streams the same PCM through xAI realtime STT, generates text-to-image output, and edits a reference image. The shared image live file verifies the same xAI provider through OpenClaw's runtime selection, fallback, normalization, and media attachment path.
© 2024 TaskFlow Mirror
Powered by TaskFlow Sync Engine