WorkBuddy
本文说明如何在 WorkBuddy 桌面版 中接入老实人AI模型。配置完成后,WorkBuddy 会通过老实人AI的 OpenAI Chat Completions 接口调用模型。
完整接口地址:
https://api.laoshirenai.com/v1/chat/completions
已按 WorkBuddy
5.5.3与内置 CodeBuddy CLI2.137.1验证。Grok 标准线路的grok-4.6、grok-4.5均完成了真实文件读取、Shell、写入和复读闭环。
准备工作
开始前确认:
- 已从WorkBuddy 官方页面下载并安装 WorkBuddy;
- 已在老实人AI API 密钥页面创建支持 Chat Completions 的有效 Key;
- 当前 Key 有可用额度。
WorkBuddy 桌面版支持 macOS 和 Windows。Linux 目前仅提供部分国产系统应用商店版本,本教程不对其配置路径作保证。
推荐:密钥页面一键配置
使用 Grok 标准线路 Key 时,在密钥页面点击 一键配置 → WorkBuddy,选择 macOS 或 Windows 后执行复制的命令。命令会把当前 Key 可见的全部模型安全合并到 models.json,保留其他模型并创建备份。
命令只负责配置已经安装的 WorkBuddy,不会静默安装桌面应用。执行完成后必须完全退出并重新打开 WorkBuddy。Linux 和未完成全模型验证的分组不会显示 WorkBuddy 选项。
第一步:查询可用模型
macOS:
export LSRAI_API_KEY="YOUR_API_KEY"
curl -sS 'https://api.laoshirenai.com/v1/models' -H "Authorization: Bearer $LSRAI_API_KEY"
Windows PowerShell:
$env:LSRAI_API_KEY = "YOUR_API_KEY"
(Invoke-RestMethod -Uri 'https://api.laoshirenai.com/v1/models' -Headers @{ Authorization = "Bearer $env:LSRAI_API_KEY" }).data.id
从返回结果中复制一个准确的模型 ID,下面用 YOUR_MODEL_ID 表示。
第二步:添加自定义模型
- 打开 WorkBuddy 的 设置;
- 进入 模型;
- 点击 添加模型;
- 接入方式选择 自定义 / Custom;
- 按下表填写。
| 配置项 | 填写内容 |
|---|---|
| 模型名称 | YOUR_MODEL_ID |
| 模型 ID | YOUR_MODEL_ID |
| URL | https://api.laoshirenai.com/v1/chat/completions |
| API Key | 老实人AI API Key |
第三步:设置高级选项
打开高级配置,并按下面设置:
| 配置项 | 建议值 |
|---|---|
| 自定义协议 | 关闭,使用标准 OpenAI 兼容 Chat Completions |
| 工具调用 | 开启 |
| 图片输入 | 关闭 |
| 推理模式 | 开启,默认 medium |
| 最大输入 Token | 500000 |
| 最大输出 Token | 128000 |
使用完整 URL https://api.laoshirenai.com/v1/chat/completions。不要只填写 /v1,也不要添加 WebSocket 配置。
本教程只使用 Chat Completions,不支持 Responses、Anthropic Messages 或 Gemini GenerateContent,也不需要添加任何 WebSocket 配置。
先用最保守的图片和推理设置确认基础连接。只有模型目录明确说明支持对应能力时,再回来开启图片输入或推理模式。
第四步:保存并选择模型
- 保存自定义模型;
- 回到对话页面的模型选择器;
- 在自定义模型分组中选择
YOUR_MODEL_ID; - 新建一个会话。
输入:
请只回复:lsrai WorkBuddy 连接成功
同时满足以下两项才算配置成功:
- WorkBuddy 正常返回结果;
- 老实人AI的使用记录中出现这次请求。
配置保存位置
WorkBuddy 桌面版会把自定义模型保存到:
| 系统 | 文件位置 |
|---|---|
| macOS | ~/.workbuddy/models.json |
| Windows | %USERPROFILE%\.workbuddy\models.json |
请通过 WorkBuddy 的模型设置界面修改它。不要把桌面版文件误写成 ~/.codebuddy/models.json;后者属于内置 CodeBuddy Code CLI,不是 WorkBuddy 桌面版的主要配置文件。
切换模型
- 重新查询当前 Key 的
/v1/models; - 在 设置 → 模型 中添加或编辑模型;
- 同时更新模型名称和模型 ID;
- 保存后重新选择模型并新建会话。
常见问题
| 现象 | 可能原因 | 处理方法 |
|---|---|---|
返回 401 |
API Key 错误、停用或没有保存 | 重新复制当前有效 Key 并保存 |
返回 404 |
URL 不完整或自定义协议状态不匹配 | 开启自定义协议并使用完整 /v1/chat/completions 地址 |
| 模型不出现在选择器 | 配置写进了 .codebuddy 或没有保存 |
通过 WorkBuddy 设置界面重新添加 |
| 提示模型不存在 | 模型 ID 不属于当前 Key | 重新查询 /v1/models |
| 普通问答成功但工具失败 | 工具调用能力没有开启 | 在高级配置中开启工具调用 |
| 图片请求失败 | 当前模型或分组不支持图片 | 关闭图片输入并新建会话 |
安全提示
- WorkBuddy 会把 API Key 保存在本机模型配置中,不要分享该文件;
- 不要把
.workbuddy/models.json提交到 Git; - Key 泄露后立即在老实人AI停用并重新创建。
配置步骤依据:WorkBuddy 官方下载页面、WorkBuddy 官方模型配置文档。