接入workbuddy
如何接入workbuddy
适用界面：WorkBuddy 桌面版（macOS 或 Windows） · 2026-11-02
读完你能做成的事：在 WorkBuddy 里用 apibee 的模型，按自己的 key 计费。
1 开始之前
| 需要准备 | 说明 |
|---|---|
一个 sk- 密钥 | 没有的话回上一篇「创建令牌」做一遍 |
| apibee 的 API 地址 | https://apibee.cn |
| 要用的模型 ID | 模型广场直接复制 |
登录方式先说明一处差异：在中国大陆，WorkBuddy 可以用手机号登录，收验证码就行；海外可以用 Google 或 GitHub 授权登录。它不需要邮箱密码注册，这一点和上一篇 apibee 的邮箱注册不是一回事，不要以为漏了步骤。
2 装好并登录
2.1 下载安装包
打开 workbuddy.ai，点 Download WorkBuddy，页面上会同时给出 macOS 和 Windows 两个版本，按自己的电脑选。
macOS：选 Universal 版，下载
.dmg文件。Windows：下载
.exe安装程序
2.2 安装（macOS）
双击 .dmg，把 WorkBuddy 图标拖进 Applications 文件夹，然后在启动台里打开。如果系统提示「无法验证开发者」，就去系统设置 → 隐私与安全性，在页面下方点「仍要打开」。
2.3 安装（Windows）
双击 .exe，一路下一步；如果安装过程中要求选择安装位置，保持默认即可。安装完成后，从开始菜单启动。如果弹出 Windows 安全提示，点「仍要运行」。
2.4 登录
打开后点右上角的 Sign In。在中国大陆选手机号登录，或者微信快捷登录，填手机号，收短信验证码，勾选同意条款，然后进入主界面；海外则选 Google 或 GitHub 登录，跳转到授权页后同意授权，再自动跳回应用。
首次登录会依次弹出辅助功能、文件与文件夹、通知三项授权，都要允许；否则后面读不了文件，也收不到任务完成提醒。
3 添加模型
3.1 进模型设置
进 Settings → Model（设置 → 模型）。页面上会列出内置模型和一个 Auto 模式。
3.2 新建自定义模型
点击模型-添加模型
点添加，选 Custom（自定义）；添加、编辑、删除都在这个弹窗里完成，不需要去改配置文件。
表单里主要填三项：
| 字段 | 填什么 |
|---|---|
| URL | https://apibee.cn/v1 |
| API Key | sk- 开头那一整串 |
| 模型名 | 参考模型广场，可直接复制 |
3.3保存并选中
保存后回到对话页，在模型选择里切到刚建的这一条。
回到对话框
4 验证
在对话框里输入「你好」并回车，几秒内应该正常回话，没有红色报错条。
出错时按下面的报错对照处理：
401 / unauthorized → Key 复制少了几位，或带了空格、引号。
404 / not found → 地址不对。先关掉自定义协议，再看 URL 要不要带
/v1。一直转圈 → 模型名写错，或这条通路协议不兼容。
返回一整段 HTML → 地址填成了网页地址，不是 API 地址。
余额 / 额度报错 → 不是接入问题，去 apibee 控制台看余额。
