claw-browser

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

🌐 Claw Browser Skill

This skill gives the agent "Eyes" to browse the web using a real Chromium browser.

Unlike simple HTTP requests, claw-browser:

• Renders JavaScript
• Handles dynamic content
• Loads SPA applications
• Takes real screenshots
• Can run in visible (non-headless) mode

---

🛠️ 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:

• The page requires JavaScript rendering
• The site is dynamic (React, Vue, Angular, etc.)
• Screenshots are required
• The user explicitly asks to "open" or "see" a website
• Traditional HTTP requests fail

---

⚡ Summary

claw-browser transforms your OpenClaw agent from a simple API caller into a real browser-powered assistant with visual capabilities.

It enables:

• Dynamic page interaction
• Visual verification
• Demo-ready browsing
• Real-world automation

---

Made with ❤️ by @canbirlik