QwenPaw（原 CoPaw）是 AgentScope 團隊開源的個人 AI 助手，支援本地或雲端部署，可通過 Token Plan 團隊版、Coding Plan 或隨用隨付接入阿里雲百鍊。
安裝 QwenPaw
推薦 pip 包或一鍵安裝指令碼。Docker、案頭端、ModelScope 線上運行等方式參考 QwenPaw 官方文檔。
一鍵指令碼
指令碼自動安裝 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 apppip 安裝
需 Python 3.10 ~ 3.13：
pip install qwenpaw
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）。儲存後進入設定頁面按下表填寫。
|
配置項 |
說明 |
|
基礎 URL |
|
|
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：
|
|
模型 |
已預設常用模型。新增模型點擊添加模型，模型 ID填入支援的模型。 |
設定預設模型
進入 設定 > 模型 > 預設LLM 選擇模型並儲存。聊天頁面右上方下拉式功能表可臨時切換當前會話的供應商和模型。
常見問題
錯誤碼
按計費方案排查：
-
隨用隨付：錯誤碼排查
-
Coding Plan：Coding 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
}