Fox Camoufox

这是一款基于Firefox的反检测浏览器自动化工具，替代Chrome/Playwright用于X、Naver等高反爬站点。核心功能含OS/浏览器指纹伪装、人性化鼠标移动、持久会话，兼容标准Playwright API。需配置匹配服务器的系统参数，首次访问需通过VNC手动过验证码，会话会保存复用；通过Python脚本调用，需先运行脚本完成环境搭建。

qinthqod

热度 44.38

最近更新 2026-05-10 17:50:16

分类：自动化依赖：代码执行 / 联网浏览搜索 / 读写文件应用场景：自动化脚本 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add fox-camoufox

Metadata

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.sh

Usage

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

Required 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 here

Paths

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/login

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

Scripts

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