# WorkBuddy 接入 LYRouter：安装、配置与故障排查

来源: https://platform.lyrouter.com/ai_gateway/docs/workbuddy
更新日期: 2026-10-13

WorkBuddy 可以通过自定义模型服务接入 LYRouter。本文从安装前提开始，说明如何配置并完成第一次调用。

已安装应用？直接查看[配置 LYRouter](#配置-lyrouter)。

## 前提条件

本页针对 WorkBuddy 桌面应用。准备应用登录账号、联网环境和本地安装权限；按所用操作系统选择对应说明。

**选择操作系统**

Windows:
#### 1. 确认系统与架构

官方要求 Windows 10 1809+ / Windows 11、64 位系统（x64 / ARM64）、至少 4 GB 内存及 500 MB 可用磁盘空间。在 PowerShell 中检查系统：

```powershell
Get-CimInstance Win32_OperatingSystem | Select-Object Caption, Version, OSArchitecture
```

#### 2. 准备安装与登录

选择[官方下载](https://www.workbuddy.ai/)提供的 Windows 安装包，准备安装目录写权限和登录账号。具体要求参见[Windows 安装指南](https://www.workbuddy.ai/docs/workbuddy/From-Beginner-to-Expert-Guide/Installation-Win-Guide)。

Linux:
#### 1. 确认桌面版安装支持

当前[官网桌面下载入口](https://www.workbuddy.ai/)列出 Windows 与 macOS 安装包，本页不提供 Linux 桌面版安装步骤。

#### 2. 选择可用的环境

使用 Windows 或 macOS 环境继续本页指南。需要在 Linux 本地接入 LYRouter 时，可查看 [Claude Code](https://platform.lyrouter.com/ai_gateway/docs/claude-code)、[Codex CLI](https://platform.lyrouter.com/ai_gateway/docs/codex)或 [OpenCode](https://platform.lyrouter.com/ai_gateway/docs/opencode)；这些工具的 Linux 前提条件在各自页签中说明。

macOS:
#### 1. 确认系统与处理器

在终端中检查 macOS 版本与处理器，按[官方安装说明](https://www.workbuddy.ai/docs/workbuddy/From-Beginner-to-Expert-Guide/Installation-Mac-Guide)确认系统版本要求：

```bash
sw_vers -productVersion
uname -m
```

#### 2. 准备安装与登录

从[官网](https://www.workbuddy.ai/)选择 Mac ARM64（Apple Silicon）或 Mac x64（Intel）安装包，确认应用目录可写，并准备应用登录账号和可访问的网络。

接入 LYRouter 还需要一把已启用的 API Key 和当前工作空间可用的模型。示例中的 `MODEL_ID` 必须替换为实际系统模型标识；工具账号与 LYRouter 账号是两个独立身份。

## 安装应用

1. 打开[WorkBuddy 官网](https://www.workbuddy.ai/)，选择 macOS 或 Windows 安装包。
2. macOS 打开 DMG 并拖入 Applications；Windows 运行安装器并完成向导。
3. 启动应用完成登录，在应用信息中记录版本。
4. 仅按实际任务需要授权本地文件与其他系统权限。

## 配置 LYRouter

在 Settings → Model 添加 Custom 模型：URL 使用 `https://api.lyrouter.com/v1`，API Key 使用 LYRouter API Key，模型名使用系统模型标识。

默认的标准协议模式会补全 Chat Completions 路径。若显式开启 Custom Protocol，应用直接请求填写的 URL，此时使用完整 `https://api.lyrouter.com/v1/chat/completions`，不能把 Base URL 当成完整端点。保存后在会话中选中自定义模型。

## 验证首次调用

启动应用，显式选择刚配置的模型，发送“请回复 OK”这样的最小任务。再到 LYRouter 的[请求日志](https://platform.lyrouter.com/ai_gateway/docs/logs)检查生成端点、状态和实际模型。连接测试成功不等于完整生成或工具调用已通过。

## 日常使用与故障排查

### 安装后无法启动应用，应该如何检查？

**答：** 按本页“前提条件”核对操作系统、处理器架构和安装权限，再按对应系统的安装指南检查安装结果。使用官方提供的安装包，具体系统要求以本页链接的官方资料为准。

### Base URL 和 Custom Protocol 的 URL 有什么区别？

**答：** 默认标准协议模式使用 `https://api.lyrouter.com/v1`，应用会补全 Chat Completions 路径。开启 Custom Protocol 后应填写完整端点 `https://api.lyrouter.com/v1/chat/completions`；不要把根地址或 Base URL 当作完整请求端点。

### 切换模型前需要检查什么？

**答：** 确认新模型已在当前工作空间启用、至少有一个有效服务来源，并支持应用所需的协议和工具能力。使用系统模型标识，不使用展示名称。

### 应用更新后，原来的配置为什么不生效？

**答：** 先核对当前应用版本和实际读取的配置位置，再对照本页“配置 LYRouter”检查提供商、地址、密钥和模型。不同版本的配置要求以本页链接的官方资料为准。

### 请求返回 401 / 403，应该先检查什么？

**答：** 确认填写的是已启用的 LYRouter API Key，并检查该 Key 所属工作空间的模型来源与访问策略。结合具体错误和日志判断拒绝来源，详见[鉴权与权限 FAQ](https://platform.lyrouter.com/ai_gateway/docs/auth-errors)。

### 请求返回 429，反复重试有用吗？

**答：** 先确认是平台限制还是上游额度耗尽，再调整并发、调用频率或资源配置。使用有上限的退避重试，避免立即密集重试，详见[限流与配额 FAQ](https://platform.lyrouter.com/ai_gateway/docs/rate-errors)。

### 应用有回复，但 LYRouter 日志里找不到请求，怎么办？

**答：** 确认会话选中了刚配置的自定义模型，而不是内置或 Auto 模式，再发送最小生成请求。在正确工作空间按时间和 Key 查询[请求日志](https://platform.lyrouter.com/ai_gateway/docs/logs)；刚结束的请求可能需要稍后刷新。

## 官方资料

下列要求和安装方式来自工具官方资料，后续版本以官方说明为准。

- [Windows 安装指南](https://www.workbuddy.ai/docs/workbuddy/From-Beginner-to-Expert-Guide/Installation-Win-Guide)
- [macOS 安装指南](https://www.workbuddy.ai/docs/workbuddy/From-Beginner-to-Expert-Guide/Installation-Mac-Guide)
- [自定义模型和协议](https://www.workbuddy.ai/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model)