![[Question]: agent with web-crawler](https://www.chat-gpts.plus/wp-content/uploads/2026/06/5840-01201172.jpg)
[Question]: agent with web-crawler
快速结论:该报错发生在 RAGFlow 中使用 Agent 的 Web Crawler 节点时,原因是容器内未安装 Playwright 所需的 Chromium 浏览器。优先尝试在 RAGFlow 容器内执行 playwright install chromium。
问题场景
用户在使用 RAGFlow 的 Agent(智能体)功能,并配置了 Web Crawler(网络爬虫)节点。当 Agent 执行爬取任务时,Playwright 尝试启动 Chromium 浏览器但失败,触发报错。
报错原文
BrowserType.launch: Executable doesn't exist at /root/.cache/ms-playwright/chromium-1134/chrome-linux/chrome
╔════════════════════════════════════════════════════════════╗
║ Looks like Playwright was just installed or updated. ║
║ Please run the following command to download new browsers: ║
║ ║
║ playwright install ║
║ ║
║ <3 Playwright Team ║
╚════════════════════════════════════════════════════════════╝
原因分析
RAGFlow 依赖于 Playwright 库来驱动 Web Crawler,但默认的 Docker 镜像中只安装了 Playwright Python 包,并未下载配套的 Chromium 浏览器二进制文件。Playwright 在首次启动时需要在 ~/.cache/ms-playwright/ 目录下找到特定版本的 Chromium,缺失该文件导致启动失败。
环境排查
- 确认 RAGFlow 是否运行在 Docker 容器中。
- 检查容器内是否有
/root/.cache/ms-playwright/目录及其下的chromium-1134子目录。
解决步骤
- 进入 RAGFlow 容器终端(如果使用 docker-compose,容器名称通常为
ragflow_server):
docker exec -it ragflow_server bash - 在容器内执行 Playwright 的浏览器安装命令(可优先尝试):
playwright install chromium - 如果上一步报错或下载失败,可尝试强制安装所有浏览器:
playwright install - 安装完成后,重新启动 RAGFlow 服务或重启容器以使环境生效。
验证方法
在 RAGFlow 中重新执行包含 Web Crawler 节点的 Agent 流程,观察是否能正常抓取网页内容,且不再出现 Executable doesn't exist 错误。



