openclaw
Version:
Multi-channel AI gateway with extensible messaging integrations
541 lines (540 loc) • 14.1 kB
JSON
{
"id": "xai",
"name": "xAI (Grok)",
"description": "xAI provider for Grok models, Grok web and X search, code execution, speech, and media generation.",
"categories": [
"models"
],
"capabilityCatalogEntry": "./capability-catalog.js",
"doctorContract": {
"configRepair": true
},
"activation": {
"onStartup": false
},
"enabledByDefault": true,
"providers": [
"xai"
],
"providerAuthAliases": {
"x-ai": "xai"
},
"providerCatalogEntry": "./provider-discovery.js",
"modelIdNormalization": {
"providers": {
"xai": {
"aliases": {
"grok-4.3-latest": "grok-4.3",
"grok-4.5-latest": "grok-4.5",
"grok-4.7-latest": "grok-4.7",
"grok-build-latest": "grok-4.5"
}
}
}
},
"providerEndpoints": [
{
"endpointClass": "xai-native",
"hosts": [
"api.x.ai"
]
},
{
"endpointClass": "custom",
"baseUrls": [
"https://cli-chat-proxy.grok.com/v1"
]
}
],
"providerRequest": {
"providers": {
"xai": {
"family": "xai"
}
}
},
"modelCatalog": {
"providers": {
"xai": {
"baseUrl": "https://api.x.ai/v1",
"api": "openai-responses",
"models": [
{
"id": "grok-4.7",
"name": "Grok 4.7",
"reasoning": true,
"input": [
"text",
"image"
],
"cost": {
"input": 2,
"output": 6,
"cacheRead": 0.5,
"cacheWrite": 0
},
"contextWindow": 500000,
"maxTokens": 64000
},
{
"id": "grok-4.6",
"name": "Grok 4.6",
"reasoning": true,
"input": [
"text",
"image"
],
"cost": {
"input": 2,
"output": 6,
"cacheRead": 0.5,
"cacheWrite": 0
},
"contextWindow": 500000,
"maxTokens": 64000
},
{
"id": "grok-4.5",
"name": "Grok 4.5",
"reasoning": true,
"input": [
"text",
"image"
],
"cost": {
"input": 2,
"output": 6,
"cacheRead": 0.3,
"cacheWrite": 0
},
"contextWindow": 500000,
"maxTokens": 64000
},
{
"id": "grok-build-0.1",
"name": "Grok Build 0.1",
"reasoning": true,
"input": [
"text",
"image"
],
"cost": {
"input": 1,
"output": 2,
"cacheRead": 0.2,
"cacheWrite": 0
},
"contextWindow": 256000,
"maxTokens": 64000
},
{
"id": "grok-4.3",
"name": "Grok 4.3",
"reasoning": true,
"input": [
"text",
"image"
],
"cost": {
"input": 1.25,
"output": 2.5,
"cacheRead": 0.2,
"cacheWrite": 0
},
"contextWindow": 1000000,
"maxTokens": 64000
},
{
"id": "grok-4.20-0309-reasoning",
"name": "Grok 4.20 0309 (Reasoning)",
"reasoning": true,
"input": [
"text",
"image"
],
"cost": {
"input": 1.25,
"output": 2.5,
"cacheRead": 0.2,
"cacheWrite": 0
},
"contextWindow": 1000000,
"maxTokens": 30000
},
{
"id": "grok-4.20-0309-non-reasoning",
"name": "Grok 4.20 0309 (Non-Reasoning)",
"reasoning": false,
"input": [
"text",
"image"
],
"cost": {
"input": 1.25,
"output": 2.5,
"cacheRead": 0.2,
"cacheWrite": 0
},
"contextWindow": 1000000,
"maxTokens": 30000
}
]
}
},
"aliases": {
"x-ai": {
"provider": "xai"
}
},
"discovery": {
"xai": "refreshable"
},
"suppressions": [
{
"provider": "xai",
"model": "auto",
"reason": "The xAI auto selector has retired; use a concrete model.",
"retirement": {
"replacedBy": "grok-4.7"
},
"when": {
"baseUrlHosts": [
"cli-chat-proxy.grok.com",
"api.x.ai"
]
}
},
{
"provider": "xai",
"model": "grok-4.20-multi-agent-0309",
"reason": "OpenClaw does not currently support xAI multi-agent models; choose another xAI model. See https://docs.openclaw.ai/providers/xai."
},
{
"provider": "xai",
"model": "grok-4.20-multi-agent",
"reason": "OpenClaw does not currently support xAI multi-agent models; choose another xAI model. See https://docs.openclaw.ai/providers/xai."
},
{
"provider": "xai",
"model": "grok-4.20-multi-agent-latest",
"reason": "OpenClaw does not currently support xAI multi-agent models; choose another xAI model. See https://docs.openclaw.ai/providers/xai."
},
{
"provider": "xai",
"model": "grok-4.20-multi-agent-beta-latest",
"reason": "OpenClaw does not currently support xAI multi-agent models; choose another xAI model. See https://docs.openclaw.ai/providers/xai."
},
{
"provider": "xai",
"model": "grok-4.20-multi-agent-experimental-beta-0304",
"reason": "OpenClaw does not currently support xAI multi-agent models; choose another xAI model. See https://docs.openclaw.ai/providers/xai."
},
{
"provider": "xai",
"model": "grok-4.20-multi-agent-experimental-beta-latest",
"reason": "OpenClaw does not currently support xAI multi-agent models; choose another xAI model. See https://docs.openclaw.ai/providers/xai."
},
{
"provider": "xai",
"model": "grok-4.20-multi-agent-beta-0309",
"reason": "OpenClaw does not currently support xAI multi-agent models; choose another xAI model. See https://docs.openclaw.ai/providers/xai."
}
]
},
"syntheticAuthRefs": [
"xai"
],
"setup": {
"providers": [
{
"id": "xai",
"envVars": [
"XAI_API_KEY"
]
}
]
},
"providerAuthChoices": [
{
"provider": "xai",
"method": "api-key",
"personalAccount": true,
"choiceId": "xai-api-key",
"appGuidedSecret": true,
"choiceLabel": "xAI API key",
"groupId": "xai",
"groupLabel": "xAI (Grok)",
"groupHint": "API key or OAuth",
"onboardingFeatured": true,
"optionKey": "xaiApiKey",
"cliFlag": "--xai-api-key",
"cliOption": "--xai-api-key <key>",
"cliDescription": "xAI API key"
},
{
"provider": "xai",
"method": "oauth",
"personalAccount": true,
"choiceId": "xai-oauth",
"appGuidedAuth": "device-code",
"credentialOnly": true,
"channelLogin": {},
"choiceLabel": "xAI OAuth",
"choiceHint": "Remote-friendly browser sign-in without a localhost callback",
"groupId": "xai",
"groupLabel": "xAI (Grok)",
"groupHint": "API key or OAuth",
"onboardingFeatured": true
},
{
"provider": "xai",
"method": "device-code",
"choiceId": "xai-device-code",
"appGuidedAuth": "device-code",
"choiceLabel": "xAI device code",
"choiceHint": "Compatibility alias for xAI OAuth device-code sign-in",
"assistantVisibility": "manual-only",
"groupId": "xai",
"groupLabel": "xAI (Grok)",
"groupHint": "API key or OAuth"
}
],
"uiHints": {
"webSearch.apiKey": {
"label": "Grok Search API Key",
"help": "Optional xAI API key for Grok web search; xAI OAuth or XAI_API_KEY can satisfy it.",
"sensitive": true
},
"webSearch.model": {
"label": "Grok Search Model",
"help": "Grok model override for web search."
},
"webSearch.baseUrl": {
"label": "Grok Search Base URL",
"help": "Optional xAI Responses API base URL for Grok web_search and x_search fallbacks."
},
"webSearch.inlineCitations": {
"label": "Inline Citations",
"help": "Include inline markdown citations in Grok responses."
},
"codeExecution.enabled": {
"label": "Enable Code Execution",
"help": "Expose code_execution on active xAI models; true opts in when the active provider is known non-xAI, false disables, and missing provider fails closed. Requires xAI auth; xAI bills $5/1,000 calls plus model tokens."
},
"xSearch.enabled": {
"label": "Enable X Search",
"help": "Expose x_search on active xAI models; true opts in when the active provider is known non-xAI, false disables, and missing provider fails closed. Requires xAI auth; xAI bills $5/1,000 calls plus model tokens."
},
"xSearch.model": {
"label": "X Search Model",
"help": "xAI model override for x_search."
},
"xSearch.baseUrl": {
"label": "X Search Base URL",
"help": "Optional xAI Responses API base URL for x_search requests."
},
"xSearch.inlineCitations": {
"label": "X Search Inline Citations",
"help": "Keep inline markdown citations from xAI in x_search responses when available."
},
"xSearch.maxTurns": {
"label": "X Search Max Turns",
"help": "Optional max internal tool turns xAI may use per x_search request."
},
"xSearch.timeoutSeconds": {
"label": "X Search Timeout",
"help": "Timeout in seconds for x_search requests."
},
"xSearch.cacheTtlMinutes": {
"label": "X Search Cache TTL",
"help": "Cache TTL in minutes for x_search results."
},
"codeExecution.model": {
"label": "Code Execution Model",
"help": "xAI model override for code_execution."
},
"codeExecution.maxTurns": {
"label": "Code Execution Max Turns",
"help": "Optional max internal tool turns xAI may use for code_execution."
},
"codeExecution.timeoutSeconds": {
"label": "Code Execution Timeout",
"help": "Timeout in seconds for code_execution requests."
}
},
"contracts": {
"webSearchProviders": [
"grok"
],
"usageProviders": [
"xai"
],
"videoGenerationProviders": [
"xai"
],
"mediaUnderstandingProviders": [
"xai"
],
"speechProviders": [
"xai"
],
"realtimeTranscriptionProviders": [
"xai"
],
"realtimeVoiceProviders": [
"xai",
"grok-voice",
"xai-realtime-voice"
],
"imageGenerationProviders": [
"xai"
],
"tools": [
"code_execution",
"x_search"
]
},
"mediaUnderstandingProviderMetadata": {
"xai": {
"capabilities": [
"audio"
],
"autoPriority": {
"audio": 25
}
}
},
"toolMetadata": {
"code_execution": {
"authSignals": [
{
"provider": "xai"
}
],
"configSignals": [
{
"rootPath": "plugins.entries.xai.config",
"overlayPath": "webSearch",
"required": [
"apiKey"
]
}
]
},
"x_search": {
"replaySafe": true,
"authSignals": [
{
"provider": "xai"
}
],
"configSignals": [
{
"rootPath": "plugins.entries.xai.config",
"overlayPath": "webSearch",
"required": [
"apiKey"
]
}
]
}
},
"configGroups": [
{
"id": "web-search",
"title": "Web search",
"order": 10,
"properties": [
"webSearch"
]
},
{
"id": "x-search",
"title": "X search",
"order": 20,
"properties": [
"xSearch"
]
},
{
"id": "code-execution",
"title": "Code execution",
"order": 30,
"properties": [
"codeExecution"
]
}
],
"configSchema": {
"type": "object",
"additionalProperties": false,
"properties": {
"webSearch": {
"type": "object",
"additionalProperties": false,
"properties": {
"apiKey": {
"type": [
"string",
"object"
]
},
"model": {
"type": "string"
},
"baseUrl": {
"type": "string"
},
"inlineCitations": {
"type": "boolean"
}
}
},
"xSearch": {
"type": "object",
"additionalProperties": false,
"properties": {
"enabled": {
"type": "boolean"
},
"model": {
"type": "string"
},
"baseUrl": {
"type": "string"
},
"inlineCitations": {
"type": "boolean"
},
"maxTurns": {
"type": "number"
},
"timeoutSeconds": {
"type": "number"
},
"cacheTtlMinutes": {
"type": "number"
}
}
},
"codeExecution": {
"type": "object",
"additionalProperties": false,
"properties": {
"enabled": {
"type": "boolean"
},
"model": {
"type": "string"
},
"maxTurns": {
"type": "number"
},
"timeoutSeconds": {
"type": "number"
}
}
}
}
}
}