QwenPaw - Alibaba Cloud Model Studio

安裝 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 個人版

QwenPaw 未內建國際站 Token Plan 個人版供應商。在供應商頁面點擊添加供應商，協議選 OpenAI 相容（Chat Completions）（供應商 ID 與名稱可自訂，如 bailian-token-plan-personal）。儲存後進入設定頁面按下表填寫。

配置項	說明
基礎 URL	`https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1`
API 金鑰	填入 Token Plan 個人版專屬 API Key。
模型	在供應商模型頁面點擊添加模型，模型 ID填入 Token Plan 個人版支援的模型。

Token Plan 團隊版

QwenPaw 未內建國際站 Token Plan 團隊版供應商。在供應商頁面點擊添加供應商，協議選 OpenAI 相容（Chat Completions）（供應商 ID 與名稱可自訂，如 bailian-token-plan）。儲存後進入設定頁面按下表填寫。

配置項	說明
基礎 URL	`https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1`
API 金鑰	填入 Token Plan 團隊版專屬 API Key。
模型	在供應商模型頁面點擊添加模型，模型 ID填入 Token Plan 團隊版支援的模型。

Coding Plan

進入內建的 Aliyun Coding Plan (International) 供應商設定頁面，填入 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

​長對話或工具調用時報錯上下文超限