---
url: https://limapi.com/docs/agents/qwenpaw.md
---
# QwenPaw

QwenPaw（原 CoPaw）是 AgentScope 团队开源的个人 AI 助手，支持本地或云端部署，具备定时任务、工具调用、多频道接入等能力。

## 安装 QwenPaw

推荐一键安装脚本或 pip 安装；Docker、桌面端等其他方式参考 QwenPaw 官方文档。

### 一键脚本

脚本自动安装 uv、创建虚拟环境并下载依赖，无需手动配置 Python。

**macOS / Linux：**

```bash
curl -fsSL https://qwenpaw.agentscope.io/install.sh | bash
```

**Windows（PowerShell）：**

```powershell
irm https://qwenpaw.agentscope.io/install.ps1 | iex
```

安装完成后，在**新终端**执行：

```bash
qwenpaw init --defaults
qwenpaw app
```

### pip 安装

需 Python 3.10 ~ 3.13：

```bash
pip install qwenpaw
qwenpaw init --defaults
qwenpaw app
```

启动后访问 `http://127.0.0.1:8088/` 打开 QwenPaw Console。

## 配置接入凭证

在 Console 中点击 **设置 > 模型**，添加一个 OpenAI 兼容的自定义提供商：

| 配置项 | 填写内容 |
|--------|----------|
| API 密钥 | [Portal](https://limapi.com/) 创建的 API Key（`sk-` 开头） |
| 基础 URL | `https://limapi.com/api/v1` |
| 模型 | 点击 **添加模型**，在「模型 ID」中填入平台支持的模型，如 `qwen3.8-max`、`claude-sonnet-4-6` |

### 设置默认模型

进入 **设置 > 模型 > 默认 LLM**，选择刚添加的 LimAPI 模型并保存。聊天页面右上角下拉菜单可临时切换当前会话的模型。

## 验证配置

回到聊天页面，输入任意问题，模型正常返回响应即配置成功。可在模型页面点击「测试连接」快速验证凭证是否有效。

## 常见问题

### 报错 401 Incorrect API key provided

* 确认 API Key 与基础 URL 来自同一平台（LimAPI），复制完整无空格；
* 确认基础 URL 为 `https://limapi.com/api/v1`。

### 长对话或工具调用时报错上下文超限

在 LimAPI 提供商设置页面展开 **进阶配置**，按 JSON 格式调整生成参数后保存：

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

### 想接入 Anthropic 协议模型？

添加提供商时选择 Anthropic 兼容类型，基础 URL 填 `https://limapi.com/api/anthropic`，即可使用 Claude 系列模型。