文档 · 指南

让 OpenBot 用任意模型

OpenBot 是一个 Electron 工作区，可以运行 Codex、Claude、OpenCode 等 Agent。它的模型选择器会列出你自己添加的 OpenAI 兼容端点。magpie 在这里加一个名为 magpie 的端点，选择器里就会出现 DeepSeek、GLM、Kimi、Qwen、GPT 或 ChatGPT 订阅等 magpie 里的模型。

接入 OpenBot

  1. 在 magpie 里添加供应商在 供应商 页添加 API Key，或登录一个订阅。
  2. 在 Agent 页把 OpenBot 的供应商设为 magpiemagpie 把它的端点写进 OpenBot 的自定义端点文件。
  3. 重启 OpenBot，在它自己的模型选择器里选模型magpie 的模型显示为 magpie/<id>。
终端
magpie openbot provider magpie

文件在哪

OpenBot 把自定义端点放在 Electron 的 userData 目录里：

终端
macOS:   ~/Library/Application Support/OpenBot/openbot-custom-providers-v1.json
Windows: %APPDATA%\OpenBot\openbot-custom-providers-v1.json
Linux:   ~/.config/OpenBot/openbot-custom-providers-v1.json

写了哪些内容

终端
{
  "version": 1,
  "providers": [
    …your own endpoints, left as they are…,
    {
      "id": "magpie",
      "name": "magpie",
      "baseUrl": "http://127.0.0.1:3425/agent/openbot/v1",
      "models": [
        {"id": "deepseek/deepseek-v4-pro", "name": "DeepSeek V4 Pro", "contextWindow": 1000000},
        …
      ],
      "secret": null
    }
  ]
}

version 必须是 1。OpenBot 读不了的文件会让它没有任何端点，也存不了新端点，所以 magpie 遇到读不了的文件时也不动它。

OpenBot 把每个端点的 Key 和请求头一起放在 secret 里，用 Electron 的 safeStorage（macOS 钥匙串、Windows DPAPI）加密。magpie 不去解开它，所以 magpie 的端点不带 Key（secret 为 null）。OpenBot 把这个端点交给 OpenCode 时也不带 Key，而网关接受来自本机、不带 Key 的请求。

请求是 OpenCode 发的，带的是 OpenCode 的 User-Agent，所以地址里的 /agent/openbot 用来告诉网关这是 OpenBot 的请求，用量会记在 OpenBot 名下。你在 OpenBot 里给 magpie 端点改的名称、harness 或 Key 都会保留。你自己的其他端点保持原样。

哪些模型会出现

OpenBot 的列表校验很严：只要有一个端点或一个模型不合格，整个列表就会清空。所以 magpie 只写入在 magpie 里为 OpenBot 选的模型，而且：

  1. 最多 64 个这是 OpenBot 单个端点的上限，超过会全部隐藏。
  2. id 合格只能用字母、数字和 ._:/[],=-，加上 magpie/ 前缀后不超过 160 个字符。
  3. 上下文窗口在范围内只在 1,024 到 100,000,000 之间时才写入 contextWindow。

什么时候生效

OpenBot 只在启动时读这个文件。只有在 OpenBot 里保存、编辑或删除端点时，它才会用内存里的内容整份写回。所以改动要重启后才显示。如果重启前你在 OpenBot 里保存了某个端点，它会把 magpie 的端点覆盖掉。OpenBot 在运行时，magpie 会提示你先重启，再在 OpenBot 里添加或编辑端点。

MCP 服务器存在 OpenBot 的 SQLite 数据库里，magpie 不写它。要用 magpie 的 MCP 服务器（/mcp/magpie/…），在 OpenBot 里手动添加为 HTTP 服务器。

切回

切回默认时，magpie 只删掉自己的端点。如果文件里不再剩任何东西，就删掉整个文件，因为 OpenBot 在没有文件时也是从空列表开始的。

终端
magpie openbot default

常见问题

OpenBot 怎么用 DeepSeek、GLM 或 ChatGPT 订阅？

在 magpie 的 Agent 页把 OpenBot 的供应商设为 magpie，重启 OpenBot，然后在它的模型选择器里选 magpie/ 开头的模型。

为什么 magpie 的端点没有 API Key？

OpenBot 用系统钥匙串加密每个端点的 Key，magpie 不去解开它。网关接受来自本机、不带 Key 的请求，地址里的 /agent/openbot 让网关认出这是 OpenBot。

为什么我看不到所有 magpie 模型？

magpie 只写入在 magpie 里为 OpenBot 选的模型，最多 64 个，并跳过 OpenBot 不接受的 id。一个不合格的模型会让 OpenBot 清空整个列表。

改完为什么没生效？

OpenBot 只在启动时读自定义端点。重启 OpenBot 即可。重启前不要在 OpenBot 里保存端点，否则它会覆盖 magpie 的端点。

更多桌面应用用同样的模型：让 Lody 用任意模型、让 Cindy 用任意模型、让 miniQ 用任意模型、让团结 Cowork 用任意模型。遇到报错？见 常见错误排查，或到 Discord 提问。