xAI

内置的 grok Web 搜索提供商优先使用 xAI OAuth，然后回退到 XAI_API_KEY 或插件 Web 搜索密钥：

openclaw models auth login --provider xai --method oauthopenclaw config set tools.web.search.provider grok

内置的 xai 插件通过共享的 video_generate 工具注册视频生成。

• 默认视频模型：xai/grok-imagine-video
• 模式：文生视频、图生视频、参考图像生成、远程视频编辑和远程视频扩展
• 宽高比：1:1、16:9、9:16、4:3、3:4、3:2、2:3
• 分辨率：480P、720P
• 时长：生成/图生视频为 1-15 秒，使用 reference_image role 时为 1-10 秒，扩展为 2-10 秒
• 参考图像生成：为每张提供的图像将 imageRoles 设置为 reference_image；xAI 最多接受 7 张此类图像
• 默认操作超时：600 秒，除非设置了 video_generate.timeoutMs 或 agents.defaults.videoGenerationModel.timeoutMs

要将 xAI 用作默认视频提供商：

{  agents: {    defaults: {      videoGenerationModel: {        primary: "xai/grok-imagine-video",      },    },  },}

内置的 xai 插件通过共享的 image_generate 工具注册图像生成。

• 默认图像模型：xai/grok-imagine-image
• 其他模型：xai/grok-imagine-image-quality
• 模式：文生图和参考图像编辑
• 参考输入：一个 image 或最多五个 images
• 宽高比：1:1、16:9、9:16、4:3、3:4、2:3、3:2
• 分辨率：1K、2K
• 数量：最多 4 张图像
• 默认操作超时：600 秒，除非设置了 image_generate.timeoutMs 或 agents.defaults.imageGenerationModel.timeoutMs

OpenClaw 会向 xAI 请求 b64_json 图像响应，以便生成的媒体可以通过正常的渠道附件路径存储和发送。本地参考图像会转换为 data URL；远程 http(s) 参考会原样传递。

要将 xAI 用作默认图像提供商：

{  agents: {    defaults: {      imageGenerationModel: {        primary: "xai/grok-imagine-image",      },    },  },}

内置的 xai 插件通过共享 tts 提供商表面注册文本转语音。

• 语音：eve、ara、rex、sal、leo、una
• 默认语音：eve
• 格式：mp3、wav、pcm、mulaw、alaw
• 语言：BCP-47 代码或 auto
• 速度：提供商原生速度覆盖
• 不支持原生 Opus 语音便笺格式

要将 xAI 用作默认 TTS 提供商：

{  messages: {    tts: {      provider: "xai",      providers: {        xai: {          voiceId: "eve",        },      },    },  },}

内置的 xai 插件通过 OpenClaw 的媒体理解转录表面注册批量语音转文本。

• 默认模型：grok-stt
• 端点：xAI REST /v1/stt
• 输入路径：multipart 音频文件上传
• 用于所有入站音频转录读取 tools.media.audio 的位置， 包括 Discord 语音频道片段和渠道音频附件

要强制 xAI 用于入站音频转录：

{  tools: {    media: {      audio: {        models: [          {            type: "provider",            provider: "xai",            model: "grok-stt",          },        ],      },    },  },}

语言可以通过共享音频媒体配置或每次调用的 转录请求提供。共享的 OpenClaw 表面接受提示词提示，但 xAI REST STT 集成只转发文件、模型和 语言，因为这些能清晰映射到当前公开的 xAI 端点。

内置的 xai 插件还会为实时语音通话音频注册一个实时转录提供商。

• 端点：xAI WebSocket wss://api.x.ai/v1/stt
• 默认编码：mulaw
• 默认采样率：8000
• 默认端点检测：800ms
• 临时转录文本：默认启用

Voice Call 的 Twilio 媒体流会发送 G.711 mu-law 音频帧，因此 xAI 提供商会直接转发这些帧，无需转码：

{  plugins: {    entries: {      "voice-call": {        config: {          streaming: {            enabled: true,            provider: "xai",            providers: {              xai: {                apiKey: "${XAI_API_KEY}",                endpointingMs: 800,                language: "en",              },            },          },        },      },    },  },}

提供商拥有的配置位于 plugins.entries.voice-call.config.streaming.providers.xai 下。支持的 键为 apiKey、baseUrl、sampleRate、encoding（pcm、mulaw 或 alaw）、interimResults、endpointingMs 和 language。

内置的 xAI 插件将 x_search 作为 OpenClaw 工具公开，用于 通过 Grok 搜索 X（以前称为 Twitter）内容。

配置路径：plugins.entries.xai.config.xSearch

{  plugins: {    entries: {      xai: {        config: {          xSearch: {            enabled: true,            model: "grok-4-1-fast-non-reasoning",            baseUrl: "https://api.x.ai/v1",            inlineCitations: true,          },        },      },    },  },}

内置的 xAI 插件将 code_execution 作为 OpenClaw 工具公开，用于 在 xAI 的沙箱环境中远程执行代码。

配置路径：plugins.entries.xai.config.codeExecution

{  plugins: {    entries: {      xai: {        config: {          codeExecution: {            enabled: true,            model: "grok-4-1-fast",          },        },      },    },  },}

• xAI 凭证可以使用 API 密钥、环境变量、插件配置 回退，或使用符合条件的 xAI 账户进行 OAuth。OAuth 使用设备码 验证，不需要 localhost 回调。xAI 决定哪些账户 可以接收 OAuth API 令牌，并且同意页面可能显示 Grok Build， 即使 OpenClaw 不需要 Grok Build 应用。
• OpenClaw 当前不公开 xAI 多智能体模型系列。xAI 通过 Responses API 提供这些模型，但它们不接受 OpenClaw 共享 Agent loop 使用的客户端侧或自定义工具。 请参阅 xAI 多智能体限制。
• xAI Realtime 语音尚未注册为 OpenClaw 提供商。它 需要与批处理 STT 或流式转录不同的双向语音会话合约。
• xAI 图像 quality、图像 mask 和额外的仅原生宽高比 在共享 image_generate 工具具备 对应的跨提供商控件之前不会公开。

• OpenClaw 会在共享运行器路径上自动应用 xAI 专用的工具 schema 和工具调用兼容性 修复。
• 原生 xAI 请求默认 tool_stream: true。将 agents.defaults.models["xai/<model>"].params.tool_stream 设置为 false 可禁用它。
• 内置的 xAI 包装器会在发送原生 xAI 请求前剥离不支持的严格工具 schema 标志和 reasoning effort 载荷键。只有 grok-4.3 / grok-4.3-* 声明支持可配置 reasoning effort；所有 其他具备 reasoning 能力的 xAI 模型仍会请求 include: ["reasoning.encrypted_content"]，以便在后续轮次中重放之前加密的 reasoning。
• web_search、x_search 和 code_execution 作为 OpenClaw 工具公开。OpenClaw 只会把每个工具所需的特定 xAI 内置项附加到 该工具的请求，而不是把每个原生工具附加到每个 聊天轮次。
• Grok web_search 读取 plugins.entries.xai.config.webSearch.baseUrl。 x_search 读取 plugins.entries.xai.config.xSearch.baseUrl，然后 回退到 Grok Web 搜索基础 URL。
• x_search 和 code_execution 由内置的 xAI 插件拥有， 而不是硬编码到核心模型运行时。
• code_execution 是远程 xAI 沙箱执行，不是本地 exec。