WorkBuddy 配置指南

WorkBuddy 是腾讯推出的本地 AI 智能体（Agent）工作台，支持接入自定义大模型 API，用于办公问答、文档处理、代码编写等场景。WorkBuddy 采用 OpenAI 兼容协议（/v1/chat/completions），只需填入 Base URL、API Key 和模型名称，即可接入魔芋AI（MoyuAI）平台，使用平台上的 GPT、Claude、Gemini、豆包等各类模型。

以往接入自定义模型需要手动编辑配置文件、核对协议格式，容易出错。本文以「魔芋AI」平台为例，讲解如何在 WorkBuddy 中配置并一键切换自定义大模型，以及如何路由到其他模型。

1. 安装 WorkBuddy

前往官方页面下载对应系统的安装包：

下载地址：https://www.codebuddy.cn/work/

支持平台：Windows、macOS

前置条件：需要拥有魔芋AI的 API Key（形如 sk-XXXXXX，在平台「令牌管理」页面创建），以及服务地址 https://www.moyu.cn。

安装后打开 WorkBuddy，界面左下角为设置入口，可在其中管理模型供应商配置。

2. 配置自定义模型

2.1 打开自定义模型配置

打开 WorkBuddy，点击左下角设置图标，进入 模型（Model） 标签页；或点击对话框底部当前模型名称 → 滚动到底部 → 「+ 配置自定义模型」。

在供应商下拉列表中滚动到最底部，选择 「自定义（Custom）」。

注意：不要选择 DeepSeek、GLM 等预置厂商，否则会跳转到对应云平台页面，而不是自定义配置界面。

2.2 填写核心配置

在配置界面填写以下三项：

配置项	填写内容	说明
API URL / Base URL	`https://www.moyu.cn/v1`	魔芋AI 的 OpenAI 兼容地址，WorkBuddy 自动补全 `/chat/completions`
API Key	`sk-XXXXXX`	你的魔芋AI API 密钥，粘贴后检查首尾是否有多余空格
模型名称（Model Name）	如 `DeepSeek-V4.1-flash`、`glm-5.3`	必须与魔芋AI平台支持的模型 ID 完全一致（含大小写与连字符）

在**高级配置（Advanced Configuration）**中可按需开启工具调用、图片输入、推理模式等能力（详见第 4 节）。

完成配置后点击保存。

2.3 验证

保存后，在对话窗口手动切换到刚配置的模型，发送一条测试消息（如"你好"），能正常对话即配置成功。

注意：WorkBuddy 保存后不会自动切换模型，必须手动选择新模型，否则配置看起来"不生效"。

3. 常见问题

Q：保存后模型没变化 / "不生效"？
A：WorkBuddy 保存后不会自动切换，需在对话框底部手动选择新配置的模型再发送消息。

Q：提示 404 Not Found？
A：确认 URL 以 /v1/chat/completions 结尾，或 Base URL 填写为 https://www.moyu.cn/v1。若仍报 404，尝试在高级配置中开启 「自定义协议（Custom Protocol）」 开关。

Q：提示 401 / 密钥无效？
A：检查 API Key 是否完整、有无多余空格；确认令牌未过期、账户额度充足。

Q：Base URL 到底带不带 /v1？
A：WorkBuddy 走 OpenAI 兼容协议，Base URL 填 https://www.moyu.cn/v1，客户端会自动补全 /chat/completions。

Q：提示 connect ETIMEDOUT？
A：说明网络无法连接到端点，检查网络环境或代理设置，确认 https://www.moyu.cn 可正常访问。

Q：手动编辑配置文件后模型列表被清空？
A：WorkBuddy 的 models.json（位于 ~/.workbuddy/）必须为 UTF-8 无 BOM 编码且 JSON 语法正确，否则会解析失败并清空模型列表。修改后需完全重启 WorkBuddy。

1. 安装 WorkBuddy#

2. 配置自定义模型#

2.1 打开自定义模型配置#

2.2 填写核心配置#