Исправление CAPTCHA в браузере OpenClaw с помощью Camoufox и CLI-обёртки

Проблема: почему OpenClaw блокируют

Встроенный браузер OpenClaw использует Chromium с Playwright. Несмотря на человеческий вид (запасной MacBook Pro в домашней сети, авторизованные аккаунты), сайты с системами обнаружения ботов его блокируют. Google и Bing выдают капчи, X показывает стены входа, а Medium не загружается за Cloudflare.

Как работает обнаружение ботов

Инструменты вроде Puppeteer и Playwright используют Chrome DevTools Protocol (CDP) для управления браузером. При подключении срабатывает команда Runtime.Enable. Антибот-скрипты обнаруживают это с помощью JavaScript. Cloudflare и DataDome тоже это проверяют.

Библиотеки автоматизации также внедряют JavaScript на страницы для работы (window.__playwright__binding__ и подобные). Антибот-скрипты ловят это, проверяя дескрипторы свойств и сигнатуры функций. Если toString() у браузерной функции больше не возвращает "[native code]", значит, что-то было изменено.

Аппаратный отпечаток раскрывает сотни параметров: модель GPU через WebGL, пиксельный вывод Canvas, который различается в зависимости от графического оборудования, разрешение экрана, метрики шрифтов, обработку аудио. Автоматизированные браузеры ошибаются в этом — вывод Canvas идентичен в тысячах сессий, или user-agent говорит Windows, а GPU — Apple.

Решение: Camoufox

Большинство инструментов против обнаружения пытаются исправить это на уровне JavaScript, переопределяя navigator.webdriver или подделывая вывод Canvas. Антибот-скрипты видят это насквозь. Исправление должно происходить на уровне движка браузера.

Camoufox (форк Firefox) изменяет значения отпечатка в реализации на C++, поэтому поддельные свойства выглядят нативными при любой проверке. Он вообще не использует CDP, и скрипты страниц не видят код автоматизации.

Практическая реализация: CLI-обёртка

У Camoufox есть только Python SDK, что требует от агента писать одноразовые скрипты на Python для каждого действия в браузере, разбираться в сигнатурах методов, работать с асинхронным контекстом и парсить результаты. Каждый визит на страницу тратил токены на шаблонный код.

Решение — обёртка в CLI. Агент вызывает команды оболочки, чтобы открывать страницы, кликать по элементам, заполнять формы. Никаких скриптов на Python, никакого асинхронного шаблонного кода. Демон поддерживает браузер живым между командами, устраняя затраты на запуск для каждого действия.

Чтобы снизить расход токенов, CLI возвращает снимки дерева доступности вместо исходного HTML. Каждый элемент получает короткий тег @ref для взаимодействия. Режим только для взаимодействия оставляет только кнопки, ссылки и поля ввода. Страница, которая стоит 15 000 токенов как HTML, может стоить 800 как интерактивный снимок.

CLI, навыки и исходный код доступны по адресу camoufox-cli.