WorkBuddy 配置自定义模型

这篇教程只讲 WorkBuddy 当前界面里的配置方法。准备好 OmniaKey API Key 和一个模型 ID 后，几分钟就能完成。

本文已在 macOS 版 WorkBuddy v5.3.14 实机核对添加表单、已保存模型和模型选择器。腾讯云官方文档要求该功能至少使用 v4.22.15。

开始前准备两样东西

一把 OmniaKey API Key

登录 OmniaKey，打开 API Keys 页面，然后：

1. 点击 创建 Key。
2. 名称填写 WorkBuddy，按需要设置额度和过期时间。
3. 点击 创建，立即复制新生成的 Key。

先不要关闭显示 Key 的窗口，下一步要把它粘贴进 WorkBuddy。Key 和密码一样，不要放进截图、聊天记录或公开文件。

账号还需要有可用余额或试用额度。Key 创建成功只代表拿到了凭据，不代表账户一定还有调用额度。

一个准确的模型 ID

打开 OmniaKey 模型目录，选择一个当前可用的模型，复制页面显示的模型 ID。第一次测试可以先用：

deepseek-v4-flash

模型 ID 必须逐字一致。不要把 DeepSeek V4 Flash 这样的展示名称填进去，也不要自己删掉连接符或版本后缀。

第一步：打开“添加模型”

启动 WorkBuddy，打开：

系统设置 → 模型 → + 添加模型

进入“模型”页面后，点击右上角的 + 添加模型。

也可以从新建任务页面底部进入：

模型选择器 → + 配置自定义模型

如果两个入口都没有，先把 WorkBuddy 更新到 v4.22.15 或更高版本。腾讯云当前官方文档明确要求至少使用这个版本。

第二步：选择自定义厂商并填写四个字段

打开“添加模型”后，按页面从上到下填写。

1. 提供商选择“自定义”

点击“提供商”下拉框，找到并选择：

自定义 / Custom

在 v5.3.14 的下拉菜单中，它位于“其他”分组。不要选择 OpenAI 官方项、腾讯云 Token Plan 或其它内置厂商，因为这些选项不会让你填写 OmniaKey 的接口地址。

2. 接口地址只填到 /v1

在“接口地址”或“Base URL”中完整填写：

https://api.omniakey.com/v1

3. 粘贴 API Key

把刚才从 OmniaKey 复制的 Key 粘贴到 API Key 输入框。不要加引号，不要在前后留下空格，也不要把 Bearer 一起填进去。

正确的是直接粘贴 Key 本身：

[你的 OmniaKey API Key]

4. 填写模型名称

在“模型名称”或“Model ID”中填写刚才复制的准确 ID：

deepseek-v4-flash

填完后，页面上的核心内容应该是：

提供商：自定义 / Custom
接口地址：https://api.omniakey.com/v1
API Key：[你的 OmniaKey API Key]
模型名称：deepseek-v4-flash

第一次只验证连接时，先保留新建表单的默认值，并确保“自定义协议”处于关闭状态。v5.3.14 的默认状态是工具调用开，图片输入、推理模式和自定义协议关，输入与输出使用提供商默认值。本文后面再给出 deepseek-v4-flash 的实机成功配置。

第三步：保存，选择模型并发送测试消息

点击 保存，回到新建任务页面。打开底部的模型选择器，在“自定义模型”区域选择刚添加的 deepseek-v4-flash。

先发送一条最短的测试消息：

只回复四个字：连接成功

收到正常回复后，说明下面四件事已经同时通过：

1. WorkBuddy 保存了自定义厂商配置。
2. 接口地址正确。
3. API Key 可以鉴权并且账户有可用额度。
4. 当前 Key 可以调用这个模型 ID。

最后打开 OmniaKey 用量页面，确认出现刚才的调用记录和正确的模型名称。这样才算完成从 WorkBuddy 到 OmniaKey 的整条验证。

如果保存后模型没有马上出现在列表里，先收起并重新打开模型选择器。仍然看不到时，完全退出 WorkBuddy 后重新启动一次。

高级选项第一次怎么选

