camoufox

TotalClaw 作者 totalclaw v1.0.0

使用 Camoufox（基于 Firefox）进行反检测浏览器自动化。对于 X/Twitter、Naver 和其他受保护网站等机器人检测较多的网站，请使用而不是 Chrome/Playwright。通过操作系统/浏览器指纹欺骗、人性化鼠标移动和持久会话提供隐秘浏览。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~goodgoodjm-camoufox

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~goodgoodjm-camoufox/file -o goodgoodjm-camoufox.md

## 概述（中文）

使用 Camoufox（基于 Firefox）进行反检测浏览器自动化。对于 X/Twitter、Naver 和其他受保护网站等机器人检测较多的网站，请使用而不是 Chrome/Playwright。通过操作系统/浏览器指纹欺骗、人性化鼠标移动和持久会话提供隐秘浏览。

## 原文

# Camoufox

**Use instead of OpenClaw's built-in browser tool for bot-detection sites.**

## Setup (one-time)
```bash
bash scripts/setup.sh
```

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

## Required Settings
```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
```

## Paths
- venv: `~/.openclaw/workspace/camoufox-env/`
- profile: `~/.openclaw/camoufox-profile/`

## CAPTCHA Handling
First visit to protected sites may need manual CAPTCHA:
```bash
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