QwenPaw - 阿里云百炼

安装 QwenPaw

推荐 pip 包或一键安装脚本。Docker、桌面端、ModelScope 在线运行等方式参考 QwenPaw 官方文档。

一键脚本
pip 安装

脚本自动安装 uv、创建虚拟环境并下载依赖，无需手动配置 Python。根据操作系统选择对应命令：

macOS / Linux：

curl -fsSL https://qwenpaw.agentscope.io/install.sh | bash

Windows（CMD）：

curl -fsSL https://qwenpaw.agentscope.io/install.bat -o install.bat && install.bat

Windows（PowerShell）：

irm https://qwenpaw.agentscope.io/install.ps1 | iex

安装完成后，在新终端执行：

qwenpaw init --defaults
qwenpaw app

启动后访问 http://127.0.0.1:8088/ 打开 QwenPaw Console。

配置接入凭证

在 Console 点击设置 > 模型，根据计费方案配置对应的提供商。

Token Plan 个人版

进入内置的 Aliyun Token Plan 提供商设置页面，填入 API Key。

配置项	说明
API 密钥	填入 Token Plan 个人版专属 API Key。
模型	已预设常用模型。新增模型点击添加模型，模型 ID填入 Token Plan 个人版支持的模型。

Token Plan 团队版

进入内置的 Aliyun Token Plan 提供商设置页面，填入 API Key。

配置项	说明
API 密钥	填入 Token Plan 团队版专属 API Key。
模型	已预设常用模型。新增模型点击添加模型，模型 ID填入 Token Plan 团队版支持的模型。

Coding Plan

进入内置的 Aliyun Coding Plan (China) 提供商设置页面，填入 API Key。

配置项	说明
API 密钥	填入 Coding Plan 专属 API Key。
模型	已预设常用模型，可在模型页面测试连接验证。新增模型点击添加模型，模型 ID填入 Coding Plan 支持的模型。

按量计费

进入内置的 DashScope 提供商设置页面，填入 API Key。基础 URL 默认为 China (Beijing)，可在下拉菜单切换地域。

配置项	说明
API 密钥	填入阿里云百炼 API Key，需与所选地域对应。
基础 URL	根据模型部署地域，在下拉菜单选择对应 URL（请将 URL 中的 `{WorkspaceId}` 替换为真实的获取Workspace ID）： China (Beijing)：`https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1` International (Singapore)：`https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1`，将 `WorkspaceId` 替换为真实的获取Workspace ID。 US (Virginia)：`https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/compatible-mode/v1`
模型	已预设常用模型。新增模型点击添加模型，模型 ID填入支持的模型。

配置项

说明

API 密钥

填入阿里云百炼 API Key，需与所选地域对应。

基础 URL

根据模型部署地域，在下拉菜单选择对应 URL（请将 URL 中的 {WorkspaceId} 替换为真实的获取Workspace ID）：

China (Beijing)：https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
International (Singapore)：https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1，将 WorkspaceId 替换为真实的获取Workspace ID。
US (Virginia)：https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/compatible-mode/v1

模型

已预设常用模型。新增模型点击添加模型，模型 ID填入支持的模型。

设置默认模型

进入设置 > 模型 > 默认LLM 选择模型并保存。聊天页面右上角下拉菜单可临时切换当前会话的提供商和模型。

常见问题

错误码

按计费方案排查：

按量计费：错误码排查
Coding Plan：Coding Plan 常见问题
Token Plan 个人版：Token Plan 个人版常见问题
Token Plan 团队版：Token Plan 团队版常见问题

报错 401 Incorrect API key provided

可能原因：

三种计费方案的 API Key 不通用，确认与基础 URL 来自同一方案。
按量计费的 API Key 与基础 URL 不在同一地域。

长对话或工具调用时报错上下文超限

在该模型的提供商设置页面展开进阶配置，按 JSON 格式调整 max_tokens 等生成参数后保存：

{
  "temperature": 0.7,
  "top_p": 0.9,
  "max_tokens": 4096
}

​安装 QwenPaw

​配置接入凭证

​Token Plan 个人版

​Token Plan 团队版

​Coding Plan

​按量计费

​设置默认模型

​常见问题

​错误码

​报错 401 Incorrect API key provided

​长对话或工具调用时报错上下文超限