OmeniaClaw browser

Керуйте поверхнею керування браузером OmeniaClaw і виконуйте дії браузера (життєвий цикл, профілі, вкладки, знімки, скриншоти, навігація, введення, емуляція стану та налагодження).

Пов’язане:

• Інструмент Browser + API: інструмент Browser

Поширені прапорці

• --url <gatewayWsUrl>: URL WebSocket Gateway (типово з конфігурації).
• --token <token>: токен Gateway (за потреби).
• --timeout <ms>: тайм-аут запиту (мс).
• --expect-final: чекати на фінальну відповідь Gateway.
• --browser-profile <name>: вибрати профіль браузера (типовий — із конфігурації).
• --json: машиночитаний вивід (де підтримується).

Швидкий старт (локально)

OmeniaClaw browser profilesOmeniaClaw browser --browser-profile OmeniaClaw startOmeniaClaw browser --browser-profile OmeniaClaw open https://example.comOmeniaClaw browser --browser-profile OmeniaClaw snapshot

Агенти можуть виконати ту саму перевірку готовності за допомогою browser({ action: "doctor" }).

Швидке усунення несправностей

Якщо start завершується помилкою not reachable after start, спочатку усуньте проблему з готовністю CDP. Якщо start і tabs успішні, але open або navigate завершується помилкою, площина керування браузером справна, а причина збою зазвичай полягає в політиці SSRF для навігації.

Мінімальна послідовність:

OmeniaClaw browser --browser-profile OmeniaClaw doctorOmeniaClaw browser --browser-profile OmeniaClaw startOmeniaClaw browser --browser-profile OmeniaClaw tabsOmeniaClaw browser --browser-profile OmeniaClaw open https://example.com

Детальні вказівки: усунення несправностей Browser

Життєвий цикл

OmeniaClaw browser statusOmeniaClaw browser doctorOmeniaClaw browser doctor --deepOmeniaClaw browser startOmeniaClaw browser start --headlessOmeniaClaw browser stopOmeniaClaw browser --browser-profile OmeniaClaw reset-profile

Примітки:

• doctor --deep додає перевірку живого знімка. Це корисно, коли базова готовність CDP позначена як справна, але вам потрібне підтвердження, що поточну вкладку можна інспектувати.
• Для профілів attachOnly і віддалених профілів CDP команда OmeniaClaw browser stop закриває активну сесію керування та скидає тимчасові перевизначення емуляції, навіть якщо OmeniaClaw не запускав процес браузера самостійно.
• Для локальних керованих профілів OmeniaClaw browser stop зупиняє запущений процес браузера.
• OmeniaClaw browser start --headless застосовується лише до цього запиту запуску й лише тоді, коли OmeniaClaw запускає локальний керований браузер. Це не переписує browser.headless або конфігурацію профілю й не має ефекту для браузера, який уже працює.
• На Linux-хостах без DISPLAY або WAYLAND_DISPLAY локальні керовані профілі автоматично працюють у режимі headless, якщо лише OmeniaClaw_BROWSER_HEADLESS=0, browser.headless=false або browser.profiles.<name>.headless=false явно не вимагає видимого браузера.

Якщо команда відсутня

Якщо OmeniaClaw browser є невідомою командою, перевірте plugins.allow у ~/.OmeniaClaw/OmeniaClaw.json.

Коли plugins.allow присутній, явно перелічіть вбудований плагін браузера, якщо лише конфігурація вже не містить кореневий блок browser:

{  plugins: {    allow: ["telegram", "browser"],  },}

Явний кореневий блок browser, наприклад browser.enabled=true або browser.profiles.<name>, також активує вбудований плагін браузера за обмежувального allowlist плагінів.

Пов’язане: інструмент Browser

Профілі

Профілі — це іменовані конфігурації маршрутизації браузера. На практиці:

• OmeniaClaw: запускає або під’єднується до окремого екземпляра Chrome, керованого OmeniaClaw (ізольований каталог даних користувача).
• user: керує вашою наявною сесією Chrome із виконаним входом через Chrome DevTools MCP.
• спеціальні профілі CDP: вказують на локальну або віддалену кінцеву точку CDP.

OmeniaClaw browser profilesOmeniaClaw browser create-profile --name work --color "#FF5A36"OmeniaClaw browser create-profile --name chrome-live --driver existing-sessionOmeniaClaw browser create-profile --name remote --cdp-url https://browser-host.example.comOmeniaClaw browser delete-profile --name work

Використати конкретний профіль:

OmeniaClaw browser --browser-profile work tabs

Вкладки

OmeniaClaw browser tabsOmeniaClaw browser tab new --label docsOmeniaClaw browser tab label t1 docsOmeniaClaw browser tab select 2OmeniaClaw browser tab close 2OmeniaClaw browser open https://omeniaclaw.com --label docsOmeniaClaw browser focus docsOmeniaClaw browser close t1

tabs спочатку повертає suggestedTargetId, потім стабільний tabId, наприклад t1, необов’язкову мітку та сирий targetId. Агенти мають передавати suggestedTargetId назад у focus, close, знімки та дії. Ви можете призначити мітку за допомогою open --label, tab new --label або tab label; мітки, ідентифікатори вкладок, сирі ідентифікатори цілей і унікальні префікси target-id — усе це приймається. Коли Chromium замінює базову сиру ціль під час навігації або надсилання форми, OmeniaClaw зберігає стабільний tabId/мітку прив’язаними до вкладки-замінника, коли може довести збіг. Сирі ідентифікатори цілей залишаються нестабільними; віддавайте перевагу suggestedTargetId.

Знімок / скриншот / дії

Знімок:

OmeniaClaw browser snapshotOmeniaClaw browser snapshot --urls

