WorkBuddy 中转站怎么用：第三方 API 配置、模型切换与排错指南

大模型 AI 中转站：api.clawsocket.com 支持 GPT gemini claude grok 等最新模型 api 并且价格只有官方七分之一。

摘要：这篇文章从 WorkBuddy 的实际使用场景出发，讲清中转站的作用、选择标准、models.json 配置、模型分工、验证排错和 Key 安全。你可以先用一个模型跑通最小请求，再逐步扩展为团队可复用的多模型入口。

先说结论：WorkBuddy 中转站解决什么问题

如果你只是偶尔在 WorkBuddy 里聊天，直接使用客户端提供的默认入口就够了。但当你需要统一使用 Claude、GPT、Gemini 等多个模型，或者希望把团队的 API Key、预算和模型策略集中管理时，中转站就有实际价值。

它主要解决四件事：第一，把不同供应商的调用地址收口到一套配置；第二，让 WorkBuddy 只维护一份模型清单；第三，通过分组、限额和日志控制成本；第四，在某个模型暂时不可用时，保留切换到其他模型的路径。中转站不会自动解决所有问题，协议兼容、模型 ID、额度和服务稳定性仍然需要逐项确认。

• 个人测试：先配置一个低成本、响应快的模型。
• 日常工作：准备一个主模型和一个备用模型。
• 团队协作：按成员或工具拆分 Key，设置额度和撤销流程。
• 敏感任务：先确认服务商的数据留存、日志和隐私政策。

WorkBuddy 中转站到底是什么

WorkBuddy 中转站可以理解为 WorkBuddy 和上游模型服务之间的 API 网关。WorkBuddy 发出请求后，中转站按照模型 ID、账号策略或路由规则，把请求转发给对应的 Claude、GPT 或 Gemini 服务，再把结果转换成客户端能够识别的格式。

这里要区分“中转站”和“模型本身”。中转站通常不等于模型提供商，也不代表所有模型都能无条件调用。你在配置文件中看到的 url、apiKey、id 和 vendor，分别对应请求地址、鉴权信息、模型标识和界面显示的供应商信息。只要其中一项不匹配，WorkBuddy 就可能出现模型不显示、请求 401、路径 404 或返回格式错误。

目前最容易落地的是 OpenAI-compatible 接口。它通常使用 /v1/chat/completions 这样的路径，但不要只凭路径猜兼容性。还要确认是否支持流式输出、上下文长度、工具调用、图片输入和模型别名。WorkBuddy 能显示模型，不等于所有高级能力都已经可用。

怎么判断一个中转站是否适合 WorkBuddy

选择 WorkBuddy 中转站时，价格只是其中一个指标。真正影响使用体验的是兼容性、稳定性、透明度和管理能力。建议按照下面的顺序检查：

如果你使用 api.clawsocket.com 作为统一入口，建议先在后台确认当前账号能用的模型列表，再把实际模型 ID 写进 WorkBuddy。教程里的模型名只能作为配置格式示例，不能替代后台的实时列表。

配置前要准备哪些信息

正式改文件前，先准备一份小清单。这样出现问题时，可以快速判断是路径、Key、地址还是模型名出错。

1. 确认 WorkBuddy 的版本，并关闭正在运行的旧进程。
2. 确认配置文件目录。macOS 通常是 ~/.workbuddy/models.json，Windows 通常是 %USERPROFILE%\.workbuddy\models.json，具体以当前版本文档为准。
3. 在中转站后台创建专用 API Key，不要直接复用个人主 Key。
4. 记录完整接口地址、模型 ID、最大输入和输出 Token。
5. 准备一个最小测试问题，例如“请用一句话解释 JSON 是什么”。

第一次配置不要同时放十几个模型。模型越多，越容易把不存在的 ID、旧版本名称或不支持的能力一起写进去。先用一个模型跑通，再增加第二个模型，定位问题会简单很多。

models.json 完整配置示例

下面是一份适合 WorkBuddy 中转站接入的示例。请把示例中的模型名和 Key 替换成中转站后台真实可用的值，不要把真实 Key 提交到公开仓库。

