# WorkBuddy Setup Guide

> Add a custom model in Tencent's WorkBuddy and point its OpenAI-compatible endpoint at LLMoxy, so gateway models handle your office and coding tasks.

Website: [https://www.workbuddy.cn (click to download)](https://www.workbuddy.cn)

WorkBuddy is Tencent Cloud's desktop agent: give it a task in one sentence, and it breaks the task down, reads and writes local files, and delivers documents / spreadsheets / slides. Once connected to LLMoxy, it uses gateway models and no longer consumes WorkBuddy's built-in credits.

Before you start, get an [LLMoxy token](https://en.llmoxy.com/docs/get-started/get-token). The **auto** group is recommended.

## Install and sign in

1. Download the installer for your system from the official website (Windows 10+ or macOS 12+; choose ARM64 for Apple Silicon).
2. Launch it after installing and sign in by scanning the WeChat QR code (phone number, QQ, and Tencent Cloud accounts are also supported).
3. Grant access to a working directory when prompted. Only authorize the folders you need, such as Desktop, Documents, and Downloads. Don't authorize the whole disk.

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

![Sign in to WorkBuddy](https://en.llmoxy.com/docs-assets/migrated/tutorial-workbuddy/login.png)

![Authorize folders](https://en.llmoxy.com/docs-assets/migrated/tutorial-workbuddy/folder-auth.png)

## Connect to LLMoxy

1. Click the avatar at the bottom left and open **Settings**.
2. Choose **Models** on the left and click **+ Add Model** in the top right.
3. In the provider dropdown, scroll to "Other" and choose **Custom**.
4. Fill in the fields below, save, and **check to enable** the model in the model list.

| Field | Value |
| --- | --- |
| Provider | Custom |
| API URL | `https://llmoxy.com/v1` |
| API Key | The token copied from the LLMoxy console |
| Model name | The exact ID from the Model Marketplace, for example `grok-4.7`, `claude-opus-5-5` |

![Open settings](https://en.llmoxy.com/docs-assets/migrated/tutorial-workbuddy/model-settings.png)

![Add a custom model](https://en.llmoxy.com/docs-assets/migrated/tutorial-workbuddy/custom-model.png)

> **💡 Tip**
> Enter the API URL only up to `/v1`; WorkBuddy appends `/chat/completions` automatically. If requests fail, turn on **Custom protocol** in the advanced settings and change the URL to `https://llmoxy.com/v1/chat/completions`.

## Get to work

The main screen has three areas: the task list on the left, the conversation in the middle, and the outputs on the right.

1. Click **New task** and choose a workspace.
2. Describe your request clearly in one go: **goal + input files + output format + constraints**.
3. Choose a mode that fits the task, then send.

| Mode | What it does | When to use |
| --- | --- | --- |
| Ask | Reads only, changes nothing | Research, analyzing documents |
| Plan | Proposes a plan first, then changes files after you confirm | Complex or high-risk tasks |
| Craft | Executes directly and produces files | The goal is already clear |

![Main screen](https://en.llmoxy.com/docs-assets/migrated/tutorial-workbuddy/layout.png)

Example request:

```
Read "Sales Data.xlsx" on the desktop, summarize sales by region for each month, generate a bar chart, and output a new Excel file.
```

If you're not satisfied, follow up in the same conversation; there's no need to start a new task.

## FAQ

**Credits are still deducted after I filled in the custom model**
After saving, you must check to enable it in the model list and select the model you just added in the task.

**The API returns 404**
Make sure the URL is `https://llmoxy.com/v1`. Don't leave out `/v1`, and don't enter only the domain. The `/v1/chat/completions` in the example is only entered as a full path when "Custom protocol" is on.

**Wrong model name**
Copy the full ID from the model list in the [LLMoxy console](https://llmoxy.com/). The case must match exactly.

**Can it see all the files on my computer?**
No. It can only access the folders you authorize, and sensitive system directories are blocked.

This is the markdown version of https://en.llmoxy.com/docs/code-tutorials/workbuddy.
