概述
xAI 是马斯克创立的 AI 公司，旗下 Grok 系列模型近年来快速迭代，在推理能力和代码生成方面表现突出。OpenClaw 以内置插件形式集成 xAI，提供者 ID 为 xai，目前仅支持 API Key 认证方式（暂不支持 OAuth 设备授权流程）。Grok 还可作为 OpenClaw 网络搜索工具的后端，实现带有实时联网能力的问答。
快速开始
第一步：获取 API Key
前往 console.x.ai 创建账号并生成 API Key。
第二步：设置环境变量
export XAI_API_KEY="xai-xxxxxxxxxxxxxxxxxxxx"
第三步：引导配置
openclaw onboard --auth-choice xai-api-key
配置参数
{
env: {
XAI_API_KEY: "xai-xxxxxxxxxxxxxxxxxxxx"
},
agents: {
defaults: {
model: {
primary: "xai/grok-4"
}
}
}
}
如需区分推理型与非推理型任务，可分别指定：
{
agents: {
coder: {
model: {
primary: "xai/grok-4",
background: "xai/grok-4-fast-non-reasoning"
}
}
}
}
支持的模型
| 模型 ID | 类型 | 说明 |
|---|---|---|
xai/grok-4 |
通用旗舰 | 当前最强 Grok 模型 |
xai/grok-4-0709 |
旗舰特定版本 | 固定版本号，生产环境推荐 |
xai/grok-4-fast-reasoning |
快速推理 | 推理能力强，速度较快 |
xai/grok-4-fast-non-reasoning |
快速生成 | 适合无需深度推理的任务 |
xai/grok-code-fast-1 |
代码专用 | 针对编程任务优化 |
启用 Grok 网络搜索
xAI 支持作为 OpenClaw 网络搜索工具的提供商，赋予模型实时获取网络信息的能力：
openclaw config set tools.web.search.provider grok
或在配置文件中设置：
{
tools: {
web: {
search: {
provider: "grok"
}
}
}
}
注意事项
暂不支持 OAuth：当前 xAI 在 OpenClaw 中仅支持 API Key 认证，不支持设备授权码等 OAuth 流程。密钥请妥善保管，不要提交到代码仓库。
不支持的实验性模型：grok-4.20-multi-agent-experimental-beta-0304 因其特殊 API 接口要求，OpenClaw 目前无法兼容。
原生工具支持：xAI 原生提供 x_search（X 平台搜索）和 code_execution（代码执行）等服务端工具，OpenClaw 暂未为这些工具提供一级支持，建议通过标准 web 搜索配置替代。
模型 ID 前向解析：新发布的 grok-4* 和 grok-code-fast* 系列模型 ID 遵循标准 API 命名规范，OpenClaw 支持自动解析，无需等待插件更新即可使用新模型。