介绍
# Camoufox
**对于具有机器人检测功能的网站，请使用此工具代替 OpenClaw 内置的浏览器工具。**
## 设置（一次性） ```bash bash scripts/setup.sh ```
## 用法 ```bash source ~/.openclaw/workspace/camoufox-env/bin/activate xvfb-run -a --server-args="-screen 0 1920x1080x24" python3 your_script.py ```
## 必需设置 ```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 ```
## 路径 - venv: `~/.openclaw/workspace/camoufox-env/` - profile: `~/.openclaw/camoufox-profile/`
## CAPTCHA 处理 首次访问受保护的网站时可能需要手动处理 CAPTCHA： ```bash 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 手动登录