核心用法
claw-browser 是一个专为 OpenClaw agent 设计的视觉化网页浏览技能，基于 Playwright 框架驱动真实的 Chromium 浏览器。与简单的 HTTP 请求不同，该工具能够完整渲染 JavaScript、处理动态内容（React/Vue/Angular 等 SPA 应用），并支持两种核心操作模式：read（读取页面内容）和 screenshot（截取屏幕证据）。
使用前必须完成四步环境初始化：创建 Python 虚拟环境、激活环境、安装依赖（playwright）、下载 Chromium 二进制文件——其中最后一步至关重要，缺失将导致浏览器无法启动。
显著优点
- 真实浏览器内核：基于 Chromium，完美支持现代 Web 技术栈
- 可视化模式：通过
--visible参数启动真实窗口，便于演示和调试 - 截图取证：自动生成
evidence.png，适用于需要视觉验证的场景 - 动态内容解析：突破静态 HTTP 限制，可处理需要 JS 执行的页面
潜在局限与风险
- 环境依赖重：需预先配置 Python venv 并下载数百 MB 的浏览器二进制文件
- 启动开销大：相比轻量级 HTTP 请求，Chromium 冷启动耗时显著
- 资源占用高：运行时会消耗较多内存和 CPU，不适合高频低延迟场景
- 可见模式稳定性：非 headless 模式在部分 Linux 无图形环境上可能异常
适合人群
- 需要解析 JavaScript 密集型网站的数据分析师
- 需要视觉验证或截图存证的安全测试人员
- 希望向客户演示 AI 浏览能力的开发者
- 传统 requests/httpx 无法搞定的反爬虫场景
常规风险
| 风险类型 | 说明 |
|---------|------|
| 供应链安全 | 依赖 `playwright` 和 Chromium 二进制，需信任微软及 Google 分发渠道 |
| 信息泄露 | 浏览器会携带真实 User-Agent、时区、语言等指纹特征 |
| 资源滥用 | 可视化模式可能被滥用于点击欺诈或恶意社工 |
| 执行隔离 | 建议始终在 venv 中运行，避免污染系统 Python 环境 |