一、安装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++ 运行库。这个错误通常是因为：
-
系统缺少必要的 Visual C++ Redistributable
-
虚拟环境中的
ujson安装不完整或损坏
解决方法：
方法1：安装/修复 Visual C++ 运行库（最可能解决）
-
下载并安装 Microsoft Visual C++ Redistributable（最新版）：
-
访问微软官方下载页面：https://aka.ms/vs/17/release/vc_redist.x64.exe
-
下载
vc_redist.x64.exe -
运行安装程序，如果已安装则选择"修复"
-
-
安装完成后重启终端，然后重新运行安装命令：
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 界面