# WorkBuddy 配置指南

> 在腾讯 WorkBuddy 中添加自定义模型，把 OpenAI 兼容接口指向 LLMoxy，用网关模型完成办公与编码任务。

网址：[https://www.workbuddy.cn（单击跳转下载）](https://www.workbuddy.cn)

WorkBuddy 是腾讯云的桌面 Agent：一句话下任务，它会拆解、读写本地文件并交出文档 / 表格 / PPT。接入 LLMoxy 后走网关模型，不再消耗 WorkBuddy 自带积分。

开始前准备一把 [LLMoxy 令牌](https://llmoxy.com/docs/get-started/get-token)，建议用 **auto** 分组。

## 安装与登录

1. 从官网下载对应系统的安装包（Windows 10+ 或 macOS 12+，Apple Silicon 选 ARM64）。
2. 安装后启动，用微信扫码登录（也支持手机号、QQ、腾讯云账号）。
3. 按提示授权工作目录。只授权桌面、文档、下载等必要文件夹，不要全盘授权。

![下载 WorkBuddy](https://llmoxy.com/docs-assets/migrated/tutorial-workbuddy/download.png)

![登录 WorkBuddy](https://llmoxy.com/docs-assets/migrated/tutorial-workbuddy/login.png)

![授权文件夹](https://llmoxy.com/docs-assets/migrated/tutorial-workbuddy/folder-auth.png)

## 接入 LLMoxy

1. 点击左下角头像，打开 **设置**。
2. 左侧选 **模型**，右上角点 **+ 添加模型**。
3. 提供商下拉到「其他」，选 **自定义 / Custom**。
4. 按下面填写后保存，并在模型列表中 **勾选启用**。

| 字段 | 填写 |
| --- | --- |
| 提供商 | 自定义 / Custom |
| 接口地址 | `https://llmoxy.com/v1` |
| API Key | LLMoxy 控制台复制的令牌 |
| 模型名称 | 模型广场里的准确 ID，例如 `grok-4.7`、`claude-opus-5-5` |

![打开设置](https://llmoxy.com/docs-assets/migrated/tutorial-workbuddy/model-settings.png)

![添加自定义模型](https://llmoxy.com/docs-assets/migrated/tutorial-workbuddy/custom-model.png)

> **💡 提示**
> 接口地址只填到 `/v1`，WorkBuddy 会自动补 `/chat/completions`。若请求失败，打开高级配置里的 **自定义协议**，把地址改成 `https://llmoxy.com/v1/chat/completions`。

## 开始干活

主界面三块：左侧任务列表、中间对话、右侧产物。

1. 点 **新建任务**，选工作空间。
2. 需求一次写清：**目标 + 输入文件 + 输出格式 + 约束**。
3. 按任务选模式后发送。

| 模式 | 做什么 | 什么时候用 |
| --- | --- | --- |
| Ask 问一问 | 只看不改 | 查资料、分析文档 |
| Plan 想一想 | 先出方案，确认后再改文件 | 复杂或高风险任务 |
| Craft 做一做 | 直接执行并产出文件 | 目标已经明确 |

![主界面](https://llmoxy.com/docs-assets/migrated/tutorial-workbuddy/layout.png)

需求示例：

```
读取桌面「销售数据.xlsx」，按月份汇总各区域销售额，生成柱状图，输出新的 Excel。
```

不满意就在同一对话里追问，不必重开任务。

## 常见问题

**填完自定义模型还在扣积分**
保存后必须在模型列表里勾选启用，并在任务里选中刚加的模型。

**接口报 404**
确认地址是 `https://llmoxy.com/v1`，不要漏 `/v1`，也不要只填域名。占位示例里的 `/v1/chat/completions` 仅在开启「自定义协议」时才整段填写。

**模型名不对**
到 [LLMoxy 控制台](https://llmoxy.com/) 模型列表复制完整 ID，大小写必须一致。

**它能看到我电脑上的所有文件吗？**
不能。只能访问你授权的文件夹，系统敏感目录会被拦截。

本文是 https://llmoxy.com/docs/code-tutorials/workbuddy 的 markdown 版本。
