xAI

内置 grok Web 搜索提供商可以使用 XAI_API_KEY 或插件 Web 搜索密钥：

openclaw 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 角色时为 1-10 秒，扩展为 2-10 秒
• 参考图像生成：为每张提供的图像将 imageRoles 设置为 reference_image；xAI 最多接受 7 张这样的图像

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

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

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

• 默认图像模型：xai/grok-imagine-image
• 附加模型：xai/grok-imagine-image-pro
• 模式：文本到图像和参考图像编辑
• 参考输入：一个 image 或最多五个 images
• 宽高比：1:1、16:9、9:16、4:3、3:4、2:3、3:2
• 分辨率：1K、2K
• 数量：最多 4 张图像

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 音频文件上传
• 在 OpenClaw 中，只要入站音频转录使用 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
• 中间转录：默认启用

语音通话的 Twilio 媒体流会发送 G.711 µ-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",            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",          },        },      },    },  },}

• 目前认证仅支持 API 密钥。API 密钥可以存储在 xAI 认证 配置文件、环境变量或插件配置中；OpenClaw 中尚无 xAI OAuth 或 设备代码流程。
• grok-4.20-multi-agent-experimental-beta-0304 在 常规 xAI 提供商路径上不受支持，因为它所需的上游 API 表面不同于标准 OpenClaw xAI 传输。
• xAI Realtime 语音尚未注册为 OpenClaw 提供商。它 需要不同于批量 STT 或流式转录的双向语音会话契约。
• 在共享 image_generate 工具拥有相应的跨提供商控制之前， 不会暴露 xAI 图像 quality、图像 mask 和额外的仅原生宽高比。

• OpenClaw 会在共享运行器路径上自动应用 xAI 专属的工具 schema 和工具调用兼容性修复。
• 原生 xAI 请求默认使用 tool_stream: true。将 agents.defaults.models["xai/<model>"].params.tool_stream 设置为 false 可将其 禁用。
• 内置 xAI 包装器会在发送原生 xAI 请求之前移除不受支持的严格工具 schema 标志和 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。