- name
- fox-camoufox
- version
- 1.0.0
- description
- Anti-detect browser automation using Camoufox (Firefox-based). Use instead of Chrome/Playwright for bot-detection-heavy sites like X/Twitter, Naver, and other protected sites. Provides stealth browsing with OS/browser fingerprint spoofing, humanized mouse movements, and persistent sessions.
Camoufox
Use instead of OpenClaw's built-in browser tool for bot-detection sites.
Setup (one-time)
bash scripts/setup.shUsage
source ~/.openclaw/workspace/camoufox-env/bin/activate
xvfb-run -a --server-args="-screen 0 1920x1080x24" python3 your_script.pyRequired Settings
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 herePaths
- venv:
~/.openclaw/workspace/camoufox-env/ - profile:
~/.openclaw/camoufox-profile/
CAPTCHA Handling
First visit to protected sites may need manual CAPTCHA:
DISPLAY=:1 python3 scripts/login_session.py https://site.com/loginSolve via VNC, session saves to profile for future automation.
Scripts
scripts/setup.sh- Install dependenciesscripts/browse.py <url> --screenshot out.png- Quick browsescripts/login_session.py <url>- VNC manual login