#QwenPaw

QwenPaw 的自定义 Provider 支持 OpenAI Chat、OpenAI Responses 和 Anthropic 三种协议。本文假设你已有可使用的 QwenPaw 实例，只说明用户侧模型接入，不包含部署和平台管理。

核验日期：2026-07-27

#前置条件

• 已按 QwenPaw 官方仓库的说明获得可用客户端或实例，并可进入模型设置。
• 已取得 Geekit 根地址、用户令牌和模型 ID。
• QwenPaw 所在环境能够访问 Geekit 地址。

如果 QwenPaw 运行在容器中，localhost 指向容器自身。Geekit 不在同一容器时，应填写容器可访问的域名或网络地址。

#创建自定义 Provider

在模型设置中创建自定义 Provider，名称可填写 Geekit。按模型协议选择类型：

同时填写 Geekit 用户令牌和真实模型 ID。协议选项决定 QwenPaw 调用 /v1/chat/completions、/v1/responses 还是 /v1/messages。

#推荐选择

• 普通对话和通用 Agent：先选 OpenAI Chat。
• Codex 类代码 Agent：选 OpenAI Responses。
• Claude 模型：选 Anthropic。

Responses 模式会直接调用 Responses API 探测模型。只支持 Chat 的模型不能通过 Responses 探测，也不应通过更改模型名称强行接入。

#验证

保存 Provider 后，先执行模型连接测试，再创建一个最小只读任务。检查：

1. QwenPaw 显示 Provider 和模型可用。
2. Geekit 调用日志中的端点与协议选项一致。
3. 流式响应能够结束。
4. Agent 可以正确处理工具调用结果。

Anthropic Provider 的模型探测可能先访问 /v1/models，再回退到最小 Messages 请求。模型列表探测失败但 Messages 调用成功时，应以实际调用结果和 Geekit 日志为准。

#常见问题

#容器内连接失败

不要使用只在宿主机有效的 localhost。改用可从 QwenPaw 容器访问的 Geekit 域名或容器网络地址。

#返回 404

检查 Anthropic 是否误填了 /v1 Base URL，或 OpenAI 协议是否漏掉 /v1。

#文本成功但工具调用失败

确认模型在所选协议下支持工具调用，并降低任务复杂度复测。连接成功不等于模型具备完整 Agent 能力。

#官方资料

• QwenPaw 官方仓库
• 自定义 Provider 界面实现
• OpenAI Chat Provider 实现
• OpenAI Responses Provider 实现
• Anthropic Provider 实现