O QwenPaw (anteriormente CoPaw) é um assistente pessoal de IA open-source da equipe AgentScope. Ele oferece suporte a implantação local e na cloud, além de integração com o Alibaba Cloud Model Studio por meio do Token Plan Personal Edition, Token Plan Team Edition, Coding Plan ou pagamento conforme o uso.
Instale o QwenPaw
Use o pacote pip ou o script de instalação com um clique. Para Docker, aplicativo desktop ou ambiente de execução online do ModelScope, consulte a documentação oficial do QwenPaw.
pip install
Requer Python 3.10 ~ 3,13:
pip install qwenpaw
qwenpaw init --defaults
qwenpaw app
Script com um clique
Este script instala o uv, cria um ambiente virtual e baixa as dependências automaticamente, eliminando a necessidade de configurar o Python manualmente. Escolha o comando correspondente ao seu sistema operacional:
- 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
Após a instalação, execute os comandos abaixo em um novo terminal:
qwenpaw init --defaults
qwenpaw app
Depois de iniciar, acesse http://127.0.0.1:8088/ para abrir o QwenPaw Console.
Configure credenciais
No Console, clique em Settings > Models e configure o provedor correspondente ao seu plano de faturamento.
Token Plan Personal Edition
O QwenPaw não inclui um provedor integrado para o Token Plan Personal Edition. Na página Providers, clique em Add Provider. Defina o Protocol como OpenAI-compatible (Chat Completions) (o Provider ID e o Name são personalizáveis, por exemplo, bailian-token-plan-personal). Após salvar, abra a página Settings e preencha os campos conforme a tabela abaixo.
Configuração | Descrição |
|---|---|
Base URL |
|
API Key | Insira a API Key dedicada do Token Plan Personal Edition. |
Models | Na página Models do provedor, clique em Add Model e defina o Model ID como um supported Token Plan Personal Edition model. |
Token Plan Team Edition
O QwenPaw não possui um provedor integrado para o Token Plan Team Edition. Na página Providers, clique em Add Provider. Defina o Protocol como OpenAI-compatible (Chat Completions) (o Provider ID e o Name são personalizáveis, por exemplo, bailian-token-plan). Após salvar, acesse a página Settings e preencha os dados da tabela a seguir.
Configuração | Descrição |
|---|---|
Base URL |
|
API Key | Insira a API Key dedicada do Token Plan Team Edition. |
Models | Na página Models do provedor, clique em Add Model e defina o Model ID como um supported Token Plan Team Edition model. |
Coding Plan
Acesse a página Settings do provedor integrado Aliyun Coding Plan (International) e insira a API Key.
Configuração | Descrição |
|---|---|
API Key | Insira a API Key dedicada do Coding Plan. |
Models | Modelos comuns vêm pré-configurados. Verifique-os usando o botão Test Connection na página Models. Caso precise adicionar um modelo, clique em Add Model e defina o Model ID como um supported Coding Plan model. |
Pagamento conforme o uso
Abra a página Settings do provedor DashScope e insira a API Key. A Base URL padrão é China (Beijing); altere a região pelo menu suspenso se necessário.
Configuração | Descrição |
|---|---|
API Key | Insira a Alibaba Cloud Model Studio API Key correspondente à região selecionada. |
Base URL | Selecione no menu suspenso a URL correspondente à região de implantação do modelo e substitua
|
Models | Modelos comuns já estão pré-configurados. Para incluir um novo, clique em Add Model e defina o Model ID como um supported model. |
Defina o modelo padrão
Navegue até Settings > Models > Default LLM, selecione um modelo e clique em Save. O menu suspenso no canto superior direito da página de chat permite alternar o provedor e o modelo da sessão atual.
FAQ
Códigos de erro
Consulte a solução de problemas de acordo com o plano de faturamento:
- Pagamento conforme o uso: 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
Erro 401 Incorrect API key provided
Causas possíveis:
- As API Keys não são intercambiáveis entre os três planos de faturamento. Certifique-se de que a API Key e a Base URL pertençam ao mesmo plano.
- A API Key e a Base URL do plano de pagamento conforme o uso estão em regiões diferentes.
Limite de contexto excedido em conversas longas ou chamadas de ferramentas
Na página Settings do provedor referente a esse modelo, expanda Advanced Configuration e ajuste os parâmetros de geração, como max_tokens, no formato JSON e salve as alterações:
{
"temperature": 0.7,
"top_p": 0.9,
"max_tokens": 4096
}