第26章 QwenPaw

QwenPaw（原 CoPaw）是 AgentScope 团队开源的个人 AI 助手，支持本地或云端部署，可通过 Token Plan 个人版、Token Plan 团队版、Coding Plan 或按量计费接入阿里云百炼。 ​安装 QwenPaw 推荐 pip 包或一键安装脚本。Docker、桌面端、ModelScope 在线运行等方式参考 QwenPaw 官方文档。 一键脚本pip 安装脚本自动安装 uv、创建虚拟环境并下载依赖，无需手动配置 Python。根据操作系统选择对应命令： macOS / Linux： Copycurl -fsSL https://qwenpaw.agentscope.io/install.sh | bash Windows（CMD）： Copycurl -fsSL https://qwenpaw.agentscope.io/install.bat -o install.bat && install.bat Windows（PowerShell）： Copyirm https://qwenpaw.agentscope.io/install.ps1 | iex 安装完成后，在新终端执行：Copyqwenpaw init --defaults qwenpaw app 需 Python 3.10 ~ 3.13：Copypip install qwenpaw 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填入支持的模型。 ​设置默认模型 进入 设置 > 模型 > 默认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 等生成参数后保存： Copy{ "temperature": 0.7, "top_p": 0.9, "max_tokens": 4096 }