OpenWork

一、产品简介

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

二、快速配置（MixRoute）

1. 获取 API 密钥

在 Mixroute Api 控制台创建并复制 API 密钥。

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

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

确定配置文件位置

在 OpenWork 的工作目录下创建或编辑配置文件：/path-to-your-workspace/.config/opencode/opencode.json

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

添加供应商配置

根据接入方式，在配置文件中添加对应的供应商配置：

OpenAI 兼容格式接入（推荐常规模型）

对于支持 Chat Completions 的模型，使用 @ai-sdk/openai-compatible 接入：

{
  "$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"
        }
      }
    }
  }
}

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

Responses API 接入（GPT-5.x Codex 等模型）

部分模型需要使用 Responses API 协议，通过 @ai-sdk/openai 接入：

{
  "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"
      }
    }
  }
}

关于哪些模型需要走 Responses API，详见下方第三章。

Anthropic Messages API 接入（Claude 模型）

Claude 系列模型通过 @ai-sdk/anthropic 接入：

{
  "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"
      }
    }
  }
}

保存并使用

保存配置文件后，重新启动 OpenWork。在模型选择中即可看到已配置的供应商及其模型。

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

{
  "$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）进行对话。

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

4. 启动 OpenWork 并创建对话

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

三、部分模型需使用 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 接入说明，在 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/
OpenCode 配置与模型说明：Models、Providers
MixRoute 控制台：https://api.mixroute.ai/

对话型 AI

编程开发

技术工程

翻译场景

一、产品简介

二、快速配置（MixRoute）

1. 获取 API 密钥

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

3. 切换模型

4. 启动 OpenWork 并创建对话

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

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

3.2 在 OpenWork 中如何配置

3.3 小结

四、参考链接

​一、产品简介

​二、快速配置（MixRoute）

​1. 获取 API 密钥

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

​3. 切换模型

​4. 启动 OpenWork 并创建对话

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

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

​3.2 在 OpenWork 中如何配置

​3.3 小结

​四、参考链接

一、产品简介

二、快速配置（MixRoute）

1. 获取 API 密钥

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

3. 切换模型

4. 启动 OpenWork 并创建对话

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

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

3.2 在 OpenWork 中如何配置

3.3 小结

四、参考链接