Skip to main content
Clients & tools

QwenPaw

Open-source personal AI assistant from the AgentScope team

QwenPaw (formerly CoPaw) is an open-source personal AI assistant from the AgentScope team. It supports local and cloud deployment, and integrates with Qwen Cloud 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
  • One-click script
Requires Python 3.10 ~ 3.13:
pip install qwenpaw
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 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.
ConfigurationDescription
Base URLhttps://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
API KeyEnter the Token Plan Team Edition dedicated API Key.
ModelsOn 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.
ConfigurationDescription
API KeyEnter the Coding Plan dedicated API Key.
ModelsCommon 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.
ConfigurationDescription
API KeyEnter the Qwen Cloud API Key.
Base URLhttps://dashscope-intl.aliyuncs.com/compatible-mode/v1
ModelsCommon 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:

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
}