文档 · 指南

让 QwenPaw 用任意模型

QwenPaw（agentscope-ai/QwenPaw，原名 CoPaw）是一个个人助手应用，里面可以有多个自己的 Agent。magpie 在 QwenPaw 里加一个 OpenAI 兼容的 magpie 供应商，把 magpie 里的每个模型都列进去，并把你选的模型设为某个 Agent 的 active_model。于是 QwenPaw 的 Agent 能用 magpie 里的任何模型：DeepSeek、GLM、Kimi、Qwen、OpenAI 或 Anthropic Key，或 ChatGPT、Copilot 订阅，每个 Agent 可以用不同的模型。

接入 QwenPaw

  1. 先启动一次 QwenPaw运行 qwenpaw app，让它写出 Agent 的设置（agent.json）。
  2. 在 magpie 里添加供应商在 供应商 页添加 API Key，或登录一个订阅。
  3. 在 QwenPaw 那一行选模型在 Agent 页给 QwenPaw 选一个 magpie 模型，需要时再选思考强度。
  4. 第一次接入后重启 QwenPawQwenPaw 只在启动时读供应商文件，重启一次之后就能用。
终端
magpie qwenpaw deepseek/deepseek-v4-pro          # 默认 Agent
magpie qwenpaw#writer deepseek/deepseek-v4-flash  # 名为 writer 的 Agent
magpie qwenpaw effort high                        # thinking_level

写了哪些文件

QwenPaw 的工作目录是 QWENPAW_WORKING_DIR；没设时如果有旧的 ~/.copaw 就用它，否则是 ~/.qwenpaw。它的密钥目录是 QWENPAW_SECRET_DIR（也可以写在工作目录的 .env 里），否则是 <工作目录>.secret，例如 ~/.qwenpaw.secret。

magpie 写 <密钥目录>/providers/custom/magpie.json，格式和 QwenPaw 控制台里“添加供应商”保存的一样：OpenAI Chat Completions（OpenAIChatModel），指向网关的 /v1，带一个标明 QwenPaw 的 Key，extra_models 里是 magpie 的每个模型。然后把 Agent 的 agent.json 里的 active_model 设为 provider magpie 和你选的模型；思考强度写在 thinking_level（minimal、low、medium、high、xhigh、max，留空就是 inherit，用模型自己的）。

终端
// ~/.qwenpaw.secret/providers/custom/magpie.json
{"id": "magpie", "name": "magpie", "base_url": "http://127.0.0.1:3425/v1",
 "api_key": "…", "chat_model": "OpenAIChatModel", "is_custom": true,
 "extra_models": [{"id": "deepseek/deepseek-v4-pro", …}, …]}

// ~/.qwenpaw/workspaces/default/agent.json
{"active_model": {"provider_id": "magpie", "model": "deepseek/deepseek-v4-pro"},
 "thinking_level": "high", …}

QwenPaw 把 Key 加密存放（以 ENC: 开头）。magpie 写的是明文 Key，QwenPaw 下次启动时会自己加密，这和它自己的文件存 Key 的方式一样，所以 Key 不会出现在 QwenPaw 不存它的地方。供应商文件只有你自己能读（0600）。

什么时候生效

QwenPaw 只在启动时读供应商文件，所以第一次接入、以及 magpie 的模型列表变了之后，要重启一次 QwenPaw；在那之前，用 magpie 模型的对话会报 Provider 'magpie' not found。之后再给 Agent 换模型就不用重启了：QwenPaw 发现 agent.json 变了会重新读，每一轮都重新取模型，所以从下一条消息起就用新模型。

多个 Agent

QwenPaw 的每个 Agent 在 magpie 里是一行：qwenpaw 是一直都在的 default Agent，其他的是 qwenpaw#<id>。只有用 QwenPaw 自己后端（默认的 qwenpaw 后端）的 Agent 才会用这个模型；用 ACP 后端的 Agent 跑的是别的程序，magpie 不会接，并会提示先切回 QwenPaw 自己的后端。

你自己的设置

Agent 原来的 active_model 会被记下，切回时放回去。fallback_models 和 subagent_model 不动。你在 QwenPaw 控制台里对 magpie 供应商的修改（某个模型的上下文窗口、生成参数、供应商的请求头）都会保留。在 QwenPaw 里关掉或删掉 magpie 供应商的话，magpie 的检查会提示它已经不再走 magpie。

切回

在 magpie 里把那一行切回默认，magpie 把这个 Agent 的 active_model 还原。没有任何 Agent（包括它们的 fallback 和 subagent 模型）再用 magpie 的供应商时，magpie 才删掉 custom/magpie.json。也可以直接选一个你自己供应商的模型，magpie 的供应商先留在列表里，直到断开。

终端
magpie qwenpaw default

常见问题

QwenPaw 能用 DeepSeek、GLM、Kimi 或 Qwen 吗？

能。magpie 在 QwenPaw 的密钥目录里写一个 OpenAI 兼容的 magpie 供应商，把你选的模型设为 Agent 的 active_model。第一次接入后重启一次 QwenPaw。

为什么报 Provider 'magpie' not found？

QwenPaw 只在启动时读供应商文件。接入后重启一次 QwenPaw 即可；之后换模型从下一条消息起生效，不用再重启。

CoPaw 也能用吗？

能。QwenPaw 原名 CoPaw；有旧的 ~/.copaw 时，magpie 和 QwenPaw 一样用它作为工作目录。

每个 Agent 能用不同的模型吗？

能。default Agent 是 magpie 里的 qwenpaw 一行，其他 Agent 是 qwenpaw#，各自选模型和思考强度。

更多 Agent 用同样的模型：让 AstrBot 用任意模型、让 nanobot 用任意模型、让 OpenClaw 用任意模型。遇到报错？见 常见错误排查，或到 Discord 提问。