ब्राउज़र (OpenClaw-प्रबंधित)

• इसे एक अलग, केवल-एजेंट ब्राउज़र समझें। openclaw प्रोफ़ाइल कभी भी आपकी निजी ब्राउज़र प्रोफ़ाइल को नहीं छूती।
• एजेंट इस पृथक माध्यम में टैब खोलता है, पृष्ठ पढ़ता है, क्लिक करता है और टाइप करता है।
• इसके बजाय, अंतर्निहित user प्रोफ़ाइल Chrome DevTools MCP के माध्यम से आपके वास्तविक साइन-इन किए गए Chrome सत्र से जुड़ती है।

​

आपको क्या मिलता है

• openclaw नामक एक अलग ब्राउज़र प्रोफ़ाइल (डिफ़ॉल्ट रूप से नारंगी रंग)।
• नियतात्मक टैब नियंत्रण (सूचीबद्ध करना/खोलना/फ़ोकस करना/बंद करना)।
• एजेंट क्रियाएँ (क्लिक/टाइप/ड्रैग/चयन), स्नैपशॉट, स्क्रीनशॉट, PDF।
• Playwright-समर्थित प्रोफ़ाइल प्रत्यक्ष अटैचमेंट नेविगेशन को प्रबंधित डाउनलोड डायरेक्टरी में सहेजती हैं और अंतिम-URL नीति सत्यापन के बाद { url, suggestedFilename, path } मेटाडेटा लौटाती हैं।
• जब कोई क्रिया तुरंत एक या अधिक डाउनलोड शुरू करती है, तो Playwright-समर्थित एजेंट क्रियाएँ उसी प्रबंधित मेटाडेटा वाली downloads सरणी लौटाती हैं।
• एक बंडल किया गया browser-automation skill, जो ब्राउज़र plugin सक्षम होने पर एजेंटों को स्नैपशॉट, स्थिर-टैब, पुराने-संदर्भ और मैन्युअल-अवरोधक पुनर्प्राप्ति लूप सिखाता है।
• वैकल्पिक बहु-प्रोफ़ाइल समर्थन (openclaw, work, remote, …)।

​

त्वरित शुरुआत

openclaw browser --browser-profile openclaw doctor
openclaw browser --browser-profile openclaw doctor --deep
openclaw browser --browser-profile openclaw status
openclaw browser --browser-profile openclaw start
openclaw browser --browser-profile openclaw open https://example.com
openclaw browser --browser-profile openclaw snapshot

​

Plugin नियंत्रण

{
  plugins: {
    entries: {
      browser: {
        enabled: false,
      },
    },
  },
}

​

एजेंट मार्गदर्शन

{
  tools: {
    profile: "coding",
    alsoAllow: ["browser"],
  },
}

• browser टूल का विवरण संक्षिप्त, हमेशा-सक्रिय अनुबंध प्रदान करता है: सही प्रोफ़ाइल चुनें, संदर्भों को उसी टैब पर रखें, टैब को लक्षित करने के लिए tabId/लेबल का उपयोग करें और बहु-चरणीय कार्य के लिए ब्राउज़र skill लोड करें।
• बंडल किया गया browser-automation skill अधिक विस्तृत संचालन लूप प्रदान करता है: पहले स्थिति/टैब जाँचें, कार्य टैब को लेबल करें, क्रिया से पहले स्नैपशॉट लें, UI परिवर्तन के बाद फिर स्नैपशॉट लें, पुराने संदर्भों से एक बार पुनर्प्राप्ति करें और अनुमान लगाने के बजाय लॉगिन/2FA/captcha या कैमरा/माइक्रोफ़ोन अवरोधकों को मैन्युअल क्रिया के रूप में रिपोर्ट करें।

​

ब्राउज़र कमांड या टूल अनुपस्थित है

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

​

प्रोफ़ाइल: openclaw, user, chrome

• openclaw: प्रबंधित, पृथक ब्राउज़र (किसी एक्सटेंशन की आवश्यकता नहीं)।
• user: आपके वास्तविक साइन-इन किए गए Chrome सत्र के लिए अंतर्निहित Chrome DevTools MCP अटैच प्रोफ़ाइल। OpenClaw के पहली बार जुड़ने पर Chrome अवरोधक “Allow remote debugging?” प्रॉम्प्ट दिखाता है, इसलिए किसी व्यक्ति का कंप्यूटर के पास होना आवश्यक है।
• chrome: आपके वास्तविक साइन-इन किए गए Chrome सत्र के लिए अंतर्निहित Chrome एक्सटेंशन प्रोफ़ाइल। यह फ़ोन से तब भी काम करता है जब डेस्क पर कोई न हो, क्योंकि यह रिमोट-डीबगिंग पोर्ट के बजाय OpenClaw ब्राउज़र एक्सटेंशन के माध्यम से टैब संचालित करता है, इसलिए “Allow remote debugging?” प्रॉम्प्ट नहीं आता।

