🌐 Claw Browser Skill

---

author: "@canbirlik"

dependencies:

python:

- playwright

description: A visual, human-like web browser for OpenClaw agents.Supports reading,screenshots, and visible mode.

emoji: 🌐

name: claw-browser

platforms:

---

# 🌐 Claw Browser Skill

This skill gives the agent **"Eyes"** to browse the web using a real

Chromium browser.

Unlike simple HTTP requests, `claw-browser`:

------------------------------------------------------------------------

# 🛠️ Installation & Setup (READ FIRST)

⚠️ **Before using this tool, the agent MUST set up the Python

environment and download browser binaries.**

If `venv` does not exist, run this setup command block automatically:

# 1. Create virtual environment
python3 -m venv venv

# 2. Activate it
source venv/bin/activate

# 3. Install dependencies
pip install -r requirements.txt

# 4. Download Chromium binaries (CRITICAL STEP)
playwright install chromium

> ⚠️ The `playwright install chromium` step is **CRITICAL**.\

> Without it, the browser will NOT launch.

------------------------------------------------------------------------

# 🔧 Tools & Usage

`browser.py`

Arguments

-----------------------------------------------------------------------

Argument Description

----------------------------------- -----------------------------------

`--url` The website to visit (**Required**)

`--action` Action to perform: `read` or

`screenshot`

`--visible` (Optional) Runs the browser in

visible mode (NOT headless). Use if

the user wants to *see* the

browser.

-----------------------------------------------------------------------

------------------------------------------------------------------------

# 🚀 Execution Examples

⚠️ Always activate the virtual environment first.

------------------------------------------------------------------------

1️⃣ Read a Page (Headless - Default)

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

------------------------------------------------------------------------

2️⃣ Take a Screenshot of a News Site

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

This saves:

evidence.png

------------------------------------------------------------------------

3️⃣ Visible Mode (Shows Browser UI - Great for Demos)

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

This will launch a real Chromium window on screen.

------------------------------------------------------------------------

4️⃣ Visible Mode (WSL / Linux Fix) ⭐️

**Use this if you get "Missing X server" or "Display not found" errors:**

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

This sets the `DISPLAY` variable so the browser can open on your screen.

------------------------------------------------------------------------

# 🧠 When Should the Agent Use This Skill?

Use `claw-browser` when:

------------------------------------------------------------------------

# ⚡ Summary

`claw-browser` transforms your OpenClaw agent from a simple API caller

into a **real browser-powered assistant** with visual capabilities.

It enables:

------------------------------------------------------------------------

Made with ❤️ by @canbirlik