基础对话成功前，不要一次改很多高级选项。新建自定义模型时，WorkBuddy v5.3.14 的默认状态是：

这组默认值可以先用来验证 URL、Key 和模型名称。基础对话成功后，再根据模型能力调整。

deepseek-v4-flash 实机成功配置

本文在本机已保存模型和实际回复中核对到下面这组设置：

开启推理模式后，WorkBuddy 才会显示“仅思考模式”“允许关闭思考”和思考强度设置。第一次不要手动勾选强度档位；保留“自动”即可。

工具调用什么时候开

当你准备让 WorkBuddy 读取文件、调用连接器或执行 Agent 任务时，再打开“工具调用”。同时确认所选模型在 OmniaKey 目录中标有工具调用能力。deepseek-v4-flash 当前支持工具调用，可以在基础聊天成功后开启并做一个只读测试；只验证对话时可以保持关闭。

图片输入什么时候开

只有模型明确支持视觉输入时才打开。开关本身不会让纯文本模型突然获得看图能力；模型不支持时，请求仍会失败。

推理模式什么时候开

模型目录或模型文档明确写有 reasoning、thinking 或思考模式时再打开。开启后保留“自动”强度和“允许关闭思考”，不要为了“更强”随意填写模型不支持的档位。“仅思考模式”通常不适合作为日常默认设置。

想添加第二个模型怎么办

不要把已经验证成功的模型名称直接覆盖掉。重新进入“添加模型”，继续使用同一个 OmniaKey URL 和 API Key，只替换准确的模型 ID，再单独保存。

这样可以在 WorkBuddy 模型选择器中保留多个自定义模型。建议先验证一个，再逐个添加，出现问题时更容易判断是哪一项配置导致的。

配置失败，按看到的现象处理

找不到“配置自定义模型”

先检查 WorkBuddy 版本。更新到 v4.22.15 或更高后，再从新建任务底部的模型选择器或“系统设置 → 模型”进入。

提示 401、Unauthorized 或 API Key 无效

重新复制 OmniaKey Key，确认没有前后空格，也没有把 Bearer 一起粘贴。然后检查 Key 是否启用、是否过期，以及账号余额和 Key 额度是否可用。

换一个模型名称不能解决 401，因为这一步失败在鉴权。

提示 404 或接口不存在

接口地址必须正好是：

https://api.omniakey.com/v1

不要只填裸域名，不要重复成 /v1/v1，也不要追加 /chat/completions。同时确认“自定义协议”关闭。

提示模型不存在或 UNKNOWN_MODEL

回到实时模型目录重新复制模型 ID。展示名称、自己猜的简称和已经下线的旧 ID 都不能代替当前准确 ID。

能聊天，但工具调用失败

这说明基础模型连接已经成功。接着检查 WorkBuddy 的“工具调用”开关和模型目录里的工具能力；API Key 和 URL 不需要反复重填。

图片发送失败

同时检查两项：模型本身支持图片输入，并且 WorkBuddy 的“图片输入”已经打开。只满足其中一项还不够。

保存后列表里没有模型

确认已经点击“保存”，再重新打开模型选择器。仍然没有时，重启 WorkBuddy；如果配置入口也消失了，继续检查客户端版本。

常见问题

WorkBuddy 的 OmniaKey URL 到底填什么？

只填 https://api.omniakey.com/v1。这是 Base URL，WorkBuddy 会自动补上实际请求路径。

需要创建 models.json 吗？

不需要。这篇教程使用 WorkBuddy 当前的“配置自定义模型”界面。旧版配置文件教程和当前界面不是同一条操作路径。

可以配置 GPT、Claude、Gemini 或其它模型吗？

可以，只要模型当前出现在 OmniaKey 目录并支持 OpenAI 兼容调用。添加时继续使用同一个 URL，把“模型名称”换成目录里的准确 ID。

MCP 也在这里配置吗？

不是。这里配置的是模型 API；MCP 或连接器属于 WorkBuddy 的另一项设置。先让模型基础对话成功，再单独配置工具和连接器。

核对来源

• 腾讯云：WorkBuddy 配置与使用说明
• OmniaKey OpenAI 兼容 API 文档
• OmniaKey 实时模型目录