QwenPaw - Alibaba Cloud Model Studio

Install QwenPaw

Use the pip package or one-click installation script. For Docker, desktop app, or ModelScope online runtime, see the QwenPaw official documentation.

pip install
One-click script

Requires Python 3.10 ~ 3.13:

pip install qwenpaw
qwenpaw init --defaults
qwenpaw app

The script installs uv, creates a virtual environment, and downloads dependencies automatically. No manual Python setup required. Choose the command for your operating system:

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

After installation, run in a new terminal:

qwenpaw init --defaults
qwenpaw app

After launch, visit http://127.0.0.1:8088/ to open QwenPaw Console.

Configure credentials

In Console, click Settings > Models and configure the provider for your billing plan.

Token Plan Personal Edition

QwenPaw does not include a built-in provider for Token Plan Personal Edition. On the Providers page, click Add Provider. Set Protocol to OpenAI-compatible (Chat Completions) (Provider ID and Name are customizable, e.g. bailian-token-plan-personal). After saving, open the Settings page and fill in the table below.

Configuration	Description
Base URL	`https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1`
API Key	Enter the Token Plan Personal Edition dedicated API Key.
Models	On the provider Models page, click Add Model and set Model ID to a supported Token Plan Personal Edition model.

Token Plan Team Edition

QwenPaw does not include a built-in provider for Token Plan Team Edition. On the Providers page, click Add Provider. Set Protocol to OpenAI-compatible (Chat Completions) (Provider ID and Name are customizable, e.g. bailian-token-plan). After saving, open the Settings page and fill in the table below.

Configuration	Description
Base URL	`https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1`
API Key	Enter the Token Plan Team Edition dedicated API Key.
Models	On the provider Models page, click Add Model and set Model ID to a supported Token Plan Team Edition model.

Coding Plan

Open the built-in Aliyun Coding Plan (International) provider Settings page and fill in the API Key.

Configuration	Description
API Key	Enter the Coding Plan dedicated API Key.
Models	Common models are pre-configured. Verify them via Test Connection on the Models page. To add a model, click Add Model and set Model ID to a supported Coding Plan model.

Pay-as-you-go

Open the DashScope provider Settings page and fill in the API Key. Base URL defaults to China (Beijing); switch regions via the dropdown.

Configuration	Description
API Key	Enter the Alibaba Cloud Model Studio API Key that matches the selected region.
Base URL	Select the URL matching the model deployment region from the dropdown, replace `{WorkspaceId}` in the URL with your actual Get the 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` US (Virginia): `https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/compatible-mode/v1`
Models	Common models are pre-configured. To add a model, click Add Model and set Model ID to a supported model.

Configuration

Description

API Key

Enter the Alibaba Cloud Model Studio API Key that matches the selected region.

Base URL

Select the URL matching the model deployment region from the dropdown, replace {WorkspaceId} in the URL with your actual Get the 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
US (Virginia): https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/compatible-mode/v1

Models

Common models are pre-configured. To add a model, click Add Model and set Model ID to a supported model.

Set the default model

Open Settings > Models > Default LLM, select a model, and click Save. The dropdown in the top-right of the chat page switches the provider and model for the current session.

FAQ

Error codes

Troubleshoot by billing plan:

Pay-as-you-go: Error code troubleshooting
Coding Plan: Coding Plan FAQ
Token Plan Personal Edition: Token Plan Personal Edition FAQ
Token Plan Team Edition: Token Plan Team Edition FAQ

Error 401 Incorrect API key provided

Possible causes:

API Keys are not interchangeable across the three billing plans. Make sure the API Key and Base URL come from the same plan.
The Pay-as-you-go API Key and Base URL are in different regions.

Context length exceeded during long conversations or tool calls

On the provider Settings page for that model, expand Advanced Configuration and adjust generation parameters such as max_tokens in JSON format, then save:

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

​Install QwenPaw

​Configure credentials

​Token Plan Personal Edition

​Token Plan Team Edition

​Coding Plan

​Pay-as-you-go

​Set the default model

​FAQ

​Error codes

​Error 401 Incorrect API key provided

​Context length exceeded during long conversations or tool calls