Documentation Index
Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
openclaw browser
Керуйте поверхнею керування браузером OpenClaw і виконуйте дії браузера (життєвий цикл, профілі, вкладки, знімки, скриншоти, навігація, введення, емуляція стану та налагодження).
Пов’язане:
- Інструмент Browser + API: інструмент Browser
Поширені прапорці
--url <gatewayWsUrl>: URL WebSocket Gateway (типово з конфігурації).--token <token>: токен Gateway (за потреби).--timeout <ms>: тайм-аут запиту (мс).--expect-final: чекати на фінальну відповідь Gateway.--browser-profile <name>: вибрати профіль браузера (типовий — із конфігурації).--json: машиночитаний вивід (де підтримується).
Швидкий старт (локально)
browser({ action: "doctor" }).
Швидке усунення несправностей
Якщоstart завершується помилкою not reachable after start, спочатку усуньте проблему з готовністю CDP. Якщо start і tabs успішні, але open або navigate завершується помилкою, площина керування браузером справна, а причина збою зазвичай полягає в політиці SSRF для навігації.
Мінімальна послідовність:
Життєвий цикл
doctor --deepдодає перевірку живого знімка. Це корисно, коли базова готовність CDP позначена як справна, але вам потрібне підтвердження, що поточну вкладку можна інспектувати.- Для профілів
attachOnlyі віддалених профілів CDP командаopenclaw browser stopзакриває активну сесію керування та скидає тимчасові перевизначення емуляції, навіть якщо OpenClaw не запускав процес браузера самостійно. - Для локальних керованих профілів
openclaw browser stopзупиняє запущений процес браузера. openclaw browser start --headlessзастосовується лише до цього запиту запуску й лише тоді, коли OpenClaw запускає локальний керований браузер. Це не переписуєbrowser.headlessабо конфігурацію профілю й не має ефекту для браузера, який уже працює.- На Linux-хостах без
DISPLAYабоWAYLAND_DISPLAYлокальні керовані профілі автоматично працюють у режимі headless, якщо лишеOPENCLAW_BROWSER_HEADLESS=0,browser.headless=falseабоbrowser.profiles.<name>.headless=falseявно не вимагає видимого браузера.
Якщо команда відсутня
Якщоopenclaw browser є невідомою командою, перевірте plugins.allow у
~/.openclaw/openclaw.json.
Коли plugins.allow присутній, явно перелічіть вбудований плагін браузера,
якщо лише конфігурація вже не містить кореневий блок browser:
browser, наприклад browser.enabled=true або
browser.profiles.<name>, також активує вбудований плагін браузера за
обмежувального allowlist плагінів.
Пов’язане: інструмент Browser
Профілі
Профілі — це іменовані конфігурації маршрутизації браузера. На практиці:openclaw: запускає або під’єднується до окремого екземпляра Chrome, керованого OpenClaw (ізольований каталог даних користувача).user: керує вашою наявною сесією Chrome із виконаним входом через Chrome DevTools MCP.- спеціальні профілі CDP: вказують на локальну або віддалену кінцеву точку CDP.
Вкладки
tabs спочатку повертає suggestedTargetId, потім стабільний tabId, наприклад t1,
необов’язкову мітку та сирий targetId. Агенти мають передавати
suggestedTargetId назад у focus, close, знімки та дії. Ви можете
призначити мітку за допомогою open --label, tab new --label або tab label; мітки,
ідентифікатори вкладок, сирі ідентифікатори цілей і унікальні префікси target-id — усе це приймається.
Коли Chromium замінює базову сиру ціль під час навігації або надсилання форми,
OpenClaw зберігає стабільний tabId/мітку прив’язаними до вкладки-замінника,
коли може довести збіг. Сирі ідентифікатори цілей залишаються нестабільними; віддавайте перевагу
suggestedTargetId.
Знімок / скриншот / дії
Знімок:--full-pageпризначений лише для захоплення сторінок; його не можна поєднувати з--refабо--element.- Профілі
existing-session/userпідтримують скриншоти сторінок і скриншоти--refз виводу знімка, але не скриншоти CSS--element. --labelsнакладає поточні посилання знімка на скриншот.snapshot --urlsдодає виявлені адреси посилань до AI-знімків, щоб агенти могли вибирати прямі цілі навігації замість того, щоб вгадувати лише за текстом посилання.
targetId після заміни сторінки, спричиненої дією,
коли OpenClaw може довести вкладку-замінник. Скрипти все одно мають
зберігати й передавати suggestedTargetId/мітки для довготривалих робочих процесів.
Допоміжні команди для файлів і діалогів:
/tmp/openclaw/downloads або налаштований тимчасовий
корінь). Використовуйте waitfordownload або download, коли агенту потрібно дочекатися
певного файлу та повернути його шлях; ці явні очікувачі беруть на себе наступне завантаження.
Стан і сховище
Viewport + емуляція:Налагодження
Наявний Chrome через MCP
Використовуйте вбудований профільuser або створіть власний профіль existing-session:
- дії на основі знімків використовують ref, а не CSS-селектори
browser.actionTimeoutMsвстановлює для підтримуваних запитівactтипове значення 60000 мс, коли виклики не передаютьtimeoutMs; значенняtimeoutMsдля конкретного виклику все одно має пріоритет.clickпідтримує лише клік лівою кнопкоюtypeне підтримуєslowly=truepressне підтримуєdelayMshover,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, безпека