阿里云原CoPaw现已改名为QwenPaw，官网：https://qwenpaw.agentscope.io/

QwenPaw 安装指南

适用于 Deepin 25 用户

方式一：Pip 安装（推荐普通用户）

前置依赖

• Python 3.10 ~ 3.14
• pip 包管理器

安装步骤

注意：直接用 pip 安装到系统 Python 环境会触发安全警告（Deepin 等 Linux 发行版禁止普通用户往系统目录写包）。

所以，要先创建虚拟环境再安装，既无警告也更隔离。

# 1. 创建虚拟环境（推荐）
python3 -m venv ~/.venv/qwenpaw

# 2. 激活虚拟环境
source ~/.venv/qwenpaw/bin/activate

# 3. 现在 pip install 不再有安全警告了
pip install qwenpaw

# 4. 初始化并启动
qwenpaw init --defaults
qwenpaw app

以后每次使用前，先运行 source ~/.venv/qwenpaw/bin/activate 激活环境即可。还可以让QwenPaw帮你写个快速启动脚本和桌面快捷方式。

为什么会有安全警告

系统 Python 目录（如 /usr/lib/python3.x/site-packages/）归 root 所有，普通用户往里安装包会污染系统环境。Debian/Ubuntu/Deepin 等发行版默认阻止这个操作，因此提示"不安全"。使用虚拟环境完全绕开这个问题。

安装完成后在浏览器打开 http://127.0.0.1:8088/ 配置模型后即可开始对话。

方式二：源码安装（面向开发者）

前置依赖

• Python 3.10 ~ 3.14
• Node.js 和 npm（用于构建前端控制台）
• Git

安装步骤

# 1. 克隆仓库
git clone https://github.com/agentscope-ai/QwenPaw.git

# 有时github访问受限，那可以用这个镜像仓库，我经常不定期更新：https://gitee.com/yngeek/QwenPaw.git
cd QwenPaw

# 2. 构建前端控制台（Web 界面必需）
cd console && npm ci && npm run build
cd ..

# 3. 将构建产物复制到包目录
mkdir -p src/qwenpaw/console
cp -R console/dist/. src/qwenpaw/console/

# 4. 安装 Python 包（可编辑模式）
pip install -e .

# 5. 开发测试用（可选，包含 dev 和 full 依赖）
pip install -e ".[dev,full]"

# 6. 初始化并启动
qwenpaw init --defaults
qwenpaw app

版本更新

执行 git pull 更新到大版本后，需要执行以下步骤使更改生效：

1. 重新构建前端：cd console && npm ci && npm run build && cp -R console/dist/. src/qwenpaw/console/
2. 重新安装 Python 包：pip install -e .
3. 重启应用：qwenpaw app
4. 清除浏览器缓存：Ctrl+Shift+R（或 macOS 上 Cmd+Shift+R）

两种安装方式对比

• 只是想正常使用 → 选择 Pip 安装（配合虚拟环境使用，无安全警告）
• 想研究代码、定制功能或贡献开发 → 选择源码安装