在 QwenPaw 中使用千问AI平台模型
QwenPaw(原 CoPaw)是 AgentScope 团队开源的个人 AI 助手,支持本地或云端部署,可通过 Token Plan 个人版、Token Plan 团队版或按量计费接入千问AI平台。
推荐 pip 包或一键安装脚本。Docker、桌面端、ModelScope 在线运行等方式参考 QwenPaw 官方文档。
启动后访问
按提示依次选择提供商、粘贴 API Key、选择模型。提供商对应关系:返回
也可以使用 Console 可视化配置。在 Console 点击设置 > 模型,根据计费方案配置对应的提供商。
进入内置的 Aliyun Token Plan 提供商设置页面,填入 API Key。
进入内置的 Aliyun Token Plan 提供商设置页面,填入 API Key。
进入内置的 DashScope 提供商设置页面,填入 API Key。
进入设置 > 模型 > 默认LLM选择模型并保存。聊天页面右上角下拉菜单可临时切换当前会话的提供商和模型。
除了上述方式,也可以通过配置文件接入。
按计费方案排查:
可能原因:
在该模型的提供商设置页面展开进阶配置,按 JSON 格式调整
使用 qwen4-max-preview 时,1.1.x 默认
max_tokens=8192,需在 generate_kwargs.max_tokens 中调大;2.2.x 也建议显式设置。使用 qwen4-max 时,1.1.x 默认
max_tokens=8192,需在 generate_kwargs.max_tokens 中调大;2.2.x 也建议显式设置。qwen4-max 的上下文长度为 1M Token;非思考模式最大输出 131,072 Token,思考与最终回答合计最大 262,144 Token;默认 reasoning_effort=high,thinking_budget=131072。安装 QwenPaw
推荐 pip 包或一键安装脚本。Docker、桌面端、ModelScope 在线运行等方式参考 QwenPaw 官方文档。
- 一键脚本
- pip 安装
脚本自动安装 uv、创建虚拟环境并下载依赖,无需手动配置 Python。根据操作系统选择对应命令:安装完成后,在新终端执行:
- macOS / Linux:
- Windows(CMD):
- Windows(PowerShell):
http://127.0.0.1:8088/ 打开 QwenPaw Console。
快速开始
1
获取 API Key
根据计费方案获取对应的 API Key:
- Token Plan 个人版:创建或查看 API Key
- Token Plan 团队版:分配坐席并获取 API Key
- 按量计费:千问AI平台 API Key
2
配置模型
- Token Plan:Aliyun Token Plan(
aliyun-tokenplan) - 按量计费:DashScope(
dashscope)
3
验证
status: success 即配置成功。通过控制台接入
也可以使用 Console 可视化配置。在 Console 点击设置 > 模型,根据计费方案配置对应的提供商。
Token Plan 个人版
进入内置的 Aliyun Token Plan 提供商设置页面,填入 API Key。
Token Plan 团队版
进入内置的 Aliyun Token Plan 提供商设置页面,填入 API Key。
按量计费
进入内置的 DashScope 提供商设置页面,填入 API Key。
| 配置项 | 说明 |
|---|---|
| API 密钥 | 填入千问AI平台 API Key。 |
| 基础 URL | https://maas.qianwenaiapi.com/compatible-mode/v1 |
| 模型 | 已预设常用模型。新增模型点击添加模型,模型 ID 填入支持的模型,例如 qwen3.8-max、qwen3.8-flash。 |
设置默认模型
进入设置 > 模型 > 默认LLM选择模型并保存。聊天页面右上角下拉菜单可临时切换当前会话的提供商和模型。
通过配置文件接入
除了上述方式,也可以通过配置文件接入。
1
打开或新建配置文件
~/.qwenpaw.secret/providers/custom/<provider-id>.json2
写入配置
- Token Plan 个人版
- Token Plan 团队版
- 按量计费
将
YOUR_API_KEY 替换为 Token Plan 个人版 API Key。错误码
按计费方案排查:
- Token Plan:Token Plan 常见问题
- 按量计费:错误码
常见问题
报错 401 Incorrect API key provided
可能原因:
- 各计费方案的 API Key 不通用,确认 API Key 与基础 URL 来自同一方案。
长对话或工具调用时报错上下文超限
在该模型的提供商设置页面展开进阶配置,按 JSON 格式调整 max_tokens 等生成参数后保存: