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,      # 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

路径

• 虚拟环境：~/.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手动登录