Grok 接入
这篇解决什么
Grok 平台字符串怎么填、默认打哪个 xAI 地址。读完能对上 AiPlatformEnum.GROK = "Grok",以及对话选项复用 OpenAiChatOptions。
默认端口 48080。开启见 AI 功能设计。
示意图:包装类复用 OpenAI 客户端。url 空则用类里的默认 Base URL。
从哪改
| 名称 | 说明 | 仓库路径 |
|---|---|---|
| 密钥 | @RequestMapping("/ai/api-key") | ruoyi-office/yudao-module-ai/.../controller/admin/model/AiApiKeyController.java |
| 工厂 | buildGrokChatModel(apiKey, url) | AiModelFactoryImpl |
| 包装 | BASE_URL / COMPLETE_PATH | GrokChatModel |
| 选项 | OpenAiChatOptions | AiUtils.buildChatOptions |
| 管理端 | 密钥、模型页 | ruoyi-office-vben/apps/web-antd/src/views/ai/model/ |
官方菜单:密钥 2761,模型 2767。没有「Grok」独立菜单。
默认地址 https://api.x.ai,补全路径 /v1/chat/completions。类里默认模型名 grok-4.3,以 xAI 当前可点名为准。
/draw 没有 Grok 分支。对话用 type=1。
字段
| 名称 | 说明 | 仓库路径 |
|---|---|---|
platform | 必须是 Grok | AiApiKeyDO / AiModelDO |
apiKey / url | 密钥;url 可选 | AiApiKeyDO |
model | 如 grok-4.3 | AiModelDO |
不是 XAI 也不是 Twitter
枚举值是 Grok。填 xAI 会校验失败。
和 OpenAI 只是选项类复用
platform 必须是 Grok 才会进 buildGrokChatModel。YAML 开关是 yudao.ai.grok.enable。
按本仓库 DO 生成的 ER。
配置与操作
走 API 密钥(2761)建 platform=Grok。对话选项复用 OpenAiChatOptions,默认打 xAI 地址。YAML yudao.ai.grok.enable 只控制装配。
再在 模型配置 建 type=1。开启见 AI 功能设计。

本系统截图:AI 大模型 → 控制台 → API 密钥。各厂商共用这一页,用 platform 区分。

本系统截图:控制台 → 模型配置。keyId 必须指向同平台密钥。