• डिफ़ॉल्ट: पृथक openclaw ब्राउज़र का उपयोग करें।
• जब मौजूदा लॉग-इन सत्र महत्वपूर्ण हों और उपयोगकर्ता कंप्यूटर से दूर हो (Telegram, WhatsApp आदि), तो profile="chrome" (एक्सटेंशन) को प्राथमिकता दें।
• जब मौजूदा लॉग-इन सत्र महत्वपूर्ण हों और उपयोगकर्ता अटैच प्रॉम्प्ट को स्वीकृति देने के लिए कंप्यूटर पर हो, तो profile="user" (Chrome MCP) को प्राथमिकता दें।
• जब आप कोई विशिष्ट ब्राउज़र मोड चाहते हैं, तो profile स्पष्ट ओवरराइड है।

​

कॉन्फ़िगरेशन

{
  browser: {
    enabled: true, // डिफ़ॉल्ट: true
    evaluateEnabled: true, // डिफ़ॉल्ट: true; false act:evaluate (मनमाना JS) को अक्षम करता है
    ssrfPolicy: {
      // dangerouslyAllowPrivateNetwork: true, // केवल विश्वसनीय निजी-नेटवर्क पहुँच के लिए स्वेच्छा से सक्षम करें
      // hostnameAllowlist: ["*.example.com", "example.com"],
      // allowedHostnames: ["localhost"],
    },
    // cdpUrl: "http://127.0.0.1:18792", // पुराना एकल-प्रोफ़ाइल ओवरराइड
    tabCleanup: {
      enabled: true, // डिफ़ॉल्ट: true
    },
    // snapshotDefaults: { mode: "efficient" }, // कॉलर द्वारा मोड न दिए जाने पर डिफ़ॉल्ट स्नैपशॉट मोड
    defaultProfile: "openclaw",
    color: "#FF4500",
    headless: false,
    noSandbox: false,
    attachOnly: false,
    executablePath: "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser",
    profiles: {
      openclaw: { cdpPort: 18800, color: "#FF4500" },
      work: {
        cdpPort: 18801,
        color: "#0066CC",
        headless: true,
        executablePath: "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
      },
      user: {
        driver: "existing-session",
        attachOnly: true,
        color: "#00AA00",
      },
      brave: {
        driver: "existing-session",
        attachOnly: true,
        userDataDir: "~/Library/Application Support/BraveSoftware/Brave-Browser",
        color: "#FB542B",
      },
      remote: { cdpUrl: "http://10.0.0.42:9222", color: "#00AA00" },
    },
  },
}

​

टैब सफ़ाई का स्वामित्व

​

स्क्रीनशॉट विज़न (केवल-पाठ मॉडल समर्थन)

{
  tools: {
    media: {
      image: {
        models: [
          { provider: "bytedance", model: "doubao-seed-2.0-pro" },
          // फ़ॉलबैक उम्मीदवार जोड़ें; पहली सफलता स्वीकार की जाती है
          { provider: "openai", model: "gpt-4o" },
        ],
      },
      // छवि समर्थन के लिए टैग किए जाने पर साझा मीडिया मॉडल भी काम करते हैं।
      // models: [{ provider: "openai", model: "gpt-4o", capabilities: ["image"] }],
    },
  },
  agents: {
    defaults: {
      // मौजूदा छवि-मॉडल डिफ़ॉल्ट का भी पालन किया जाता है।
      // imageModel: { primary: "openai/gpt-4o" },
    },
  },
}

1. एजेंट browser screenshot को कॉल करता है और हमेशा की तरह एक छवि डिस्क पर कैप्चर की जाती है।
2. ब्राउज़र टूल मौजूदा छवि-समझ रनटाइम से पूछता है कि क्या वह कॉन्फ़िगर किए गए मीडिया छवि मॉडल, साझा मीडिया मॉडल, छवि-मॉडल डिफ़ॉल्ट या प्रमाणीकरण-समर्थित छवि प्रदाता का उपयोग करके स्क्रीनशॉट का वर्णन कर सकता है।
3. विज़न मॉडल एक टेक्स्ट विवरण लौटाता है, जिसे wrapExternalContent (प्रॉम्प्ट इंजेक्शन सुरक्षा) से रैप करके एजेंट को छवि ब्लॉक के बजाय टेक्स्ट ब्लॉक के रूप में लौटाया जाता है।
4. यदि छवि-समझ अनुपलब्ध हो, छोड़ दी जाए या विफल हो जाए, तो ब्राउज़र मूल छवि ब्लॉक लौटाने पर वापस आ जाता है।

