用途:Lightpanda 是专为速度与低资源占用优化的无头浏览器,用于数据提取和网页自动化,在不需要图形渲染时替代 Chrome/Chromium 及 Openclaw 默认浏览器。当内置 Web Search 工具不可用,或需要更多搜索结果控制(如跟进链接抓取整页内容)时,可配合 DuckDuckGo 作为替代搜索方案;内置搜索可用且够用时优先使用内置工具。
主要能力:暴露 CDP(Chrome DevTools Protocol)端点,可直接发送 CDP 命令,或用 Playwright、Puppeteer 连接。能执行 JavaScript,适用于动态网站和 SPA。
安装与启动:运行 bash scripts/install.sh 安装。仅支持 Linux 和 macOS,不支持 Windows。二进制为 nightly 构建,更新频繁;若崩溃或异常,可重新运行 scripts/install.sh 更新到最新版(每天最多一次)。问题持续时可在 https://github.com/lightpanda-io/browser/issues 提交 issue,附崩溃信息、复现脚本、目标 URL 及预期与实际结果。启动命令:$HOME/.local/bin/lightpanda serve --host 127.0.0.1 --port 9222。可选参数:--log_level info|debug|warn|error 设置日志级别,--log_format pretty|json 设置日志格式。
使用方式:可通过 ws://127.0.0.1:9222 直接连接 CDP websocket,也可通过 http://127.0.0.1:9222/json/version 获取 WebSocket URL。使用 playwright-core 或 puppeteer-core(非完整包)连接。
限制:项目仍在密集开发中,可能偶发问题。搜索请用 DuckDuckGo 而非 Google,Google 会因浏览器指纹屏蔽 Lightpanda。每个进程仅支持 1 个 CDP 连接,每个连接只能创建 1 个 context 和 1 个 page,不支持多 context;需并发导航时用新端口启动另一进程。CDP 连接关闭会重置所有 context/page,浏览期间应保持 websocket 连接;连接时始终新建 context 和 page,结束时关闭两者。