文档 · 指南

让 OpenMausBot 用任意模型

OpenMausBot 是一个开源的 Electron 聊天应用，它的机器人运行电脑上装好的命令行 Agent。设置在数据文件夹的 config.json 里：设置了 $OMB_DATA_DIR 时在那里，否则在每个系统上都是 ~/.openmausbot。机器人能用的每个引擎都是这个文件 instances 里的一项。magpie 在这里加一个自己的引擎 magpie，机器人就能用 DeepSeek、GLM、Kimi、Qwen、Claude 或 ChatGPT 订阅等 magpie 里的任意模型。

接入 OpenMausBot

在 magpie 里添加供应商在供应商页添加 API Key，或登录一个订阅。
退出 OpenMausBotOpenMausBot 开着时，magpie 会拒绝修改（在 Windows 上 magpie 看不出它是否开着，所以请先退出）。
在 Agent 页把 OpenMausBot 的供应商设为 magpiemagpie 把每个 magpie 模型都放进 magpie 引擎的模型选择器。
打开 OpenMausBot，给机器人选 magpie 引擎然后在引擎的选择器里选模型。

magpie 引擎

为什么要单独一个引擎：OpenMausBot 的 Claude 机器人以隔离方式运行 Claude Code，只带上 ~/.claude/settings.json 里的登录相关键，所以接到 magpie 的 Claude Code 虽然已经走网关，选择器里却只有 Claude 自己的模型。它的 Codex 机器人直接用你的 ~/.codex，magpie 对 Codex 的接入已经覆盖。

magpie 按 OpenMausBot 自己添加 Claude 端点的格式写这个引擎：一个 access 为 custom 的 claudeAgent，有自己的 Claude 主目录，要求 API Key，网关地址和 magpie 的 Key 写在 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY 里，每个 magpie 模型都在 endpointModels 里。有这些键的引擎自己决定路由，你的设置和 OpenMausBot 里的供应商切换都影响不到它。如果你给过 OpenMausBot 一个 Claude Code，magpie 引擎也用它。

终端

// ~/.openmausbot/config.json
"instances": {
  "magpie": {
    "driver": "claudeAgent",
    "displayName": "magpie",
    "access": "custom",
    "config": {
      "configDir": "~/.openmausbot/providers/magpie",
      "requireApiKey": true,
      "endpointModels": […]
    },
    "environment": {
      "ANTHROPIC_BASE_URL": "http://127.0.0.1:3425",
      "ANTHROPIC_AUTH_TOKEN": "",
      "ANTHROPIC_API_KEY": "",
      "ANTHROPIC_MODEL": "…"
    }
  },
  …
}

1M 上下文的模型标成 [1m]。OpenMausBot 不接受的模型 ID 会被去掉，因为列表里只要有一个这样的 ID，它就会拒绝整个引擎。

OpenMausBot 的机器人能用 DeepSeek 或 GLM 吗？

能。magpie 在 config.json 里加一个 magpie 引擎，给机器人选这个引擎，再选模型即可。

为什么要先退出 OpenMausBot？

它改动引擎时会把自己内存里的整份引擎表写回去，覆盖 magpie 的修改，所以它开着时 magpie 拒绝修改。

我原来的引擎会不见吗？

不会。文件里没有引擎时，magpie 会把 OpenMausBot 的默认引擎和自己的一起写进去。

Codex 机器人怎么用 magpie？

OpenMausBot 的 Codex 机器人直接用你的 ~/.codex，magpie 对 Codex 的接入已经覆盖。

更多 Agent 用同样的模型：让 Mistral Vibe 用任意模型、让 Pencil 用任意模型、让 Claude Desktop 用任意模型、让 JetBrains Copilot 用任意模型。遇到报错？见常见错误排查，或到 Discord 提问。

让 OpenMausBot 用任意模型

接入 OpenMausBot

magpie 引擎

默认引擎保留

为什么要先退出

你的设置保持不变

切回

常见问题

OpenMausBot 的机器人能用 DeepSeek 或 GLM 吗？

为什么要先退出 OpenMausBot？

我原来的引擎会不见吗？

Codex 机器人怎么用 magpie？