{
  "models": [
    {
      "id": "gpt-5.4",
      "name": "GPT-5.4 - 中转站",
      "vendor": "OpenAI-compatible",
      "url": "https://api.clawsocket.com/v1/chat/completions",
      "apiKey": "你的 API Key",
      "maxInputTokens": 128000,
      "maxOutputTokens": 8192
    }
  ],
  "availableModels": ["gpt-5.4"]
}

这份配置中，id 必须和 availableModels 中的值完全一致，包括大小写、标点和版本后缀。url 是否需要写到完整的聊天接口，要以 WorkBuddy 当前版本和中转站文档为准。如果客户端会自动拼接路径，就不要重复写两次 /v1/chat/completions。

配置多个模型时，建议每个模型都使用清晰的 name，例如“Claude Sonnet - 写作”“GPT - 代码”“Gemini - 长文档”。显示名称是给人看的，id 才是给 API 路由用的，两者不要混淆。

Claude、GPT、Gemini 如何分工

WorkBuddy 接入多个模型后，不建议只按“哪个最强”来选择。更实用的方式是按任务分工，并给每个模型设置清晰的使用边界。

• Claude：适合长文档整理、代码解释、需求拆解和需要稳定表达的写作任务。
• GPT：适合通用问答、结构化输出、脚本草拟和多种工具生态之间的兼容场景。
• Gemini：适合长上下文、资料综合、多模态输入以及和 Google 生态相关的工作流。

这不是固定排名，而是配置策略。模型能力、价格和上下文限制会持续变化。对于团队，建议把默认模型设成成本可控的主力模型，把更贵的模型作为人工选择的升级档，而不是让所有请求默认走最高规格。

如果某个模型支持工具调用、图片或超长上下文，最好单独在团队文档里记录限制。这样成员不会因为看到模型出现在列表里，就默认它支持 WorkBuddy 的全部功能。

配置后怎么验证和排错

保存文件后，按固定顺序验证，不要一上来同时改地址和模型名：

1. 完全退出 WorkBuddy，再重新启动。
2. 确认模型列表里出现了你写入的显示名称。
3. 发送一个不涉及敏感信息的短问题，观察是否能正常返回。
4. 再测试长文本、代码块或图片等目标能力。
5. 最后检查中转站后台的请求记录、额度变化和错误码。

如果同一个 Key 在独立 API 客户端中可以返回，但 WorkBuddy 不能返回，问题大概率在本地 JSON 结构、客户端版本或请求格式；如果两个地方都失败，则优先查看中转站状态、额度和模型 ID。

Key 安全与成本控制

WorkBuddy 中转站最容易被忽略的不是配置，而是 Key 管理。不要把真实 Key 写进截图、博客、Git 仓库或前端页面。多人协作时，建议按成员、设备或项目创建不同 Key，并给每个 Key 设置合理额度。

成本控制可以从四个方面做：把普通问答放到低成本模型；给长上下文任务设置长度上限；为自动化任务单独建 Key；每周检查请求量和异常峰值。遇到突然上涨的用量，不要只换模型，先确认是否存在循环任务、重复重试或误把大文件作为上下文发送。

隐私方面，API 中转站会接触你的请求内容。涉及客户资料、代码密钥、内部文档和个人信息时，应该先脱敏，并阅读服务商的日志、留存和删除政策。能在本地完成的内容，不必为了测试而上传完整生产数据。

总结：适合哪些 WorkBuddy 用户

WorkBuddy 中转站适合三类用户：需要在一个客户端里切换多个模型的个人开发者；需要统一配置和预算的团队；以及希望把 WorkBuddy 纳入现有 API 网关体系的工程团队。它的价值不是把所有模型变成“免费”，而是让请求出口、模型列表、Key 管理和成本策略更集中。

最稳的落地顺序是：先选一个确认兼容的中转站，创建专用 Key，写入一个模型，重启 WorkBuddy 做最小请求验证；确认链路稳定后，再添加 Claude、GPT 或 Gemini 等其他模型，最后补齐额度、日志和团队权限。需要继续配置其他工具时，可以参考站内的 WorkBuddy 第三方大模型配置教程、Cursor 第三方 API 教程 和 Claude Code API 接入教程。

如果你准备现在开始，先打开 api.clawsocket.com 确认可用模型和接口格式，再回到 WorkBuddy 配置文件逐项填写。任何模型名、价格和能力限制，都应以当前后台和官方文档为准。