xAI

OpenClaw 内置了 xai provider 插件，支持 Grok 系列模型。

配置步骤

1. 在 xAI 控制台创建 API Key。
2. 设置 XAI_API_KEY，或运行：

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

3. 选择一个模型，例如：

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

内置模型目录

OpenClaw 目前内置以下 xAI 模型系列：

• 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

插件还支持前向兼容，凡遵循相同 API 规范的新版 grok-4* 和 grok-code-fast* ID 均可自动解析。

网页搜索

内置的 grok 网页搜索 provider 也使用 XAI_API_KEY，让你的龙虾具备实时联网搜索能力：

openclaw config set tools.web.search.provider grok

已知限制

• 目前仅支持 API Key 鉴权，OpenClaw 尚未支持 xAI 的 OAuth / 设备码流程。
• grok-4.20-multi-agent-experimental-beta-0304 不受标准 xAI provider 路径支持，因为它需要与标准 OpenClaw xAI 传输层不同的上游 API 接口。
• xAI 原生服务端工具（如 x_search 和 code_execution）尚未成为内置插件的一等模型 provider 特性。

说明

• OpenClaw 在共享 runner 路径上自动应用 xAI 特定的工具 schema 和工具调用兼容性修复。
• 关于更广泛的 provider 概览，请参见 模型 providers。