openclaw browser

OpenClaw की ब्राउज़र नियंत्रण सतह प्रबंधित करें और ब्राउज़र क्रियाएं चलाएं (लाइफ़साइकल, प्रोफ़ाइल, टैब, स्नैपशॉट, स्क्रीनशॉट, नेविगेशन, इनपुट, स्थिति एम्युलेशन, और डिबगिंग).

संबंधित:

• ब्राउज़र टूल + API: ब्राउज़र टूल

सामान्य फ़्लैग

• --url <gatewayWsUrl>: Gateway WebSocket URL (कॉन्फ़िग पर डिफ़ॉल्ट).
• --token <token>: Gateway टोकन (यदि आवश्यक हो).
• --timeout <ms>: अनुरोध टाइमआउट (ms).
• --expect-final: अंतिम Gateway प्रतिक्रिया की प्रतीक्षा करें.
• --browser-profile <name>: ब्राउज़र प्रोफ़ाइल चुनें (कॉन्फ़िग से डिफ़ॉल्ट).
• --json: मशीन-पठनीय आउटपुट (जहां समर्थित हो).

त्वरित शुरुआत (लोकल)

openclaw browser profilesopenclaw browser --browser-profile openclaw startopenclaw browser --browser-profile openclaw open https://example.comopenclaw browser --browser-profile openclaw snapshot

एजेंट वही तैयारी जांच browser({ action: "doctor" }) से चला सकते हैं.

त्वरित समस्या-निवारण

यदि start not reachable after start के साथ विफल होता है, तो पहले CDP तैयारी की समस्या सुलझाएं. यदि start और tabs सफल होते हैं लेकिन open या navigate विफल होता है, तो ब्राउज़र नियंत्रण प्लेन स्वस्थ है और विफलता आम तौर पर नेविगेशन SSRF नीति होती है.

न्यूनतम क्रम:

openclaw browser --browser-profile openclaw doctoropenclaw browser --browser-profile openclaw startopenclaw browser --browser-profile openclaw tabsopenclaw browser --browser-profile openclaw open https://example.com

विस्तृत मार्गदर्शन: ब्राउज़र समस्या-निवारण

लाइफ़साइकल

openclaw browser statusopenclaw browser doctoropenclaw browser doctor --deepopenclaw browser startopenclaw browser start --headlessopenclaw browser stopopenclaw browser --browser-profile openclaw reset-profile

नोट:

• doctor --deep एक लाइव स्नैपशॉट जांच जोड़ता है. यह तब उपयोगी है जब मूल CDP तैयारी हरी हो लेकिन आप प्रमाण चाहते हों कि वर्तमान टैब का निरीक्षण किया जा सकता है.
• attachOnly और रिमोट CDP प्रोफ़ाइलों के लिए, openclaw browser stop सक्रिय नियंत्रण सत्र बंद करता है और अस्थायी एम्युलेशन ओवरराइड साफ़ करता है, तब भी जब OpenClaw ने ब्राउज़र प्रक्रिया स्वयं लॉन्च नहीं की हो.
• लोकल प्रबंधित प्रोफ़ाइलों के लिए, openclaw browser stop स्पॉन की गई ब्राउज़र प्रक्रिया रोकता है.
• openclaw browser start --headless केवल उसी स्टार्ट अनुरोध पर लागू होता है और केवल तब जब OpenClaw एक लोकल प्रबंधित ब्राउज़र लॉन्च करता है. यह browser.headless या प्रोफ़ाइल कॉन्फ़िग को फिर से नहीं लिखता, और पहले से चल रहे ब्राउज़र के लिए यह कोई कार्रवाई नहीं करता.
• Linux होस्ट पर DISPLAY या WAYLAND_DISPLAY के बिना, लोकल प्रबंधित प्रोफ़ाइल अपने आप हेडलेस चलती हैं जब तक OPENCLAW_BROWSER_HEADLESS=0, browser.headless=false, या browser.profiles.<name>.headless=false स्पष्ट रूप से दृश्य ब्राउज़र का अनुरोध न करे.

यदि कमांड अनुपलब्ध है

यदि openclaw browser अज्ञात कमांड है, तो ~/.openclaw/openclaw.json में plugins.allow जांचें.

जब plugins.allow मौजूद हो, तो बंडल किए गए ब्राउज़र Plugin को स्पष्ट रूप से सूचीबद्ध करें जब तक कॉन्फ़िग में पहले से रूट browser ब्लॉक न हो:

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