​

Brave या किसी अन्य Chromium-आधारित ब्राउज़र का उपयोग करें

openclaw config set browser.executablePath "/usr/bin/google-chrome"
openclaw config set browser.profiles.work.executablePath "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"

{
  browser: {
    executablePath: "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser",
  },
}

{
  browser: {
    executablePath: "C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe",
  },
}

{
  browser: {
    executablePath: "/usr/bin/brave-browser",
  },
}

​

स्थानीय बनाम रिमोट नियंत्रण

• स्थानीय नियंत्रण (डिफ़ॉल्ट): Gateway लूपबैक नियंत्रण सेवा शुरू करता है और स्थानीय ब्राउज़र लॉन्च कर सकता है।
• रिमोट नियंत्रण (Node होस्ट): जिस मशीन पर ब्राउज़र है, उस पर Node होस्ट चलाएँ; Gateway ब्राउज़र कार्रवाइयों को उसके पास प्रॉक्सी करता है।
• रिमोट CDP: रिमोट Chromium-आधारित ब्राउज़र से संलग्न होने के लिए browser.profiles.<name>.cdpUrl (या browser.cdpUrl) सेट करें। इस स्थिति में OpenClaw स्थानीय ब्राउज़र लॉन्च नहीं करेगा।
• लूपबैक पर बाहरी रूप से प्रबंधित CDP सेवाओं (उदाहरण के लिए, Docker में 127.0.0.1 पर प्रकाशित Browserless) के लिए attachOnly: true भी सेट करें। attachOnly के बिना लूपबैक CDP को स्थानीय OpenClaw-प्रबंधित ब्राउज़र प्रोफ़ाइल माना जाता है।
• headless केवल उन स्थानीय प्रबंधित प्रोफ़ाइल को प्रभावित करता है जिन्हें OpenClaw लॉन्च करता है। यह मौजूदा-सत्र या रिमोट CDP ब्राउज़र को पुनः आरंभ या परिवर्तित नहीं करता।
• executablePath भी उसी स्थानीय प्रबंधित प्रोफ़ाइल नियम का पालन करता है। चल रही स्थानीय प्रबंधित प्रोफ़ाइल पर इसे बदलने से वह प्रोफ़ाइल पुनः आरंभ/समायोजन के लिए चिह्नित हो जाती है, ताकि अगला लॉन्च नए बाइनरी का उपयोग करे।

• स्थानीय प्रबंधित प्रोफ़ाइल: openclaw browser stop उस ब्राउज़र प्रक्रिया को रोकता है जिसे OpenClaw ने लॉन्च किया था
• केवल-संलग्न और रिमोट CDP प्रोफ़ाइल: openclaw browser stop सक्रिय नियंत्रण सत्र को बंद करता है और Playwright/CDP अनुकरण ओवरराइड (व्यूपोर्ट, रंग योजना, लोकेल, समय क्षेत्र, ऑफ़लाइन मोड और इसी तरह की स्थिति) मुक्त करता है, भले ही OpenClaw ने कोई ब्राउज़र प्रक्रिया लॉन्च न की हो

