使用指南
返回主页

外观

WorkBuddy 配置 ​

WorkBuddy 是腾讯推出的桌面 AI 工作台，覆盖日常办公、代码开发和设计创意。这里通过 OpenAI 兼容接口添加 custom 自定义模型。

接入协议OpenAI Compatible / Chat Completions
打开安装说明

配置步骤

  1. 1

    打开 WorkBuddy，点击窗口左下角的头像与名称，再点击弹出菜单中的“设置”。

  2. 2

    在设置左侧点击“模型”，再点击右侧的“添加模型”。

  3. 3

    展开“提供商”列表，滚动到底部，选择“自定义 / Custom”。

  4. 4

    按下方复制区填写接口地址、API Key 和模型名称后点击“保存”。

  5. 5

    确认“已保存模型”中出现刚添加的模型，再点击右上角的 × 关闭设置。

  6. 6

    回到聊天页，点击输入框右下角的“Auto”，在“自定义模型”分组选择刚保存的模型。

  7. 7

    在输入框键入一条简单消息，点击右下角的发送按钮。

  8. 8

    确认 WorkBuddy 显示完整回复。

复制配置

WorkBuddy 自定义模型字段

提供商: 自定义 / Custom
baseURL: /chat/completions
API Key: sk-your-api-key
模型名称: gpt-5.6-sol
工具调用: 开启
图片输入: 按模型能力选择
推理模式: 按模型能力选择
自定义协议: 关闭
看图操作

WorkBuddy 配置流程图

按照 8 张 WorkBuddy macOS 中文界面截图，从账户菜单打开设置，添加 OpenAI 兼容自定义模型，选择模型并发送消息验证。

截图中的供应商名称是示例，仅用于定位操作入口。实际供应商名称或 ID 统一填写 custom；地址、密钥和模型请使用本页复制区的值。

界面可能随版本变化
  1. 第 1 步

    从左下角账户菜单打开设置

    1. 1

      先点击左下角的头像与名称，展开账户菜单。

    2. 2

      再点击菜单中的“设置”。

    点击窗口左下角的头像与名称，展开菜单后点击“设置”。截图中的账户昵称已遮盖。

    自行采集WorkBuddy 5.3.14（macOS 中文界面）
  2. 第 2 步

    进入模型设置并添加模型

    1. 1

      点击左侧的“模型”。

    2. 2

      点击右侧的“添加模型”。

    在设置左侧点击“模型”，然后点击右侧“本地配置文件”区域的“添加模型”。

    自行采集WorkBuddy 5.3.14（macOS 中文界面）
  3. 第 3 步

    在提供商列表选择自定义

    1. 1

      点击提供商下拉框，将列表滚动到底部。

    2. 2

      在“其他”分组点击“自定义 / Custom”。

    点击“提供商”下拉框，向下滚动到“其他”分组，再点击“自定义 / Custom”。

    自行采集WorkBuddy 5.3.14（macOS 中文界面）
  4. 第 4 步

    填写自定义模型字段并保存

    1. 1

      接口地址粘贴页面复制区中完整的 /v1/chat/completions 地址。

    2. 2

      API Key 粘贴自己的完整密钥。

    3. 3

      模型名称填写页面复制区当前显示的模型。

    4. 4

      启用“工具调用”；其他能力开关按模型实际能力选择。

    5. 5

      检查字段无误后点击“保存”。

    接口地址填写页面复制区提供的完整 /v1/chat/completions 地址，API Key 粘贴自己的完整密钥，模型名称使用页面当前显示的值。启用“工具调用”，再点击“保存”。截图中的密钥已隐藏，地址和模型名仅用于定位字段。

    自行采集WorkBuddy 5.3.14（macOS 中文界面）
  5. 第 5 步

    确认模型已保存并关闭设置

    1. 1

      确认“已保存模型”中显示刚添加的模型。

    2. 2

      点击右上角的 × 关闭设置。

    在“已保存模型”中确认刚添加的模型已出现，然后点击设置弹窗右上角的 × 回到聊天页。

    自行采集WorkBuddy 5.3.14（macOS 中文界面）
  6. 第 6 步

    在聊天页选择自定义模型

    1. 1

      点击“Auto”展开模型列表。

    2. 2

      在“自定义模型”分组点击刚保存的模型。

    点击输入框右下角的“Auto”展开模型列表，向下滚动到“自定义模型”，点击页面复制区显示的模型名称。截图中的模型名仅为界面示例。

    自行采集WorkBuddy 5.3.14（macOS 中文界面）
  7. 第 7 步

    输入消息并发送

    1. 1

      在输入框输入一条简单的测试消息。

    2. 2

      确认底部模型名称正确后，点击发送。

    确认输入框底部显示刚选择的模型，输入一条简单消息，再点击输入框右下角的发送按钮。

    自行采集WorkBuddy 5.3.14（macOS 中文界面）
  8. 第 8 步

    确认回复和模型名称

    1. 1

      收到完整回复，表示 WorkBuddy 已经连通 custom。

    收到 WorkBuddy 的完整回复，且回复下方显示的模型名称与刚选择的模型一致，就表示 API 地址、密钥和模型均已配置成功。

    自行采集WorkBuddy 5.3.14（macOS 中文界面）

看不清时：点击图片可放大；配置值请复制页面中的文字，不要照着截图手工输入密钥或地址。

验证配置

使用刚添加的模型发送“介绍一下你自己”；能够正常返回内容，且回复下方显示正确模型名称，即配置成功。

配置示例中如果出现 sk-your-api-key 必须替换为自己的完整密钥；不要把含密钥的配置提交到 Git。

常见错误 ​

  • 返回 404：接口地址应完整填写到 /v1/chat/completions，并确认 /v1 没有重复。
  • 返回 401：重新粘贴完整 API Key，不要带首尾空格。
  • 找不到模型：确认已点击“保存”，关闭模型设置后重新展开模型列表。
  • 工具调用失败：确认模型支持工具调用，并在高级配置中启用“工具调用”。
  • 服务端或容器无法连接：确认它能访问页面复制区显示的 API 域名，并检查防火墙、代理和 DNS 设置。

更多通用错误处理见常见问题。