安装QwenPaw

一、安装QwenPaw

1.使用Windows (PowerShell)命令安装：

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

在安装过程中，可能会报下面的错误

PS C:\Users\chenzh\Desktop\nanwang\qwenpaw-dev> irm https://qwenpaw.agentscope.io/install.ps1 | iex
[qwenpaw] Installing QwenPaw into C:\Users\chenzh\.qwenpaw
[qwenpaw] uv found: C:\Users\chenzh\.local\bin\uv.exe
[qwenpaw] Creating Python 3.12 environment...
[qwenpaw] Python environment ready (Python 3.12.13)
[qwenpaw] Installing qwenpaw from PyPI...
[qwenpaw] QwenPaw installed successfully
python.exe : WARNING C:\Users\chenzh\.qwenpaw\venv\Lib\site-packages\qwenpaw\__init__.py:25 | 2026-06-15 21:24:58 | qwe
npaw: failed to load persisted envs on init: DLL load failed while importing ujson: 找不到指定的模块。
所在位置 行:329 字符: 21
+ ... soleCheck = & $VenvPython -c "import importlib.resources, qwenpaw; p= ...
+                 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : NotSpecified: (WARNING C:\User...json: 找不到指定的模块。:String) [], RemoteException
    + FullyQualifiedErrorId : NativeCommandError

问题原因

ujson 是一个用 C 语言编写的高性能 JSON 解析库，它依赖某些 Visual C++ 运行库。这个错误通常是因为：

1. 系统缺少必要的 Visual C++ Redistributable

2. 虚拟环境中的 ujson 安装不完整或损坏

解决方法：

方法1：安装/修复 Visual C++ 运行库（最可能解决）

1. 下载并安装 Microsoft Visual C++ Redistributable（最新版）：

   • 访问微软官方下载页面：https://aka.ms/vs/17/release/vc_redist.x64.exe

   • 下载 vc_redist.x64.exe

   • 运行安装程序，如果已安装则选择"修复"

2. 安装完成后重启终端，然后重新运行安装命令：

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

2.初始化和启动

# 生成默认配置（只需执行一次）
qwenpaw init --defaults
# 启动应用
qwenpaw app

启动成功后，在浏览器打开 http://127.0.0.1:8088 即可访问Web界面

二、使用虚拟环境安装

1.先安装uv

以管理员身份打开 PowerShell，执行以下命令：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

命令说明：irm 用于下载安装脚本，iex 负责执行。参数 -ExecutionPolicy ByPass 用于绕过 PowerShell 的执行策略，确保脚本能顺利运行

安装脚本会自动将 uv 添加至系统的 PATH 环境变量。完成后，请重启你的终端（PowerShell 或 CMD）。

重新打开命令行，输入以下命令检查是否安装成功：

uv --version

如果看到类似 uv 0.5.x 的版本号输出，说明安装成功

提示：uv 本身是 Rust 编写的独立二进制工具，不依赖 Python 环境。即便你的电脑没有安装 Python，也能顺利完成 uv 的安装

2.安装qwenpaw

window系统

打开 PowerShell 或 CMD，按顺序执行以下命令：

# 1. 创建虚拟环境（建议存放在用户目录下）
uv python -m venv %USERPROFILE%\.venv\qwenpaw

# 2. 激活虚拟环境
%USERPROFILE%\.venv\qwenpaw\Scripts\activate

# 3. 安装 QwenPaw
uv pip install qwenpaw

安装完成后，在已激活虚拟环境的状态下执行：

# 初始化配置（使用默认设置）
qwenpaw init --defaults

# 启动 QwenPaw 服务
qwenpaw app

启动成功后，在浏览器中访问 http://127.0.0.1:8088/ 即可进入 QwenPaw 界面