🌐 Claw 浏览器技能

该技能为智能体赋予了使用真实 Chromium 浏览器浏览网页的“视觉能力”。

与简单的 HTTP 请求不同，claw-browser 具备以下能力：

• 执行 JavaScript 渲染
• 处理动态内容
• 加载单页应用（SPA）
• 生成真实截图
• 支持以可见模式（非无头模式）运行

🛠️ 安装与配置（请务必先阅读）

⚠️ 在使用本工具前，智能体必须完成 Python 环境配置并下载浏览器二进制文件。

若当前目录下不存在 venv，请自动执行以下初始化命令块：

# 1. 创建虚拟环境
python3 -m venv venv

# 2. 激活虚拟环境
source venv/bin/activate

# 3. 安装依赖
pip install -r requirements.txt

# 4. 下载 Chromium 二进制文件（关键步骤）
playwright install chromium

⚠️ playwright install chromium 步骤至关重要。
若跳过此步，浏览器将无法启动。

🔧 工具与用法

browser.py

参数说明

参数 说明

--url 要访问的网站地址（必填）

--action 执行动作：read 或 screenshot

--visible （可选）以可见模式（非无头模式）运行浏览器。当用户希望看到浏览器界面时启用。

🚀 执行示例

⚠️ 执行前请始终先激活虚拟环境。

1️⃣ 读取网页内容（默认无头模式）

source venv/bin/activate && python browser.py --url "https://github.com/trending" --action read

2️⃣ 截取新闻网站截图

source venv/bin/activate && python browser.py --url "https://news.ycombinator.com" --action screenshot

该命令将保存截图至：

evidence.png

3️⃣ 可见模式（显示浏览器 UI，适用于演示场景）

source venv/bin/activate && python browser.py --url "https://google.com" --action read --visible

该命令将在屏幕上启动一个真实的 Chromium 窗口。

4️⃣ 可见模式（WSL / Linux 兼容方案）⭐️

如遇 “Missing X server” 或 “Display not found” 错误，请使用以下命令：

export DISPLAY=:0 && source venv/bin/activate && python browser.py --url "https://google.com" --action read --visible

该命令通过设置 DISPLAY 环境变量，使浏览器可在您的屏幕上正常显示。

🧠 智能体应在何时使用该技能？

当出现以下情况时，请使用 claw-browser：

• 目标网页依赖 JavaScript 渲染
• 网站为动态站点（如基于 React、Vue、Angular 等框架构建）
• 需要获取网页截图
• 用户明确要求“打开”或“查看”某个网站
• 传统 HTTP 请求方式失败

⚡ 总结

claw-browser 将您的 OpenClaw 智能体从一个简单的 API 调用者，升级为具备真实浏览器驱动能力与视觉交互能力的智能助手。

它支持：

• 动态网页交互
• 可视化结果验证
• 开箱即用的演示浏览体验
• 面向真实场景的自动化任务

由 @canbirlik 精心打造 ❤️