国内安装openmanus时playwright报错主因是默认从海外cdn下载chromium失败，需清理缓存、分步安装playwright==1.48.0、配置淘宝镜像源并仅安装chromium（验证版本为v1148）、替换测试脚本中的国外url为国内可访问站点。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在国内安装OpenManus时，执行playwright相关命令频繁报错，如“Executable doesn’t exist”“Project(s) 'chromium' not found”或下载卡死在99%，根本原因是Playwright默认从海外CDN拉取Chromium二进制，而国内网络无法稳定访问该地址，且新版v1208等版本的headless-shell组件在镜像站中缺失。
先清理混乱环境
不要在系统目录（如C:\Windows\System32）或conda base环境中操作，否则UAC权限和路径冲突会直接导致PermissionError或缓存写入失败。
新建独立工作目录并进入：
mkdir C:\Users\%USERNAME%\openmanus-playwright && cd C:\Users\%USERNAME%\openmanus-playwright
【必须删除旧node_modules和.cache/ms-playwright】：残留的v1208不完整包会干扰后续安装，手动清空项目根目录下的node_modules，并运行rmdir /s /q "%LOCALAPPDATA%\ms-playwright"（Windows）或rm -rf ~/.cache/ms-playwright（macOS/Linux）。
分步安装核心依赖
OpenManus的requirements.txt里包含playwright，但若直接pip install -r requirements.txt，会因playwright触发自动install chromium而失败。必须拆开处理。
方法一：跳过playwright及其子依赖先行安装其他库
pip install -r requirements.txt --no-deps
方法二：单独安装指定兼容版本的playwright（经实测，1.40.0与1.48.0最稳）
pip install playwright==1.48.0 --no-build-isolation
注意：--no-build-isolation参数能绕过某些Python 3.11+环境下wheel构建失败的问题，尤其在Windows上避免OSError: [Errno 13] Permission denied。
使用Playwright API直接进行浏览器自动化。导航网站、与元素交互、提取数据、截图、生成PDF、录制视频，自动化复杂工作流程。比MCP方法更可靠。
配置国内镜像并精准安装Chromium
第一步：设置环境变量，让playwright install指向淘宝镜像源
set PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors/playwright
第二步：仅安装Chromium，不装Firefox/WebKit（OpenManus不需要）
npx playwright install chromium
第三步：关键验证——终端输出末尾必须出现playwright build v1148。如果显示v1208、v1192或任何非v1148版本，说明镜像未生效或缓存未清干净，需重复前两步。
修改测试脚本避开国外站点
OpenManus自带的playwright示例常访问playwright.dev或example.com，国内无法解析或超时，导致page.goto()抛出net::ERR_ABORTED。
打开tests/example.spec.ts（或对应Python脚本），将所有国外URL替换为国内可访问站点：
原代码：await page.goto('https://playwright.dev');
改为：await page.goto('https://www.baidu.com');
这一步不做，即使Chromium装成功，首次运行仍会失败。
