内置积分不够用了？想直接上 Grok 最新能力，又不想等客户端把模型列表刷出来？
只要手里有一把 OpenAI 兼容 网关的 Key，WorkBuddy 就能把「自定义供应商」接到 Grok。这篇按我自己实机「编辑模型」弹窗走一遍，模型名用的是 grok-4.7。
实测笔记。WorkBuddy 是腾讯云 CodeBuddy 团队的桌面 AI Agent，官方支持 OpenAI 兼容自定义模型。配置字段以本次截图为准；Key 已脱敏，文中不会出现真实密钥。官方说明可对照：WorkBuddy 模型配置 与 腾讯云文档。
01｜先说结论：三步就能挂上
整体就三件事------打开设置、填自定义接口、勾能力并测连：
图 1：流程示意（自制），不是客户端假截图。
入口有两种，效果一样：
- 头像 → 设置 → 模型 → 添加模型
- 对话里打开模型选择器，滚到底点 「配置自定义模型」
供应商不在预设列表时，选 自定义 。自定义场景下，能力开关不会自动探测 ------想让 Agent 真正动手改文件、调工具，必须自己勾上 「工具调用」。这点官方也写得很清楚：选标准供应商时能力标记会自动写入；走自定义就要手勾。
02｜准备两样东西
- WorkBuddy 客户端（已登录即可）
- 一把 OpenAI 兼容网关的 API Key
我这次用的是 momoai.asia 这类网关：接口地址形如https://momoai.asia/v1/chat/completions，模型名填控制台里的 id（本文是grok-4.7）。你换成自己拿到的 Key 就行，别把 Key 发到群里或提交进公开仓库。
Key 只存在本机。官方说法是保存在 workbuddy/models.json；老版本 / CodeBuddy 系路径里也可能看到 ~/.codebuddy/models.json。界面升级后，旧文件里的模型一般仍能在 UI 里编辑，不必手改 JSON。
03｜按弹窗逐项填写（对照实机截图）
下面这张是「编辑模型」保存前的完成态，字段和勾选状态就是我实测用的：
图 2：实机「编辑模型」弹窗。供应商=自定义；接口写到 /v1/chat/completions；模型名 grok-4.7；API Key 已脱敏。高级配置已勾：工具调用、图片输入、思考模式、上下文预测思考。
对照表：
| 字段 | 本次填写 | 注意 |
|---|---|---|
| 供应商 | 自定义 | 仅支持 OpenAI 兼容协议 API |
| 接口地址 | https://momoai.asia/v1/chat/completions |
写完整到 /v1/chat/completions；标准路径一般不用开「自定义协议」 |
| API Key | 填你在 momoai.asia 拿到的 Key | 界面里是掩码；测连通过再保存 |
| 模型名称 | grok-4.7 |
大小写、点号都要跟网关目录一致 |
高级配置（已勾的）：
- 工具调用 ------ Agent 要动手，这项必开
- 图片输入
- 思考模式
- 上下文预测思考
截图里还有一项没勾，名称被遮住了一截，这里不瞎猜；没勾就不要硬开。
填完后点 「测试连接」 ，通了再点 「保存」。
04｜保存后怎么确认真的接上了
- 回到对话界面，打开模型选择器
- 在 自定义 分组里找到刚存的条目（名称多半就是
grok-4.7或你起的显示名） - 选中后发一条真实任务：例如「读一下当前目录结构再改某个小文件」
如果只能干聊、死活不碰本地文件，优先回头看 「工具调用」 有没有勾上------这是自定义接入里最常见的坑。
接上之后，可以按这张清单快速对一遍：
图 3：核对清单示意（自制）。
05｜排错（我踩过 / 见过的）
| 现象 | 先查什么 |
|---|---|
| 测试连接失败 | 接口末尾多/少斜杠；Key 前后空格；网关是否可达 |
| model not found | 模型名大小写、点号是否写成 grok-4.7（以你网关目录为准） |
| 能聊天但不改文件、不调工具 | 没勾「工具调用」 |
| 请求路径怪异 | 标准 /v1/chat/completions 一般保持「自定义协议」关闭；非标准路径才考虑开启 |
| 保存后对话里找不到 | 看模型选择器的「自定义」分组，或重新打开一次设置页 |
06｜小结
WorkBuddy 自定义模型的核心就三行：
- 供应商选 自定义
- 接口写完整：
https://momoai.asia/v1/chat/completions（或你自己的兼容网关） - 模型名
grok-4.7，并勾上 工具调用 （以及你需要的图片输入 / 思考相关项）→ 测试连接 → 保存
内置列表更新再慢，也能自己把 Grok 最新档挂进桌面 Agent。
如果后面还要换别的模型，接口和 Key 往往不用动，只改「模型名称」一行。统一 Key 调多模型，可在 https://momoai.asia 申请；需要单独走 Grok 通道时，也可参考 https://chongzhi.chatgpt-plus.top/grok/ 这类实测入口（以页面当时说明为准，本文不涉及套餐细节）。