• क्वेरी टोकन (उदाहरण के लिए, https://provider.example?token=<token>)
• HTTP बेसिक प्रमाणीकरण (उदाहरण के लिए, https://user:pass@provider.example)

​

Node ब्राउज़र प्रॉक्सी (शून्य-कॉन्फ़िगरेशन डिफ़ॉल्ट)

• Node होस्ट एक प्रॉक्सी कमांड के माध्यम से अपना स्थानीय ब्राउज़र नियंत्रण सर्वर उपलब्ध कराता है।
• प्रोफ़ाइल Node के अपने browser.profiles कॉन्फ़िगरेशन (स्थानीय के समान) से आती हैं।
• allowProfiles चाहे जो भी हो, प्रॉक्सी कमांड कभी भी स्थायी प्रोफ़ाइल परिवर्तन (create-profile, delete-profile, reset-profile) की अनुमति नहीं देता; ये परिवर्तन सीधे Node पर करें।
• nodeHost.browserProxy.allowProfiles वैकल्पिक है। पुराने/डिफ़ॉल्ट व्यवहार के लिए इसे खाली छोड़ें: सभी कॉन्फ़िगर की गई प्रोफ़ाइल प्रॉक्सी के माध्यम से पहुँच योग्य बनी रहती हैं।
• यदि आप nodeHost.browserProxy.allowProfiles सेट करते हैं, तो OpenClaw इसे न्यूनतम-विशेषाधिकार सीमा मानता है, जो यह सीमित करती है कि प्रॉक्सी किन प्रोफ़ाइल नामों को लक्षित करेगा।
• यदि आप इसे नहीं चाहते, तो अक्षम करें:
  • Node पर: nodeHost.browserProxy.enabled=false
  • Gateway पर: gateway.nodes.browser.mode="off" (कनेक्ट किए गए किसी एक ब्राउज़र Node को चुनने के लिए "auto" या स्पष्ट Node पैरामीटर आवश्यक बनाने के लिए "manual" भी स्वीकार करता है)

​

Browserless (होस्टेड रिमोट CDP)

{
  browser: {
    enabled: true,
    defaultProfile: "browserless",
    profiles: {
      browserless: {
        cdpUrl: "wss://production-sfo.browserless.io?token=<BROWSERLESS_API_KEY>",
        color: "#00AA00",
      },
    },
  },
}

• <BROWSERLESS_API_KEY> को अपने वास्तविक Browserless टोकन से बदलें।
• वह क्षेत्रीय एंडपॉइंट चुनें जो आपके Browserless खाते से मेल खाता हो (उनके दस्तावेज़ देखें)।
• यदि Browserless आपको HTTPS बेस URL देता है, तो आप सीधे CDP कनेक्शन के लिए उसे wss:// में बदल सकते हैं या HTTPS URL को बनाए रख सकते हैं और OpenClaw को /json/version खोजने दे सकते हैं।

​

उसी होस्ट पर Browserless Docker

{
  browser: {
    enabled: true,
    defaultProfile: "browserless",
    profiles: {
      browserless: {
        cdpUrl: "ws://127.0.0.1:3000",
        attachOnly: true,
        color: "#00AA00",
      },
    },
  },
}

​

सीधे WebSocket CDP प्रदाता

• HTTP(S) खोज - http://host[:port] या https://host[:port]। OpenClaw, WebSocket डीबगर URL खोजने के लिए /json/version को कॉल करता है और फिर कनेक्ट करता है। कोई WebSocket फ़ॉलबैक नहीं।
• सीधे WebSocket एंडपॉइंट - ws://host[:port]/devtools/<kind>/<id> या wss://..., जिनमें /devtools/browser|page|worker|shared_worker|service_worker/<id> पथ हो। OpenClaw सीधे WebSocket हैंडशेक के माध्यम से कनेक्ट करता है और /json/version को पूरी तरह छोड़ देता है।
• साधारण WebSocket रूट - ws://host[:port] या wss://host[:port], जिनमें कोई /devtools/... पथ न हो (उदाहरण: Browserless, Browserbase)। OpenClaw पहले HTTP /json/version खोज का प्रयास करता है (स्कीम को http/https में सामान्यीकृत करके); यदि खोज कोई webSocketDebuggerUrl लौटाती है, तो उसका उपयोग किया जाता है, अन्यथा OpenClaw साधारण रूट पर सीधे WebSocket हैंडशेक का फ़ॉलबैक उपयोग करता है। यदि विज्ञापित WebSocket एंडपॉइंट CDP हैंडशेक को अस्वीकार करता है, लेकिन कॉन्फ़िगर किया गया साधारण रूट उसे स्वीकार करता है, तो OpenClaw उस रूट का भी फ़ॉलबैक उपयोग करता है। इससे स्थानीय Chrome की ओर इंगित साधारण ws:// भी कनेक्ट हो सकता है, क्योंकि Chrome केवल /json/version से प्राप्त विशिष्ट प्रति-लक्ष्य पथ पर WebSocket अपग्रेड स्वीकार करता है, जबकि होस्टेड प्रदाता तब भी अपने रूट WebSocket एंडपॉइंट का उपयोग कर सकते हैं, जब उनका खोज एंडपॉइंट ऐसा अल्पकालिक URL विज्ञापित करता है जो Playwright CDP के लिए उपयुक्त नहीं है।

​

Browserbase

{
  browser: {
    enabled: true,
    defaultProfile: "browserbase",
    profiles: {
      browserbase: {
        cdpUrl: "wss://connect.browserbase.com?apiKey=<BROWSERBASE_API_KEY>",
        color: "#F97316",
      },
    },
  },
}

• साइन अप करें और Overview dashboard से अपनी API Key कॉपी करें।
• <BROWSERBASE_API_KEY> को अपनी वास्तविक Browserbase API कुंजी से बदलें।
• Browserbase, WebSocket कनेक्शन पर स्वचालित रूप से ब्राउज़र सत्र बनाता है, इसलिए मैन्युअल सत्र निर्माण चरण की आवश्यकता नहीं है।
• वर्तमान निःशुल्क-स्तर सीमाओं और सशुल्क योजनाओं के लिए मूल्य निर्धारण देखें।
• संपूर्ण API संदर्भ, SDK मार्गदर्शिकाओं और एकीकरण उदाहरणों के लिए Browserbase दस्तावेज़ देखें।

​

Notte

{
  browser: {
    enabled: true,
    defaultProfile: "notte",
    profiles: {
      notte: {
        cdpUrl: "wss://us-prod.notte.cc/sessions/connect?token=<NOTTE_API_KEY>",
        color: "#7C3AED",
      },
    },
  },
}

• साइन अप करें और कंसोल सेटिंग्स पृष्ठ से अपनी API Key कॉपी करें।
• <NOTTE_API_KEY> को अपनी वास्तविक Notte API कुंजी से बदलें।
• Notte, WebSocket कनेक्शन पर स्वचालित रूप से ब्राउज़र सत्र बनाता है, इसलिए मैन्युअल सत्र निर्माण चरण की आवश्यकता नहीं है। WebSocket डिस्कनेक्ट होने पर सत्र नष्ट हो जाता है।
• वर्तमान निःशुल्क-स्तर सीमाओं और सशुल्क योजनाओं के लिए मूल्य निर्धारण देखें।
• संपूर्ण API संदर्भ, SDK मार्गदर्शिकाओं और एकीकरण उदाहरणों के लिए Notte दस्तावेज़ देखें।

​

सुरक्षा

• ब्राउज़र नियंत्रण केवल लूपबैक तक सीमित है; पहुँच Gateway के प्रमाणीकरण या Node पेयरिंग से होकर जाती है।
• स्टैंडअलोन लूपबैक ब्राउज़र HTTP API केवल साझा-सीक्रेट प्रमाणीकरण का उपयोग करता है: Gateway टोकन बेयरर प्रमाणीकरण, x-openclaw-password, या कॉन्फ़िगर किए गए Gateway पासवर्ड के साथ HTTP Basic प्रमाणीकरण।
• Tailscale Serve पहचान हेडर और gateway.auth.mode: "trusted-proxy" इस स्टैंडअलोन लूपबैक ब्राउज़र API को प्रमाणित नहीं करते।
• यदि ब्राउज़र नियंत्रण सक्षम है और कोई साझा-सीक्रेट प्रमाणीकरण कॉन्फ़िगर नहीं है, तो OpenClaw स्टार्टअप पर ब्राउज़र-नियंत्रण क्रेडेंशियल स्वचालित रूप से बनाकर सुरक्षित रखता है: जब gateway.auth.mode, none हो तब एक टोकन, या जब वह trusted-proxy हो तब एक पासवर्ड (gateway.auth.password के माध्यम से सुरक्षित रखा जाता है ताकि प्रक्रिया से बाहर के लूपबैक क्लाइंट उसे प्राप्त कर सकें)। जब उस मोड के लिए स्पष्ट स्ट्रिंग क्रेडेंशियल पहले से कॉन्फ़िगर हो, या जब gateway.auth.mode, password हो, तो स्वचालित निर्माण छोड़ दिया जाता है।
• यदि आप बनाए गए सीक्रेट के बजाय अपने नियंत्रण वाला स्थिर सीक्रेट चाहते हैं, तो gateway.auth.token, gateway.auth.password, OPENCLAW_GATEWAY_TOKEN, या OPENCLAW_GATEWAY_PASSWORD को स्पष्ट रूप से कॉन्फ़िगर करें।

• जहाँ संभव हो, एन्क्रिप्टेड एंडपॉइंट (HTTPS या WSS) और अल्पकालिक टोकन को प्राथमिकता दें।
• दीर्घकालिक टोकन को सीधे कॉन्फ़िगरेशन फ़ाइलों में एम्बेड करने से बचें।
• Gateway और सभी Node होस्ट को निजी नेटवर्क (Tailscale) पर रखें; सार्वजनिक रूप से उपलब्ध कराने से बचें।
• रिमोट CDP URL/टोकन को सीक्रेट मानें; पर्यावरण चर या सीक्रेट मैनेजर को प्राथमिकता दें।

​

प्रोफ़ाइल (एकाधिक ब्राउज़र)

• OpenClaw-प्रबंधित: अपनी उपयोगकर्ता डेटा डायरेक्टरी + CDP पोर्ट वाला एक समर्पित Chromium-आधारित ब्राउज़र इंस्टेंस
• रिमोट: एक स्पष्ट CDP URL (कहीं और चल रहा Chromium-आधारित ब्राउज़र)
• मौजूदा सत्र: Chrome DevTools MCP के स्वचालित कनेक्शन के माध्यम से आपकी मौजूदा Chrome प्रोफ़ाइल

• यदि openclaw प्रोफ़ाइल मौजूद नहीं है, तो वह स्वचालित रूप से बनाई जाती है।
• user प्रोफ़ाइल Chrome MCP मौजूदा-सत्र अटैच के लिए अंतर्निहित है।
• user के अतिरिक्त मौजूदा-सत्र प्रोफ़ाइल वैकल्पिक होती हैं; उन्हें --driver existing-session से बनाएँ।
• स्थानीय CDP पोर्ट डिफ़ॉल्ट रूप से 18800-18899 से आवंटित होते हैं।
• किसी प्रोफ़ाइल को हटाने पर उसकी स्थानीय डेटा डायरेक्टरी Trash में चली जाती है।

​

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

• Chrome for Developers: अपने ब्राउज़र सत्र के साथ Chrome DevTools MCP का उपयोग करें
• Chrome DevTools MCP README

{
  browser: {
    profiles: {
      brave: {
        driver: "existing-session",
        attachOnly: true,
        userDataDir: "~/Library/Application Support/BraveSoftware/Brave-Browser",
        color: "#FB542B",
      },
    },
  },
}

1. रिमोट डीबगिंग के लिए उस ब्राउज़र का निरीक्षण पृष्ठ खोलें।
2. रिमोट डीबगिंग सक्षम करें।
3. ब्राउज़र को चालू रखें और OpenClaw के जुड़ने पर कनेक्शन संकेत को स्वीकृति दें।

• Chrome: chrome://inspect/#remote-debugging
• Brave: brave://inspect/#remote-debugging
• Edge: edge://inspect/#remote-debugging

openclaw browser --browser-profile user start
openclaw browser --browser-profile user status
openclaw browser --browser-profile user tabs
openclaw browser --browser-profile user snapshot --format ai

• status driver: existing-session दिखाता है
• status transport: chrome-mcp दिखाता है
• status running: true दिखाता है
• tabs आपके पहले से खुले ब्राउज़र टैब सूचीबद्ध करता है
• snapshot चयनित लाइव टैब से रेफ़रेंस लौटाता है

• लक्षित Chromium-आधारित ब्राउज़र का संस्करण 144+ है
• उस ब्राउज़र के निरीक्षण पृष्ठ में रिमोट डीबगिंग सक्षम है
• ब्राउज़र ने अटैच सहमति प्रॉम्प्ट दिखाया और आपने उसे स्वीकार किया
• यदि Chrome को स्पष्ट --remote-debugging-port के साथ शुरू किया गया था, तो Chrome MCP ऑटो-कनेक्ट पर निर्भर रहने के बजाय browser.profiles.<name>.cdpUrl को उस DevTools एंडपॉइंट पर सेट करें
• openclaw doctor पुराने एक्सटेंशन-आधारित ब्राउज़र कॉन्फ़िगरेशन को माइग्रेट करता है और जाँचता है कि डिफ़ॉल्ट ऑटो-कनेक्ट प्रोफ़ाइल के लिए Chrome स्थानीय रूप से इंस्टॉल है, लेकिन यह आपके लिए ब्राउज़र-साइड रिमोट डीबगिंग सक्षम नहीं कर सकता

• जब आपको उपयोगकर्ता के लॉग-इन ब्राउज़र की स्थिति चाहिए, तो profile="user" का उपयोग करें।
• यदि आप कस्टम मौजूदा-सत्र प्रोफ़ाइल का उपयोग करते हैं, तो उस स्पष्ट प्रोफ़ाइल नाम को पास करें।
• यह मोड केवल तभी चुनें, जब उपयोगकर्ता अटैच प्रॉम्प्ट को स्वीकृति देने के लिए कंप्यूटर पर मौजूद हो।
• Gateway या Node होस्ट npx chrome-devtools-mcp@latest --autoConnect को शुरू कर सकता है।

• यह पथ पृथक openclaw प्रोफ़ाइल की तुलना में अधिक जोखिम वाला है, क्योंकि यह आपके साइन-इन ब्राउज़र सत्र के भीतर कार्रवाई कर सकता है।
• OpenClaw इस ड्राइवर के लिए ब्राउज़र लॉन्च नहीं करता; यह केवल अटैच करता है।
• OpenClaw यहाँ आधिकारिक Chrome DevTools MCP --autoConnect प्रवाह का उपयोग करता है। यदि userDataDir सेट है, तो उस उपयोगकर्ता डेटा डायरेक्टरी को लक्षित करने के लिए उसे आगे पास किया जाता है।
• मौजूदा-सत्र चयनित होस्ट पर या कनेक्टेड ब्राउज़र Node के माध्यम से अटैच कर सकता है। यदि Chrome कहीं और मौजूद है और कोई ब्राउज़र Node कनेक्टेड नहीं है, तो इसके बजाय रिमोट CDP या Node होस्ट का उपयोग करें।
• Chrome MCP लक्ष्य और स्नैपशॉट रेफ़रेंस एक MCP सबप्रोसेस तक सीमित होते हैं। उस प्रक्रिया के पुनः शुरू होने के बाद, browser tabs को फिर से चलाएँ, लक्ष्य-विशिष्ट कार्य से पहले स्पष्ट रूप से नया लक्ष्य चुनें और रेफ़रेंस का उपयोग करने से पहले नया स्नैपशॉट लें। प्रत्येक रेफ़रेंस केवल अपने लक्ष्य और नवीनतम स्नैपशॉट के लिए मान्य है। पुराने उपनाम प्रतिस्थापन टैब में स्थानांतरित नहीं किए जाते, भले ही उसका URL मेल खाता हो।
• Chrome DevTools MCP वर्तमान में पृष्ठ टूल को प्रक्रिया-स्थानीय संख्यात्मक पृष्ठ ID के अनुसार रूट करता है। प्रक्रिया-सीमित हैंडल सबप्रोसेस प्रतिस्थापन के दौरान पुनः उपयोग रोकते हैं, लेकिन पास-पास की टूल कॉल के बीच प्रक्रिया के भीतर ब्राउज़र-कॉन्टेक्स्ट प्रतिस्थापन अब भी किसी कार्रवाई को दोबारा लक्षित कर सकता है। पूरी तरह परमाण्विक रूटिंग के लिए स्थिर लक्ष्य ID हेतु अपस्ट्रीम पृष्ठ-टूल समर्थन आवश्यक है।

​

कस्टम Chrome MCP लॉन्च

• http(s)://... → --browserUrl <url> (DevTools HTTP खोज एंडपॉइंट)।
• ws(s)://... → --wsEndpoint <url> (प्रत्यक्ष CDP WebSocket)।

​

पृथक्करण की गारंटियाँ

• समर्पित उपयोगकर्ता डेटा डायरेक्टरी: आपकी व्यक्तिगत ब्राउज़र प्रोफ़ाइल को कभी नहीं छूती।
• समर्पित पोर्ट: डेवलपमेंट वर्कफ़्लो से टकराव रोकने के लिए 9222 से बचती है।
• नियतात्मक टैब नियंत्रण: tabs पहले suggestedTargetId, फिर स्थिर tabId हैंडल जैसे t1, वैकल्पिक लेबल और रॉ targetId लौटाता है। एजेंटों को suggestedTargetId का पुनः उपयोग करना चाहिए; रॉ ID डीबगिंग और संगतता के लिए उपलब्ध रहते हैं।

​

ब्राउज़र चयन

1. Chrome
2. Brave
3. Edge
4. Chromium
5. Chrome Canary

• macOS: /Applications और ~/Applications की जाँच करता है।
• Linux: /usr/bin, /snap/bin, /opt/google, /opt/brave.com, /usr/lib/chromium, और /usr/lib/chromium-browser के अंतर्गत सामान्य Chrome/Brave/Edge/Chromium स्थानों की जाँच करता है, साथ ही PLAYWRIGHT_BROWSERS_PATH या ~/.cache/ms-playwright के अंतर्गत Playwright-प्रबंधित Chromium की भी जाँच करता है।
• Windows: सामान्य इंस्टॉलेशन स्थानों की जाँच करता है।

​

नियंत्रण API (वैकल्पिक)

​

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

​

CDP स्टार्टअप विफलता बनाम नेविगेशन SSRF अवरोध

• CDP स्टार्टअप या तत्परता विफलता का अर्थ है कि OpenClaw यह पुष्टि नहीं कर सकता कि ब्राउज़र नियंत्रण तल स्वस्थ है।
• नेविगेशन SSRF अवरोध का अर्थ है कि ब्राउज़र नियंत्रण तल स्वस्थ है, लेकिन नीति किसी पृष्ठ नेविगेशन लक्ष्य को अस्वीकार कर देती है।

• CDP स्टार्टअप या तत्परता विफलता:
  • Chrome CDP websocket for profile "openclaw" is not reachable after start
  • Remote CDP for profile "<name>" is not reachable at <cdpUrl>
  • Port <port> is in use for profile "<name>" but not by openclaw, जब कोई लूपबैक बाहरी CDP सेवा attachOnly: true के बिना कॉन्फ़िगर की गई हो
• नेविगेशन SSRF अवरोध:
  • open, navigate, स्नैपशॉट या टैब खोलने के प्रवाह ब्राउज़र/नेटवर्क नीति त्रुटि के साथ विफल होते हैं, जबकि start और tabs अब भी काम करते हैं

openclaw browser --browser-profile openclaw start
openclaw browser --browser-profile openclaw tabs
openclaw browser --browser-profile openclaw open https://example.com

• यदि start, not reachable after start के साथ विफल होता है, तो पहले CDP तत्परता की समस्या दूर करें।
• यदि start सफल होता है, लेकिन tabs विफल होता है, तो नियंत्रण तल अभी भी अस्वस्थ है। इसे CDP पहुँच समस्या मानें, पृष्ठ-नेविगेशन समस्या नहीं।
• यदि start और tabs सफल होते हैं, लेकिन open या navigate विफल होता है, तो ब्राउज़र नियंत्रण तल चालू है और विफलता नेविगेशन नीति या लक्ष्य पृष्ठ में है।
• यदि start, tabs, और open सभी सफल होते हैं, तो मूल प्रबंधित-ब्राउज़र नियंत्रण पथ स्वस्थ है।

• जब आप browser.ssrfPolicy कॉन्फ़िगर नहीं करते, तब भी ब्राउज़र कॉन्फ़िगरेशन डिफ़ॉल्ट रूप से विफलता-बंद SSRF नीति ऑब्जेक्ट का उपयोग करता है।
• स्थानीय लूपबैक openclaw प्रबंधित प्रोफ़ाइल के लिए, CDP स्वास्थ्य जाँच जानबूझकर OpenClaw के अपने स्थानीय नियंत्रण तल हेतु ब्राउज़र SSRF पहुँच प्रवर्तन को छोड़ देती है।
• नेविगेशन सुरक्षा अलग है। सफल start या tabs परिणाम का अर्थ यह नहीं है कि बाद का open या navigate लक्ष्य अनुमत है।

• डिफ़ॉल्ट रूप से ब्राउज़र SSRF नीति को शिथिल न करें।
• व्यापक निजी-नेटवर्क पहुँच के बजाय hostnameAllowlist या allowedHostnames जैसे संकीर्ण होस्ट अपवादों को प्राथमिकता दें।
• dangerouslyAllowPrivateNetwork: true का उपयोग केवल जानबूझकर विश्वसनीय परिवेशों में करें, जहाँ निजी-नेटवर्क ब्राउज़र पहुँच आवश्यक हो और उसकी समीक्षा की गई हो।

​

एजेंट टूल + नियंत्रण कैसे काम करता है

• browser - डॉक्टर/स्थिति/शुरू/बंद/टैब/खोलना/फ़ोकस/बंद करना/स्नैपशॉट/स्क्रीनशॉट/नेविगेट/कार्रवाई

• browser snapshot एक स्थिर UI ट्री (AI या ARIA) लौटाता है।
• browser act क्लिक/टाइप/ड्रैग/चयन करने के लिए स्नैपशॉट के ref IDs का उपयोग करता है।
• browser screenshot पिक्सेल कैप्चर करता है (पूरा पृष्ठ, एलिमेंट या लेबल किए गए रेफ़रेंस)।
• browser doctor Gateway, Plugin, प्रोफ़ाइल, ब्राउज़र और टैब की तत्परता की जाँच करता है।
• browser इन्हें स्वीकार करता है:
  • नामित ब्राउज़र प्रोफ़ाइल (openclaw, chrome या remote CDP) चुनने के लिए profile।
  • ब्राउज़र कहाँ स्थित है, यह चुनने के लिए target (sandbox | host | node)।
  • सैंडबॉक्स किए गए सत्रों में, target: "host" के लिए agents.defaults.sandbox.browser.allowHostControl=true आवश्यक है।
  • यदि target छोड़ा गया है: सैंडबॉक्स किए गए सत्र डिफ़ॉल्ट रूप से sandbox का और गैर-सैंडबॉक्स सत्र डिफ़ॉल्ट रूप से host का उपयोग करते हैं।
  • यदि ब्राउज़र-सक्षम Node कनेक्ट है, तो टूल उस पर स्वचालित रूप से रूट कर सकता है, जब तक कि आप target="host" या target="node" को पिन न करें।

​

संबंधित

• टूल का अवलोकन - सभी उपलब्ध एजेंट टूल
• सैंडबॉक्सिंग - सैंडबॉक्स किए गए परिवेशों में ब्राउज़र नियंत्रण
• सुरक्षा - ब्राउज़र नियंत्रण के जोखिम और सुदृढ़ीकरण