OpenClaw Browser Relay и Chrome Extension | open-claw.su

Browser Relay — одна из самых мощных возможностей OpenClaw. Она позволяет ИИ-агенту управлять реальным браузером: открывать страницы, кликать по кнопкам, заполнять формы, делать скриншоты и извлекать данные. Всё это — через стандартный Chrome DevTools Protocol (CDP).

В этом руководстве разберём три режима работы с браузером, установку Chrome Extension и типичные сценарии использования.

Зачем агенту браузер

Без Browser Relay агент может работать только с API и терминалом. С включённым браузером он получает доступ к:

Веб-приложениям — заполнение форм, оформление заказов, работа с CRM
Залогиненным сервисам — почта, банк, личные кабинеты (через ваши сессии)
Парсингу данных — сбор информации с сайтов, мониторинг цен
Скриншотам — визуальный анализ страниц
Тестированию — автоматическая проверка веб-интерфейсов

Три режима работы

OpenClaw поддерживает три способа управления браузером:

Режим	Описание	Когда использовать
OpenClaw-managed	Отдельный изолированный Chromium	Безопасные задачи, парсинг, тесты
Extension Relay	Управление вашими вкладками Chrome	Работа с залогиненными сервисами
Remote CDP	Удалённый браузер (Browserless и др.)	Серверные задачи, масштабирование

Режим 1: OpenClaw-managed (по умолчанию)

OpenClaw запускает отдельный экземпляр Chromium с собственным профилем. Ваш основной браузер не затрагивается.

Включение

// ~/.openclaw/openclaw.json
{
  "browser": {
    "enabled": true,
    "defaultProfile": "openclaw",
    "headless": false
  }
}

Запуск

# Проверить, что браузер работает
openclaw browser --browser-profile openclaw tabs

OpenClaw откроет изолированный Chromium. Агент сможет переходить по страницам, но не будет иметь доступа к вашим куки и сессиям.

Плюсы:

Полная изоляция от ваших данных
Безопасно для парсинга и тестов
Не нужно устанавливать расширение

Минусы:

Нет доступа к залогиненным сервисам
Нужно авторизоваться заново в каждом сервисе

Режим 2: Extension Relay (Chrome Extension)

Этот режим позволяет агенту управлять вашими реальными вкладками в Chrome — с вашими авторизованными сессиями.

Архитектура

OpenClaw Agent
     ↓ (HTTP-команды)
Browser Control Server (порт 18791)
     ↓
Local Relay Server (порт 18792)
     ↓ (WebSocket)
Chrome Extension (OpenClaw Copilot)
     ↓ (chrome.debugger API)
Ваши вкладки Chrome

Установка расширения

Способ 1: Через CLI

# Установить расширение
openclaw browser extension install

# Узнать путь к расширению
openclaw browser extension path

Затем:

Откройте chrome://extensions в Chrome
Включите «Режим разработчика» (правый верхний угол)
Нажмите «Загрузить распакованное расширение»
Выберите папку, которую показала команда extension path

Способ 2: Chrome Web Store

Найдите «OpenClaw Copilot» в Chrome Web Store и установите.

Настройка

// ~/.openclaw/openclaw.json
{
  "browser": {
    "enabled": true,
    "defaultProfile": "chrome"
  }
}

Как пользоваться

Откройте нужную страницу в Chrome
Нажмите на иконку расширения OpenClaw Copilot в панели инструментов
Расширение подключится к вкладке — на иконке появится значок ON
Теперь агент может управлять этой вкладкой

Статусы расширения:

Значок	Значение
`ON`	Подключено, агент может управлять вкладкой
`...`	Подключается к relay-серверу
`!`	Relay-сервер недоступен

Важно: подключение вкладки — только вручную. Расширение не подключается к вкладкам автоматически. Вы сами решаете, какие вкладки доступны агенту.

Использование из CLI

# Посмотреть подключённые вкладки
openclaw browser --browser-profile chrome tabs

# Сделать скриншот текущей вкладки
openclaw browser --browser-profile chrome screenshot

Режим 3: Remote CDP

Подключение к удалённому браузеру через CDP URL. Подходит для серверных сценариев.

// ~/.openclaw/openclaw.json
{
  "browser": {
    "enabled": true,
    "profiles": {
      "remote": {
        "cdpUrl": "ws://your-server:9222/devtools/browser"
      }
    }
  }
}

Совместимые сервисы:

Browserless — облачные браузеры
Любой Chromium с --remote-debugging-port=9222

Практические сценарии

Парсинг данных с сайта

Попросите агента:

Открой сайт example.com/catalog, собери все товары с ценами в таблицу и сохрани в файл prices.csv

Заполнение формы

Зайди на сайт hr-portal.com (вкладка уже открыта), заполни форму заявки на отпуск с 15 по 22 марта

Мониторинг

Каждые 30 минут проверяй страницу store.com/product/123 и сообщи мне в Telegram, когда цена упадёт ниже 5000₽

Скриншот для отчёта

Сделай скриншот дашборда analytics.example.com и отправь мне в Telegram

Полная конфигурация

{
  "browser": {
    "enabled": true,
    "defaultProfile": "openclaw",
    "headless": false,

    "profiles": {
      "openclaw": {
        "type": "managed",
        "headless": false,
        "viewport": {
          "width": 1280,
          "height": 720
        }
      },
      "chrome": {
        "type": "extension",
        "relayPort": 18792
      },
      "remote": {
        "type": "cdp",
        "cdpUrl": "ws://localhost:9222/devtools/browser"
      }
    }
  }
}

Безопасность

Что может агент с доступом к вкладке

Когда вы подключаете вкладку через Extension Relay, агент получает полный доступ к ней:

Чтение содержимого страницы
Клики и ввод текста
Доступ к куки и авторизованным сессиям
Навигация по ссылкам

Если вы залогинены в Gmail в этой вкладке — агент может читать и отправлять письма. Это мощный инструмент, который требует осторожности.

Отключение браузера

Если Browser Relay не нужен:

{
  "browser": {
    "enabled": false
  }
}

Типичные проблемы

Расширение показывает ! (relay недоступен)

Убедитесь, что OpenClaw запущен: openclaw doctor
Проверьте, что relay-сервер работает на порту 18792
Перезапустите gateway: остановите текущий процесс и запустите openclaw gateway --port 18789

«Could not attach to tab»

Некоторые страницы (chrome://, расширения) не поддерживают CDP
Попробуйте обычную веб-страницу

Браузер открывается, но агент не может им управлять

Проверьте browser.enabled: true в конфигурации
Убедитесь, что профиль указан верно: openclaw или chrome

Extension Relay медленно работает

Проверьте, что relay-сервер на localhost (не через сеть)
Закройте неиспользуемые подключённые вкладки

Headless-режим не делает скриншоты

Установите viewport в конфигурации профиля
Убедитесь, что Chromium поддерживает headless-скриншоты

Что дальше

Быстрый старт — если ещё не настроили OpenClaw
Настройка SOUL.md — задайте агенту правила работы с браузером
Безопасность — важно прочитать перед использованием Browser Relay
Подключение Telegram — получайте результаты работы браузера в мессенджер