\r \r

🌐 Claw Browser Skill\r

\r This skill gives the agent "Eyes" to browse the web using a real\r Chromium browser.\r \r Unlike simple HTTP requests, claw-browser:\r \r

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

🛠️ Installation & Setup (READ FIRST)\r

\r ⚠️ Before using this tool, the agent MUST set up the Python\r environment and download browser binaries.\r \r If venv does not exist, run this setup command block automatically:\r \r

# 1. Create virtual environment\r
python3 -m venv venv\r
\r
# 2. Activate it\r
source venv/bin/activate\r
\r
# 3. Install dependencies\r
pip install -r requirements.txt\r
\r
# 4. Download Chromium binaries (CRITICAL STEP)\r
playwright install chromium\r
```\r
\r
> ⚠️ The `playwright install chromium` step is **CRITICAL**.\\r
> Without it, the browser will NOT launch.\r
\r
------------------------------------------------------------------------\r
\r
# 🔧 Tools & Usage\r
\r
## `browser.py`\r
\r
### Arguments\r
\r
  -----------------------------------------------------------------------\r
  Argument                            Description\r
  ----------------------------------- -----------------------------------\r
  `--url`                             The website to visit (**Required**)\r
\r
  `--action`                          Action to perform: `read` or\r
                                      `screenshot`\r
\r
  `--visible`                         (Optional) Runs the browser in\r
                                      visible mode (NOT headless). Use if\r
                                      the user wants to *see* the\r
                                      browser.\r
  -----------------------------------------------------------------------\r
\r
------------------------------------------------------------------------\r
\r
# 🚀 Execution Examples\r
\r
⚠️ Always activate the virtual environment first.\r
\r
------------------------------------------------------------------------\r
\r
## 1️⃣ Read a Page (Headless - Default)\r
\r
``` bash\r
source venv/bin/activate && python browser.py --url "https://github.com/trending" --action read\r
```\r
\r
------------------------------------------------------------------------\r
\r
## 2️⃣ Take a Screenshot of a News Site\r
\r
``` bash\r
source venv/bin/activate && python browser.py --url "https://news.ycombinator.com" --action screenshot\r
```\r
\r
This saves:\r
\r
    evidence.png\r
\r
------------------------------------------------------------------------\r
\r
## 3️⃣ Visible Mode (Shows Browser UI - Great for Demos)\r
\r
``` bash\r
source venv/bin/activate && python browser.py --url "https://google.com" --action read --visible\r
```\r
\r
This will launch a real Chromium window on screen.\r
\r
------------------------------------------------------------------------\r
\r
## 4️⃣ Visible Mode (WSL / Linux Fix) ⭐️\r
\r
**Use this if you get "Missing X server" or "Display not found" errors:**\r
\r
```bash\r
export DISPLAY=:0 && source venv/bin/activate && python browser.py --url "[https://google.com](https://google.com)" --action read --visible\r
```\r
This sets the `DISPLAY` variable so the browser can open on your screen.\r
\r
------------------------------------------------------------------------\r
\r
# 🧠 When Should the Agent Use This Skill?\r
\r
Use `claw-browser` when:\r
\r
-   The page requires JavaScript rendering\r
-   The site is dynamic (React, Vue, Angular, etc.)\r
-   Screenshots are required\r
-   The user explicitly asks to "open" or "see" a website\r
-   Traditional HTTP requests fail\r
\r
------------------------------------------------------------------------\r
\r
# ⚡ Summary\r
\r
`claw-browser` transforms your OpenClaw agent from a simple API caller\r
into a **real browser-powered assistant** with visual capabilities.\r
\r
It enables:\r
\r
-   Dynamic page interaction\r
-   Visual verification\r
-   Demo-ready browsing\r
-   Real-world automation\r
\r
------------------------------------------------------------------------\r
\r
Made with ❤️ by @canbirlik\r