✓ Verified 🌐 Web Scrapers ✓ Enhanced Data

Camoufox

Anti-detect browser automation using Camoufox (Firefox-based).

Rating: 4.9 (423 reviews)
Downloads: 43,480 downloads
Version: 1.0.0

Overview

Anti-detect browser automation using Camoufox (Firefox-based).

Complete Documentation

View Source →

Camoufox

Use instead of OpenClaw's built-in browser tool for bot-detection sites.

Setup (one-time)

bash

bash scripts/setup.sh

Usage

bash

source ~/.openclaw/workspace/camoufox-env/bin/activate
xvfb-run -a --server-args="-screen 0 1920x1080x24" python3 your_script.py

Required Settings

python

from camoufox.sync_api import Camoufox

with Camoufox(
    headless=False,      # MUST be False (True gets detected)
    os='linux',          # MUST match server OS (stack traces leak real OS)
    humanize=True,
    persistent_context=True,
    user_data_dir='~/.openclaw/camoufox-profile'
) as browser:
    page = browser.new_page()
    # Use standard Playwright API from here

Paths

venv: ~/.openclaw/workspace/camoufox-env/
profile: ~/.openclaw/camoufox-profile/

CAPTCHA Handling

First visit to protected sites may need manual CAPTCHA:

bash

DISPLAY=:1 python3 scripts/login_session.py https://site.com/login

Solve via VNC, session saves to profile for future automation.

Scripts

scripts/setup.sh - Install dependencies
scripts/browse.py --screenshot out.png - Quick browse
scripts/login_session.py - VNC manual login

Installation

Terminal bash


openclaw install camoufox

Copied!

💻Code Examples

## Usage

-usage.sh

source ~/.openclaw/workspace/camoufox-env/bin/activate
xvfb-run -a --server-args="-screen 0 1920x1080x24" python3 your_script.py

## Required Settings

-required-settings.py

from camoufox.sync_api import Camoufox

with Camoufox(
    headless=False,      # MUST be False (True gets detected)
    os='linux',          # MUST match server OS (stack traces leak real OS)
    humanize=True,
    persistent_context=True,
    user_data_dir='~/.openclaw/camoufox-profile'
) as browser:
    page = browser.new_page()
    # Use standard Playwright API from here