名称： camoufox
版本： 1.0.0
描述： 基于 Camoufox（Firefox 内核）的反检测浏览器自动化工具。用于替代 Chrome/Playwright，以应对 X/Twitter、Naver 等反爬机制严格的网站。提供隐身浏览功能，包括操作系统/浏览器指纹伪装、拟人化鼠标移动和持久会话。

Camoufox

用于替代 OpenClaw 内置浏览器工具，以应对反爬检测严格的网站。

初始设置（一次性）

bash scripts/setup.sh

使用方法

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

必要配置

from camoufox.sync_api import Camoufox

with Camoufox(
    headless=False,      # 必须为 False（True 模式易被检测）
    os='linux',          # 必须与服务器操作系统一致（堆栈跟踪会泄露真实系统）
    humanize=True,
    persistent_context=True,
    user_data_dir='~/.openclaw/camoufox-profile'
) as browser:
    page = browser.new_page()
    # 此后使用标准的 Playwright API 即可

路径说明

• 虚拟环境：~/.openclaw/workspace/camoufox-env/
• 用户数据目录：~/.openclaw/camoufox-profile/

验证码处理

首次访问受保护网站时可能需要手动处理验证码：

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

通过 VNC 手动解决验证码后，会话将保存至用户数据目录，供后续自动化使用。

脚本说明

• scripts/setup.sh - 安装依赖
• scripts/browse.py <url> --screenshot out.png - 快速浏览并截图
• scripts/login_session.py <url> - 通过 VNC 手动登录并保存会话