Скриншот:

OmeniaClaw browser screenshotOmeniaClaw browser screenshot --full-pageOmeniaClaw browser screenshot --ref e12OmeniaClaw browser screenshot --labels

Примітки:

• --full-page призначений лише для захоплення сторінок; його не можна поєднувати з --ref або --element.
• Профілі existing-session / user підтримують скриншоти сторінок і скриншоти --ref з виводу знімка, але не скриншоти CSS --element.
• --labels накладає поточні посилання знімка на скриншот.
• snapshot --urls додає виявлені адреси посилань до AI-знімків, щоб агенти могли вибирати прямі цілі навігації замість того, щоб вгадувати лише за текстом посилання.

Navigate/click/type (автоматизація UI на основі ref):

OmeniaClaw browser navigate https://example.comOmeniaClaw browser click <ref>OmeniaClaw browser click-coords 120 340OmeniaClaw browser type <ref> "hello"OmeniaClaw browser press EnterOmeniaClaw browser hover <ref>OmeniaClaw browser scrollintoview <ref>OmeniaClaw browser drag <startRef> <endRef>OmeniaClaw browser select <ref> OptionA OptionBOmeniaClaw browser fill --fields '[{"ref":"1","value":"Ada"}]'OmeniaClaw browser wait --text "Done"OmeniaClaw browser evaluate --fn '(el) => el.textContent' --ref <ref>

Відповіді дій повертають поточний сирий targetId після заміни сторінки, спричиненої дією, коли OmeniaClaw може довести вкладку-замінник. Скрипти все одно мають зберігати й передавати suggestedTargetId/мітки для довготривалих робочих процесів.

Допоміжні команди для файлів і діалогів:

OmeniaClaw browser upload /tmp/OmeniaClaw/uploads/file.pdf --ref <ref>OmeniaClaw browser waitfordownloadOmeniaClaw browser download <ref> report.pdfOmeniaClaw browser dialog --accept

Керовані профілі Chrome зберігають звичайні завантаження, ініційовані кліком, до каталогу завантажень OmeniaClaw (типово /tmp/OmeniaClaw/downloads або налаштований тимчасовий корінь). Використовуйте waitfordownload або download, коли агенту потрібно дочекатися певного файлу та повернути його шлях; ці явні очікувачі беруть на себе наступне завантаження.

Стан і сховище

Viewport + емуляція:

OmeniaClaw browser resize 1280 720OmeniaClaw browser set viewport 1280 720OmeniaClaw browser set offline onOmeniaClaw browser set media darkOmeniaClaw browser set timezone Europe/LondonOmeniaClaw browser set locale en-GBOmeniaClaw browser set geo 51.5074 -0.1278 --accuracy 25OmeniaClaw browser set device "iPhone 14"OmeniaClaw browser set headers '{"x-test":"1"}'OmeniaClaw browser set credentials myuser mypass

Cookies + сховище:

OmeniaClaw browser cookiesOmeniaClaw browser cookies set session abc123 --url https://example.comOmeniaClaw browser cookies clearOmeniaClaw browser storage local getOmeniaClaw browser storage local set token abc123OmeniaClaw browser storage session clear

Налагодження

OmeniaClaw browser console --level errorOmeniaClaw browser pdfOmeniaClaw browser responsebody "**/api"OmeniaClaw browser highlight <ref>OmeniaClaw browser errors --clearOmeniaClaw browser requests --filter apiOmeniaClaw browser trace startOmeniaClaw browser trace stop --out trace.zip

Наявний Chrome через MCP

Використовуйте вбудований профіль user або створіть власний профіль existing-session:

OmeniaClaw browser --browser-profile user tabsOmeniaClaw browser create-profile --name chrome-live --driver existing-sessionOmeniaClaw browser create-profile --name brave-live --driver existing-session --user-data-dir "~/Library/Application Support/BraveSoftware/Brave-Browser"OmeniaClaw browser --browser-profile chrome-live tabs

Цей шлях працює лише на хості. Для Docker, headless-серверів, Browserless або інших віддалених конфігурацій використовуйте профіль CDP.

Поточні обмеження existing-session:

• дії на основі знімків використовують ref, а не CSS-селектори
• browser.actionTimeoutMs встановлює для підтримуваних запитів act типове значення 60000 мс, коли виклики не передають timeoutMs; значення timeoutMs для конкретного виклику все одно має пріоритет.
• click підтримує лише клік лівою кнопкою
• type не підтримує slowly=true
• press не підтримує delayMs
• hover, scrollintoview, drag, select, fill і evaluate відхиляють перевизначення тайм-ауту для окремого виклику
• select підтримує лише одне значення
• wait --load networkidle не підтримується
• завантаження файлів вимагає --ref / --input-ref, не підтримує CSS --element і наразі підтримує по одному файлу за раз
• хуки діалогів не підтримують --timeout
• скриншоти підтримують захоплення сторінок і --ref, але не CSS --element
• responsebody, перехоплення завантажень, експорт PDF і пакетні дії все ще вимагають керованого браузера або сирого профілю CDP

Віддалене керування браузером (проксі вузла-хоста)

Якщо Gateway працює на іншій машині, ніж браузер, запустіть вузол-хост на машині, де є Chrome/Brave/Edge/Chromium. Gateway проксуватиме дії браузера до цього вузла (окремий сервер керування браузером не потрібен).

Використовуйте gateway.nodes.browser.mode, щоб керувати автомаршрутизацією, і gateway.nodes.browser.node, щоб закріпити конкретний вузол, якщо під’єднано кілька вузлів.

Безпека й віддалене налаштування: інструмент Browser, віддалений доступ, Tailscale, безпека

Пов’язане

• Довідник CLI
• Browser