एक स्पष्ट रूट browser ब्लॉक, उदाहरण के लिए browser.enabled=true या browser.profiles.<name>, प्रतिबंधात्मक Plugin allowlist के तहत भी बंडल किए गए ब्राउज़र Plugin को सक्रिय करता है.

संबंधित: ब्राउज़र टूल

प्रोफ़ाइल

प्रोफ़ाइल नामित ब्राउज़र रूटिंग कॉन्फ़िग हैं. व्यवहार में:

• openclaw: समर्पित OpenClaw-प्रबंधित Chrome इंस्टेंस लॉन्च करता है या उससे जुड़ता है (अलग user data dir).
• user: Chrome DevTools MCP के माध्यम से आपके मौजूदा साइन-इन Chrome सत्र को नियंत्रित करता है.
• कस्टम CDP प्रोफ़ाइल: लोकल या रिमोट CDP एंडपॉइंट की ओर संकेत करती हैं.

openclaw browser profilesopenclaw browser create-profile --name work --color "#FF5A36"openclaw browser create-profile --name chrome-live --driver existing-sessionopenclaw browser create-profile --name remote --cdp-url https://browser-host.example.comopenclaw browser delete-profile --name work

किसी विशिष्ट प्रोफ़ाइल का उपयोग करें:

openclaw browser --browser-profile work tabs

टैब

openclaw browser tabsopenclaw browser tab new --label docsopenclaw browser tab label t1 docsopenclaw browser tab select 2openclaw browser tab close 2openclaw browser open https://docs.openclaw.ai --label docsopenclaw browser focus docsopenclaw browser close t1

tabs पहले suggestedTargetId लौटाता है, फिर स्थिर tabId जैसे t1, वैकल्पिक लेबल, और कच्चा targetId. एजेंट को suggestedTargetId को focus, close, स्नैपशॉट, और क्रियाओं में वापस पास करना चाहिए. आप open --label, tab new --label, या tab label से लेबल असाइन कर सकते हैं; लेबल, टैब आईडी, कच्ची टारगेट आईडी, और अद्वितीय टारगेट-आईडी प्रीफ़िक्स सभी स्वीकार किए जाते हैं. अनुकूलता के लिए अनुरोध फ़ील्ड का नाम अब भी targetId है, लेकिन यह इन टैब संदर्भों को स्वीकार करता है. कच्ची टारगेट आईडी को निदान हैंडल मानें, स्थायी एजेंट मेमोरी नहीं. जब Chromium नेविगेशन या फ़ॉर्म सबमिट के दौरान अंतर्निहित कच्चे टारगेट को बदलता है, OpenClaw स्थिर tabId/लेबल को बदले गए टैब से जोड़े रखता है जब वह मिलान प्रमाणित कर सके. कच्ची टारगेट आईडी अस्थिर रहती हैं; suggestedTargetId को प्राथमिकता दें.

स्नैपशॉट / स्क्रीनशॉट / क्रियाएं

स्नैपशॉट:

openclaw browser snapshotopenclaw browser snapshot --urls

स्क्रीनशॉट:

openclaw browser screenshotopenclaw browser screenshot --full-pageopenclaw browser screenshot --ref e12openclaw browser screenshot --labels

नोट:

• --full-page केवल पेज कैप्चर के लिए है; इसे --ref या --element के साथ संयोजित नहीं किया जा सकता.
• existing-session / user प्रोफ़ाइल पेज स्क्रीनशॉट और स्नैपशॉट आउटपुट से --ref स्क्रीनशॉट का समर्थन करती हैं, लेकिन CSS --element स्क्रीनशॉट का नहीं.
• --labels स्क्रीनशॉट पर वर्तमान स्नैपशॉट refs ओवरले करता है. Playwright-समर्थित प्रोफ़ाइलों पर, यह --full-page (पूर्ण-पृष्ठ लेबल ओवरले), --ref (ARIA ref द्वारा एलिमेंट-क्लिप लेबल ओवरले), और --element (CSS चयनकर्ता द्वारा एलिमेंट-क्लिप लेबल ओवरले) के साथ काम करता है; एलिमेंट-क्लिप मोड में, लेबल एलिमेंट के सापेक्ष प्रोजेक्ट किए जाते हैं. प्रतिक्रिया में प्रत्येक ref के बाउंडिंग बॉक्स के साथ एक annotations ऐरे भी शामिल होता है. प्रत्येक आइटम में ref, number, role, वैकल्पिक name, और box: {x, y, width, height} होता है; निर्देशांक कैप्चर की गई छवि के स्पेस में होते हैं (viewport / fullpage / element-relative). खाली होने पर फ़ील्ड छोड़ दिया जाता है. existing-session प्रोफ़ाइल पेज स्क्रीनशॉट पर chrome-mcp ओवरले रेंडर करती हैं लेकिन Playwright प्रोजेक्शन हेल्पर का उपयोग नहीं करतीं और annotations शामिल नहीं करतीं; वहां CSS --element स्क्रीनशॉट समर्थित नहीं हैं. Playwright या chrome-mcp के बिना, लेबल वाले स्क्रीनशॉट उपलब्ध नहीं हैं. पिछले रिलीज़ ने लेबल वाले Playwright स्क्रीनशॉट पर --full-page, --ref, और --element को अनदेखा किया और हमेशा viewport कैप्चर लौटाया; लेबल वाले स्क्रीनशॉट अब उन स्कोप का पालन करते हैं.
• snapshot --urls खोजे गए लिंक गंतव्यों को AI स्नैपशॉट में जोड़ता है ताकि एजेंट केवल लिंक टेक्स्ट से अनुमान लगाने के बजाय सीधे नेविगेशन लक्ष्य चुन सकें.

