核心用法
claw-browser 是一款为 OpenClaw Agent 设计的视觉化浏览器技能，基于 Playwright 框架构建，使 Agent 具备真实的网页浏览能力。该技能通过调用本地 Chromium 浏览器实例，支持 JavaScript 渲染、动态内容加载、SPA 应用交互、屏幕截图以及可选的可视化模式（非 headless）。
使用前必须完成环境初始化：创建 Python 虚拟环境、安装依赖（playwright），并执行关键的 playwright install chromium 命令下载浏览器二进制文件，否则浏览器将无法启动。
主要功能
- 页面读取 (
--action read)：获取渲染后的完整页面内容 - 屏幕截图 (
--action screenshot)：保存为evidence.png - 可视化模式 (
--visible)：弹出真实浏览器窗口，适用于演示场景
显著优点
1. 真实浏览器环境：不同于简单 HTTP 请求，可处理 JavaScript 动态渲染内容，完美支持 React、Vue、Angular 等现代前端框架
2. 视觉验证能力：支持截图功能，便于内容审核、证据留存和视觉回归测试
3. 双模式运行：默认 headless 模式高效静默运行，可选 visible 模式满足演示和调试需求
4. 跨平台支持：兼容 macOS、Linux、Windows 三大主流平台
5. 集成友好：作为 OpenClaw 生态组件，与 Agent 工作流无缝衔接
潜在缺点与局限性
1. 环境依赖重：需预装 Python 虚拟环境、Playwright 依赖及数百 MB 的 Chromium 二进制文件，首次部署成本较高
2. 资源消耗大：相比纯 HTTP 请求，启动完整浏览器实例内存和 CPU 占用显著更高
3. 无状态会话：当前版本未提及 Cookie 持久化、登录状态保持等高级浏览器功能
4. 单页面操作：工具设计为单次 URL 访问模式，不支持连续多步导航、表单提交等复杂交互
5. 截图固定命名：输出文件硬编码为 evidence.png，多任务场景下可能产生覆盖冲突
适合人群
- 需要处理动态网页的自动化开发者：传统爬虫无法解析 JavaScript 渲染内容的场景
- Agent 工作流构建者：希望为 AI Agent 扩展真实视觉浏览能力的 OpenClaw 用户
- 演示与教学场景：visible 模式适合需要向观众展示浏览器操作的直播、录屏场景
- 内容审核与监控：需定期截图验证网页视觉状态的质量保证团队
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 供应链风险 | 依赖 Playwright 及 Chromium 二进制，需验证来源完整性 | 使用官方 PyPI 源，校验 playwright 安装包的哈希值 |
| 执行环境风险 | 运行用户提供的 URL 可能触发恶意网页内容 | 在隔离环境（容器/虚拟机）中运行，限制网络访问权限 |
| 资源耗尽风险 | Chromium 进程异常或内存泄漏可能导致系统资源耗尽 | 设置进程超时机制，监控内存使用情况 |
| 信息泄露风险 | 截图可能意外捕获敏感信息（如本地文件路径、系统通知） | 在干净环境中运行，清理桌面敏感内容，审查截图输出 |
| 可见模式风险 | `--visible` 模式可能暴露用户本地浏览数据（如自动填充的密码） | 使用干净的 Chromium 配置文件，禁用自动填充和同步功能 |