跳转到主要内容
更多工具

QwenPaw

在 QwenPaw 中使用千问AI平台模型

QwenPaw(原 CoPaw)是 AgentScope 团队开源的个人 AI 助手,支持本地或云端部署,可通过 Token Plan 个人版、Token Plan 团队版或按量计费接入千问AI平台。
使用 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:
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。

快速开始

1

获取 API Key

根据计费方案获取对应的 API Key:
2

配置模型

qwenpaw models config
按提示依次选择提供商、粘贴 API Key、选择模型。提供商对应关系:
  • Token Plan:Aliyun Token Plan(aliyun-tokenplan)
  • 按量计费:DashScope(dashscope)
3

验证

qwenpaw task -i "你好"
返回 status: success 即配置成功。

通过控制台接入

也可以使用 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 团队版支持的模型。

按量计费

进入内置的 DashScope 提供商设置页面,填入 API Key。
配置项说明
API 密钥填入千问AI平台 API Key。
基础 URLhttps://maas.qianwenaiapi.com/compatible-mode/v1
模型已预设常用模型。新增模型点击添加模型,模型 ID 填入支持的模型,例如 qwen3.8-max、qwen3.8-flash。

设置默认模型

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

通过配置文件接入

除了上述方式,也可以通过配置文件接入。
1

打开或新建配置文件

~/.qwenpaw.secret/providers/custom/<provider-id>.json
2

写入配置

  • Token Plan 个人版
  • Token Plan 团队版
  • 按量计费
将 YOUR_API_KEY 替换为 Token Plan 个人版 API Key。
{
  "id": "qianwen-token-plan",
  "name": "Qianwen AI Platform",
  "base_url": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
  "api_key": "YOUR_API_KEY",
  "chat_model": "OpenAIChatModel",
  "models": [
    {
      "id": "auto",
      "name": "Auto",
      "supports_image": false,
      "max_tokens": 65536,
      "max_input_length": 1000000,
      "generate_kwargs": {}
    },
    {
      "id": "qwen4-max",
      "name": "Qwen4 Max",
      "supports_image": true,
      "max_tokens": 262144,
      "max_input_length": 1000000,
      "generate_kwargs": {}
    },
    {
      "id": "qwen4-max-preview",
      "name": "Qwen4 Max Preview",
      "supports_image": true,
      "max_tokens": 131072,
      "max_input_length": 1000000,
      "generate_kwargs": {}
    },
    {
      "id": "qwen3.8-max",
      "name": "Qwen3.8 Max",
      "supports_image": true,
      "max_tokens": 131072,
      "max_input_length": 1000000,
      "generate_kwargs": {}
    },
    {
      "id": "qwen3.8-flash",
      "name": "Qwen3.8 Flash",
      "supports_image": true,
      "max_tokens": 131072,
      "max_input_length": 1000000,
      "generate_kwargs": {}
    },
    {
      "id": "qwen3.7-max",
      "name": "Qwen3.7 Max",
      "supports_image": false,
      "max_tokens": 131072,
      "max_input_length": 1000000,
      "generate_kwargs": {}
    },
    {
      "id": "qwen3.7-plus",
      "name": "Qwen3.7 Plus",
      "supports_image": true,
      "max_tokens": 65536,
      "max_input_length": 1000000,
      "generate_kwargs": {}
    },
    {
      "id": "qwen3.6-flash",
      "name": "Qwen3.6 Flash",
      "supports_image": true,
      "max_tokens": 65536,
      "max_input_length": 1000000,
      "generate_kwargs": {}
    },
    {
      "id": "deepseek-v4.1-flash",
      "name": "DeepSeek V4.1 Flash",
      "supports_image": true,
      "max_tokens": 65536,
      "max_input_length": 1000000,
      "generate_kwargs": {}
    },
    {
      "id": "deepseek-v4.1-flash-1017",
      "name": "DeepSeek V4.1 Flash 1017",
      "supports_image": true,
      "max_tokens": 65536,
      "max_input_length": 1000000,
      "generate_kwargs": {}
    },
    {
      "id": "deepseek-v4-pro",
      "name": "DeepSeek V4 Pro",
      "supports_image": false,
      "max_tokens": 65536,
      "max_input_length": 1000000,
      "generate_kwargs": {}
    },
    {
      "id": "deepseek-v4-pro-0813",
      "name": "DeepSeek V4 Pro 0813",
      "supports_image": false,
      "max_tokens": 65536,
      "max_input_length": 1000000,
      "generate_kwargs": {}
    },
    {
      "id": "deepseek-v4-flash-0731",
      "name": "DeepSeek V4 Flash 0731",
      "supports_image": false,
      "max_tokens": 65536,
      "max_input_length": 1000000,
      "generate_kwargs": {}
    },
    {
      "id": "glm-5.3",
      "name": "GLM-5.3",
      "supports_image": false,
      "max_tokens": 16384,
      "max_input_length": 202752,
      "generate_kwargs": {}
    },
    {
      "id": "glm-5.2",
      "name": "GLM-5.2",
      "supports_image": false,
      "max_tokens": 16384,
      "max_input_length": 202752,
      "generate_kwargs": {}
    }
  ],
  "is_custom": true
}

错误码

按计费方案排查:

常见问题

报错 401 Incorrect API key provided

可能原因:
  • 各计费方案的 API Key 不通用,确认 API Key 与基础 URL 来自同一方案。

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

在该模型的提供商设置页面展开进阶配置,按 JSON 格式调整 max_tokens 等生成参数后保存:
{
  "temperature": 0.7,
  "top_p": 0.9,
  "max_tokens": 4096
}
QwenPaw - 千问AI平台