> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mixroute.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenWork

> OpenWork 集成指南：通过 MixRoute 在 OpenWork 中统一使用多模型工作助手

## 一、产品简介

OpenWork 是一款开源 AI 助手，支持多模型接入与本地部署。通过 **MixRoute**，可在 OpenWork 中统一使用各类主流与最新模型（如 GPT、Claude、GLM 等），并支持自定义提供商与模型配置。

**下载地址**：[https://openworklabs.com/](https://openworklabs.com/)

## 二、快速配置（MixRoute）

### 1. 获取 API 密钥

在 [Mixroute Api 控制台](https://api.mixroute.ai/) 创建并复制 API 密钥。

### 2. 在 OpenWork 中配置自定义提供商

OpenWork 支持通过 JSON 配置文件添加自定义供应商，推荐在工作目录下进行配置，避免使用全局配置。

<Steps>
  <Step title="确定配置文件位置">
    在 OpenWork 的工作目录下创建或编辑配置文件：

    `/path-to-your-workspace/.config/opencode/opencode.json`

    <Warning>
      不推荐在全局位置 `~/.config/opencode/opencode.json` 添加自定义供应商。OpenWork 优先使用工作目录的配置，全局配置会被覆盖且不生效。
    </Warning>
  </Step>

  <Step title="添加供应商配置">
    根据接入方式，在配置文件中添加对应的供应商配置：

    <AccordionGroup>
      <Accordion title="OpenAI 兼容格式接入（推荐常规模型）">
        对于支持 Chat Completions 的模型，使用 `@ai-sdk/openai-compatible` 接入：

        ```json theme={null}
        {
          "$schema": "https://opencode.ai/config.json",
          "disabled_providers": [],
          "provider": {
            "mixroute-compatible": {
              "name": "mixroute-compatible",
              "npm": "@ai-sdk/openai-compatible",
              "options": {
                "baseURL": "https://api.mixroute.ai/v1",
                "apiKey": "{env:MIXROUTE_API_KEY}"
              },
              "models": {
                "glm-5.3": {
                  "name": "glm-5.3"
                }
              }
            }
          }
        }
        ```

        <Tip>
          使用 `@ai-sdk/openai-compatible` 可以接入绝大多数支持 Chat Completions 协议的模型，兼容性最广。
        </Tip>
      </Accordion>

      <Accordion title="Responses API 接入（GPT-5.x Codex 等模型）">
        部分模型需要使用 Responses API 协议，通过 `@ai-sdk/openai` 接入：

        ```json theme={null}
        {
          "mixroute-responses": {
            "name": "MixRoute OpenAI Responses",
            "npm": "@ai-sdk/openai",
            "options": {
              "baseURL": "https://api.mixroute.ai/v1",
              "apiKey": "{env:MIXROUTE_API_KEY}"
            },
            "models": {
              "gpt-5.6-luna": {
                "name": "gpt-5.6-luna"
              },
              "gpt-5.6-terra": {
                "name": "gpt-5.6-terra"
              },
              "gpt-5.6-sol": {
                "name": "gpt-5.6-sol"
              }
            }
          }
        }
        ```

        <Info>
          关于哪些模型需要走 Responses API，详见下方[第三章](#三部分模型需使用-responses-api重要)。
        </Info>
      </Accordion>

      <Accordion title="Anthropic Messages API 接入（Claude 模型）">
        Claude 系列模型通过 `@ai-sdk/anthropic` 接入：

        ```json theme={null}
        {
          "mixroute-messages": {
            "name": "MixRoute Anthropic messages",
            "npm": "@ai-sdk/anthropic",
            "options": {
              "baseURL": "https://api.mixroute.ai/v1",
              "apiKey": "{env:MIXROUTE_API_KEY}"
            },
            "models": {
              "claude-sonnet-5": {
                "name": "claude-sonnet-5"
              }
            }
          }
        }
        ```
      </Accordion>
    </AccordionGroup>
  </Step>

  <Step title="保存并使用">
    保存配置文件后，重新启动 OpenWork。在模型选择中即可看到已配置的供应商及其模型。
  </Step>
</Steps>

**完整配置示例**（合并所有供应商）：

```json theme={null}
{
  "$schema": "https://opencode.ai/config.json",
  "disabled_providers": [],
  "provider": {
    "mixroute-responses": {
      "name": "MixRoute OpenAI Responses",
      "npm": "@ai-sdk/openai",
      "options": {
        "baseURL": "https://api.mixroute.ai/v1",
        "apiKey": "{env:MIXROUTE_API_KEY}"
      },
      "models": {
        "gpt-5.6-luna": {
          "name": "gpt-5.6-luna"
        },
        "gpt-5.6-terra": {
          "name": "gpt-5.6-terra"
        },
        "gpt-5.6-sol": {
          "name": "gpt-5.6-sol"
        }
      }
    },
    "mixroute-messages": {
      "name": "MixRoute Anthropic messages",
      "npm": "@ai-sdk/anthropic",
      "options": {
        "baseURL": "https://api.mixroute.ai/v1",
        "apiKey": "{env:MIXROUTE_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": {
          "name": "claude-sonnet-5"
        }
      }
    },
    "mixroute-compatible": {
      "name": "mixroute-compatible",
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://api.mixroute.ai/v1",
        "apiKey": "{env:MIXROUTE_API_KEY}"
      },
      "models": {
        "glm-5.3": {
          "name": "glm-5.3"
        }
      }
    }
  }
}
```

### 3. 切换模型

配置完成后，在对话界面或设置中即可选择已配置的供应商与模型（如 `mixroute-responses/gpt-5.6-luna`）进行对话。

<Tip>
  * API 密钥建议通过环境变量 `MIXROUTE_API_KEY` 注入，避免明文写在配置文件中。
  * 若使用自建或备用服务，将 **基础 URL** 改为对应地址，例如 `http://your-server:3003/v1`。
</Tip>

<img src="https://mintcdn.com/personal-a5418d9f/02ZDARHDo1vye0sI/images/openwork-en-1.png?fit=max&auto=format&n=02ZDARHDo1vye0sI&q=85&s=217fe7879e2430653a89623a58e93b1d" alt="Openwork En 1" width="2628" height="1766" data-path="images/openwork-en-1.png" />

### 4. 启动 OpenWork 并创建对话

配置完成后，启动 OpenWork 即可在模型选择列表中看到已添加的模型，开始对话。

<img src="https://mintcdn.com/personal-a5418d9f/02ZDARHDo1vye0sI/images/openwork-en-2.png?fit=max&auto=format&n=02ZDARHDo1vye0sI&q=85&s=17c8cecdbc7f53bfbb23ed9309e8fc0a" alt="Openwork En 2" width="2628" height="1766" data-path="images/openwork-en-2.png" />

## 三、部分模型需使用 Responses API（重要）

部分模型的访问接口与常规 Chat Completions 不同，需使用 **Responses API**。若在 OpenWork 中选用这类模型时出现类似错误：

> The chatCompletion operation does not work with the specified model. Please choose a different model and try again.

说明当前请求走了 **Chat Completions**，而该模型在服务端只开放 **Responses API**，需通过配置改为使用正确接口。

### 3.1 需要走 Responses API 的模型（典型）

| 模型 ID / 系列        | 说明                              |
| ----------------- | ------------------------------- |
| **gpt-5.6-luna**  | GPT-5.6 Luna，仅支持 Responses API  |
| **gpt-5.6-terra** | GPT-5.6 Terra，仅支持 Responses API |
| **gpt-5.6-sol**   | GPT-5.6 Sol，仅支持 Responses API   |

### 3.2 在 OpenWork 中如何配置

通过**在配置文件中添加独立的供应商并使用 `@ai-sdk/openai`**，即可让 OpenWork 对该模型使用 **Responses API**。

具体配置方式见上方[第二步的 Responses API 接入说明](#responses-api-接入gpt-5x-codex-等模型)，在 `opencode.json` 中添加 `mixroute-responses` 供应商即可。

### 3.3 小结

| 场景                                                               | 做法                                                        |
| ---------------------------------------------------------------- | --------------------------------------------------------- |
| 使用 **gpt-5.6-luna / gpt-5.6-terra / gpt-5.6-sol** 等 Responses 模型 | 在 `opencode.json` 中添加独立供应商，通过 Responses 方式访问              |
| 使用 **glm-5.3、claude-sonnet-5** 等常规模型                             | 使用 `@ai-sdk/openai-compatible` 或 `@ai-sdk/anthropic` 接入即可 |

## 四、参考链接

* OpenWork 官网与下载：[https://openworklabs.com/](https://openworklabs.com/)
* OpenCode 配置与模型说明：[Models](https://opencode.ai/docs/models)、[Providers](https://opencode.ai/docs/providers)
* MixRoute 控制台：[https://api.mixroute.ai/](https://api.mixroute.ai/)