WorkBuddy（腾讯） 接入教程
腾讯的 AI 办公智能体，添加一个自定义模型就能用樱桃茶的模型干活
- 接口：OpenAI Chat Completions
- 地址写法：写全到 /v1/chat/completions（https://gpt.cherrychat.org/v1/chat/completions）
- 推荐模型：claude-sonnet-5-5、gpt-6.1-sol
- 平台：macOS、Windows
接入步骤
打开模型设置
打开 WorkBuddy，进入「设置」→「模型」（通常从右上角的账号菜单进入设置），找到「自定义模型」区域。
添加模型，选「自定义」
点「添加模型」，在提供商列表里选「自定义 / Custom」（不要选列表里的其他服务商）。
填接口地址、API Key 和模型名
接口地址写全到 /v1/chat/completions，WorkBuddy 只支持这种 OpenAI 兼容格式；Claude 模型也照样填这个地址。
- 接口地址（URL）：https://gpt.cherrychat.org/v1/chat/completions（写全路径，不要只填域名或 /v1）
- API Key：sk-你的密钥
- 模型名称（模型 ID）：claude-sonnet-5-5
高级配置
「自定义协议」开关保持关闭。上下文长度可选 128K；能力标记不会自动识别，Claude、GPT 系列都支持工具调用，可以勾上「工具调用」，不确定的模型宁可少勾。
保存并测试
保存后回到对话界面，在模型选择器的「自定义模型」分组里选中它，发一句「你好」，有回复就接通了。
容易踩的坑
- 接口地址写全 https://gpt.cherrychat.org/v1/chat/completions：「自定义协议」关闭时 WorkBuddy 会按标准 /chat/completions 校验并补全地址，写全路径最稳。
- 只支持 OpenAI 兼容（Chat）格式，不能填 Claude 原生接口；樱桃茶的 Claude 模型也支持 Chat 格式，照常填 https://gpt.cherrychat.org/v1/chat/completions。
- 能力标记要手动勾：没勾「工具调用」时智能体功能受限，勾了但模型不支持会报错。
- 配置（含 key）只保存在本机，不会上传；用自定义模型的费用从樱桃茶积分里扣，不占 WorkBuddy 自己的积分。
- 设置入口和按钮位置可能随 WorkBuddy 版本变化，以软件里的实际界面为准。
报错 → 原因 → 怎么办
| 看到的报错 | 原因 | 怎么办 |
|---|---|---|
| 保存或对话时报 401 | API Key 复制错了、带了空格，或这把 key 已停用 | 到 API 页「我的密钥」重新复制后粘贴 |
| 报 404 或「请求失败」 | 接口地址只写了域名或 /v1，或打开了「自定义协议」却没写全路径 | 接口地址改成 https://gpt.cherrychat.org/v1/chat/completions，「自定义协议」保持关闭 |
| 提示模型不存在 | 模型名称写错（大小写、多空格） | 按模型价格页逐字填写，例如 claude-sonnet-5-5 |
| 报 402 或「余额不足」（Claude 格式显示 billing_error） | 账户积分不够付这次调用。API 调用只扣积分，会员卡和无限卡都不抵扣 | 到樱桃茶·智域GPT 的「商店」充值任意金额，几秒后重试即可 |
| 报 429 Too Many Requests | 请求太快：默认每把 key 每分钟最多 120 次，每个账号同时最多 8 个请求 | 调低工具里的并发数或每秒请求数，按提示的 Retry-After 秒数等一等再试；多数工具会自动重试 |
教程核对于 2026-11-02。工具界面改版后可能和这里略有不同，以官方文档为准。
Operated by UK Company CHERRYCHAT LTD · Company Number 16096119 · 客服微信 JsnonoChat · 内容由 AI 生成，请仔细甄别
