文档 · 指南

让 OpenClaw 用任意模型

OpenClaw 在 WhatsApp、Telegram、Discord 等渠道上回复你，用的是配置里指定的模型。magpie 把自己作为一个供应商加进 OpenClaw，于是 OpenClaw 能用你在 magpie 里的任何模型：DeepSeek、Kimi、GLM、Qwen、OpenAI Key，或 ChatGPT、Copilot 订阅，不用往 OpenClaw 里贴 Key。

OpenClaw 的设置在 ~/.openclaw/openclaw.json。magpie 在里面加一个名为 magpie 的供应商：网关的 /v1 地址、OpenAI 的 chat completions 接口、一个 OpenClaw 专用的 Key，以及你在 magpie 里每个模型的条目。然后把你选的模型设为 OpenClaw 的默认模型。网关把每个请求翻译给该模型的供应商，工具调用和推理都保留。

接入 OpenClaw

  1. 在 magpie 里添加供应商在 供应商 页添加 API Key，或登录一个订阅。
  2. 在 OpenClaw 那一行选模型在 Agent 页，给 OpenClaw 一行选一个模型。OpenClaw 无需重启即可生效。
终端
magpie openclaw deepseek/deepseek-v4-pro    # OpenClaw 用 DeepSeek
magpie openclaw                             # 查看 OpenClaw 当前的模型

选择模型

OpenClaw 里的模型写作 供应商/模型，所以 magpie 的模型显示为 magpie/deepseek/deepseek-v4-pro、magpie/openai/gpt-6.1 等。magpie 设置主模型，保留你的 fallbacks。如果配置里有允许的模型列表，magpie 会把 magpie/* 加进去，免得它的模型被拒。magpie 不知道上下文长度的模型按 128K 告诉 OpenClaw。

已经有模型的对话

默认模型改了，新对话立即生效。已经有模型的对话会保留原模型：在那个对话里发送 /model default，它就换到新模型上。

magpie 写了什么

只有 models.providers.magpie、默认模型，以及（如果有的话）允许列表。你的其他供应商、渠道和 Key 保持原样，你自己加在 magpie 供应商里的键（headers、timeoutSeconds、模型的 maxTokens）也保留。单个 agent 的模型（agents.entries.*.model）仍归你管，用 $include 拆分的配置不会改动。

magpie 按 OpenClaw 自己的规则找配置文件：$OPENCLAW_CONFIG_PATH，否则 $OPENCLAW_STATE_DIR 里的 openclaw.json，否则 $OPENCLAW_PROFILE 对应的 ~/.openclaw-<profile>，否则 ~/.openclaw。用 JSON5 写的、不是标准 JSON 的文件不会被改动，magpie 会提示。

切回

在 OpenClaw 那一行取消 magpie，或运行 magpie openclaw default。magpie 删除它的供应商，并恢复 OpenClaw 之前的模型（前提是默认模型仍是 magpie 的）；你之后自己选的模型会保留。

常见问题

OpenClaw 能用 ChatGPT 订阅吗？

能。在 magpie 里登录 ChatGPT，在 OpenClaw 一行选一个 GPT 模型。OpenClaw 把请求发给 magpie，由 magpie 使用订阅。

需要重启 OpenClaw 吗？

不需要。OpenClaw 的网关会自动读取模型和默认模型的改动。已经有模型的对话会保留原模型，直到你在其中发送 /model default。

magpie 会动我的渠道或其他供应商吗？

不会。它只写自己的供应商、默认模型，以及（如果有的话）允许列表。

我用了 OpenClaw 的 profile，magpie 能找到吗？

能。它按 OpenClaw 的方式读取 OPENCLAW_PROFILE、OPENCLAW_STATE_DIR、OPENCLAW_CONFIG_PATH 和 OPENCLAW_HOME。

更多 Agent 用同样的模型：OpenCode 接入其他模型、让 Hermes Agent 用任意模型、Claude Code 接入其他模型。遇到报错？见 常见错误排查，或到 Discord 提问。