QwenPaw (formerly CoPaw) is an open-source personal AI assistant from the AgentScope team. It supports local and cloud deployment, and integrates with Alibaba Cloud Model Studio via Token Plan Team Edition, Coding Plan, or Pay-as-you-go.
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
Requires Python 3.10 ~ 3.13:
pip install qwenpaw
qwenpaw init --defaults
qwenpaw appOne-click script
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 appAfter 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 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 |
|
|
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:
|
|
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 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
}