नेविगेट/क्लिक/टाइप (ref-आधारित UI ऑटोमेशन):

openclaw browser navigate https://example.comopenclaw browser click <ref>openclaw browser click-coords 120 340openclaw browser type <ref> "hello"openclaw browser press Enteropenclaw browser hover <ref>openclaw browser scrollintoview <ref>openclaw browser drag <startRef> <endRef>openclaw browser select <ref> OptionA OptionBopenclaw browser fill --fields '[{"ref":"1","value":"Ada"}]'openclaw browser wait --text "Done"openclaw browser evaluate --fn '(el) => el.textContent' --ref <ref>openclaw browser evaluate --fn 'const title = document.title; return title;'openclaw browser evaluate --timeout-ms 30000 --fn 'async () => { await window.ready; return true; }'

evaluate --fn एक फ़ंक्शन स्रोत, एक expression, या एक statement body स्वीकार करता है. Statement bodies को async functions के रूप में wrap किया जाता है, इसलिए जिस मान को आप वापस चाहते हैं उसके लिए return का उपयोग करें. जब पेज-साइड फ़ंक्शन को डिफ़ॉल्ट evaluate timeout से अधिक समय लग सकता है, तो evaluate --timeout-ms <ms> का उपयोग करें.

क्रिया प्रतिक्रियाएं क्रिया-ट्रिगर पेज बदलाव के बाद वर्तमान कच्चा targetId लौटाती हैं जब OpenClaw बदले गए टैब को प्रमाणित कर सके. लंबे समय तक चलने वाले वर्कफ़्लो के लिए स्क्रिप्ट को फिर भी suggestedTargetId/लेबल संग्रहित और पास करने चाहिए.

फ़ाइल + डायलॉग हेल्पर:

openclaw browser upload /tmp/openclaw/uploads/file.pdf --ref <ref>openclaw browser upload media://inbound/file.pdf --ref <ref>openclaw browser waitfordownloadopenclaw browser download <ref> report.pdfopenclaw browser dialog --acceptopenclaw browser dialog --dismiss --dialog-id d1

प्रबंधित Chrome प्रोफ़ाइल सामान्य क्लिक-ट्रिगर डाउनलोड को OpenClaw डाउनलोड डायरेक्टरी में सहेजती हैं (डिफ़ॉल्ट रूप से /tmp/openclaw/downloads, या कॉन्फ़िगर किया गया temp root). जब एजेंट को किसी विशिष्ट फ़ाइल की प्रतीक्षा करनी हो और उसका पथ लौटाना हो, तो waitfordownload या download का उपयोग करें; ये स्पष्ट प्रतीक्षक अगले डाउनलोड के स्वामी होते हैं. अपलोड OpenClaw temp uploads root और OpenClaw-प्रबंधित inbound media से फ़ाइलें स्वीकार करते हैं, जिनमें media://inbound/<id> और sandbox-relative media/inbound/<id> संदर्भ शामिल हैं. नेस्टेड media refs, traversal, और मनमाने लोकल पथ अस्वीकार ही रहते हैं. जब कोई क्रिया modal dialog खोलती है, तो क्रिया प्रतिक्रिया browserState.dialogs.pending के साथ blockedByDialog लौटाती है; उसे सीधे उत्तर देने के लिए --dialog-id पास करें. OpenClaw के बाहर संभाले गए डायलॉग browserState.dialogs.recent के अंतर्गत दिखाई देते हैं.

स्थिति और स्टोरेज

Viewport + एम्युलेशन:

openclaw browser resize 1280 720openclaw browser set viewport 1280 720openclaw browser set offline onopenclaw browser set media darkopenclaw browser set timezone Europe/Londonopenclaw browser set locale en-GBopenclaw browser set geo 51.5074 -0.1278 --accuracy 25openclaw browser set device "iPhone 14"openclaw browser set headers '{"x-test":"1"}'openclaw browser set credentials myuser mypass

कुकीज़ + स्टोरेज:

openclaw browser cookiesopenclaw browser cookies set session abc123 --url https://example.comopenclaw browser cookies clearopenclaw browser storage local getopenclaw browser storage local set token abc123openclaw browser storage session clear

डिबगिंग

openclaw browser console --level erroropenclaw browser pdfopenclaw browser responsebody "**/api"openclaw browser highlight <ref>openclaw browser errors --clearopenclaw browser requests --filter apiopenclaw browser trace startopenclaw browser trace stop --out trace.zip

MCP के माध्यम से मौजूदा Chrome

बिल्ट-इन user प्रोफ़ाइल का उपयोग करें, या अपनी existing-session प्रोफ़ाइल बनाएं:

openclaw browser --browser-profile user tabsopenclaw browser create-profile --name chrome-live --driver existing-sessionopenclaw browser create-profile --name brave-live --driver existing-session --user-data-dir "~/Library/Application Support/BraveSoftware/Brave-Browser"openclaw browser create-profile --name chrome-port --driver existing-session --cdp-url http://127.0.0.1:9222openclaw browser --browser-profile chrome-live tabs

डिफ़ॉल्ट existing-session पथ host-only Chrome MCP auto-connect है. यदि ब्राउज़र पहले से DevTools एंडपॉइंट के साथ चल रहा है, तो --cdp-url पास करें ताकि Chrome MCP उस एंडपॉइंट से जुड़ जाए. Docker, Browserless, या अन्य रिमोट सेटअप के लिए जहां Chrome MCP semantics की आवश्यकता नहीं है, CDP प्रोफ़ाइल का उपयोग करें.

वर्तमान existing-session सीमाएं:

• स्नैपशॉट-चालित क्रियाएँ CSS चयनकर्ताओं के बजाय refs का उपयोग करती हैं
• browser.actionTimeoutMs समर्थित act अनुरोधों के लिए डिफ़ॉल्ट रूप से 60000 ms होता है जब कॉलर timeoutMs छोड़ देते हैं; प्रति-कॉल timeoutMs फिर भी प्राथमिकता लेता है।
• click केवल लेफ़्ट-क्लिक है
• type slowly=true का समर्थन नहीं करता
• press delayMs का समर्थन नहीं करता
• hover, scrollintoview, drag, select, fill, और evaluate प्रति-कॉल टाइमआउट ओवरराइड अस्वीकार करते हैं
• select केवल एक मान का समर्थन करता है
• मौजूदा-सत्र प्रोफ़ाइलों पर wait --load networkidle समर्थित नहीं है (प्रबंधित और raw/remote CDP पर काम करता है)
• फ़ाइल अपलोड के लिए --ref / --input-ref आवश्यक है, CSS --element का समर्थन नहीं करते, और अभी एक बार में एक फ़ाइल का समर्थन करते हैं
• डायलॉग हुक --timeout का समर्थन नहीं करते
• स्क्रीनशॉट पेज कैप्चर और --ref का समर्थन करते हैं, लेकिन CSS --element का नहीं
• responsebody, डाउनलोड इंटरसेप्शन, PDF निर्यात, और बैच क्रियाओं के लिए अब भी प्रबंधित ब्राउज़र या raw CDP प्रोफ़ाइल आवश्यक है

रिमोट ब्राउज़र नियंत्रण (node होस्ट प्रॉक्सी)

यदि Gateway ब्राउज़र से अलग मशीन पर चलता है, तो उस मशीन पर एक node होस्ट चलाएँ जिसमें Chrome/Brave/Edge/Chromium है। Gateway ब्राउज़र क्रियाओं को उस node पर प्रॉक्सी करेगा (अलग ब्राउज़र नियंत्रण सर्वर की आवश्यकता नहीं है)।

ऑटो-रूटिंग नियंत्रित करने के लिए gateway.nodes.browser.mode का उपयोग करें और यदि कई node जुड़े हैं तो किसी विशिष्ट node को पिन करने के लिए gateway.nodes.browser.node का उपयोग करें।

सुरक्षा + रिमोट सेटअप: ब्राउज़र टूल, रिमोट एक्सेस, Tailscale, सुरक्षा

संबंधित

• CLI संदर्भ
• ब्राउज़र