ब्राउज़र समस्या निवारण

समस्या: पोर्ट 18800 पर Chrome CDP शुरू नहीं हो सका

{ "error": "त्रुटि: प्रोफ़ाइल \"openclaw\" के लिए पोर्ट 18800 पर Chrome CDP शुरू नहीं हो सका।" }

मूल कारण

Ubuntu और अधिकांश Linux डिस्ट्रो पर, apt install chromium वास्तविक ब्राउज़र नहीं, बल्कि snap रैपर इंस्टॉल करता है:

ध्यान दें, 'chromium' के बजाय 'chromium-browser' चुना जा रहा हैchromium-browser पहले से नवीनतम संस्करण (2:1snap1-0ubuntu2) है।

Snap का AppArmor परिसीमन OpenClaw द्वारा ब्राउज़र प्रक्रिया शुरू करने और उसकी निगरानी करने के तरीके में हस्तक्षेप करता है।

Linux पर शुरू होने में विफलता के अन्य सामान्य कारण:

• The profile appears to be in use by another Chromium process: प्रबंधित प्रोफ़ाइल डायरेक्टरी में पुरानी Singleton* लॉक फ़ाइलें। जब लॉक किसी बंद या अलग होस्ट की प्रक्रिया की ओर संकेत करता है, तो OpenClaw इन लॉक को हटाकर एक बार फिर प्रयास करता है।
• Missing X server or $DISPLAY: डेस्कटॉप सत्र के बिना किसी होस्ट पर दृश्यमान ब्राउज़र का स्पष्ट रूप से अनुरोध किया गया था। जब DISPLAY और WAYLAND_DISPLAY दोनों सेट नहीं होते, तो Linux पर स्थानीय प्रबंधित प्रोफ़ाइल हेडलेस मोड पर वापस चली जाती हैं। यदि आपने OPENCLAW_BROWSER_HEADLESS=0, browser.headless: false, या browser.profiles.<name>.headless: false सेट किया है, तो उस हेडेड ओवरराइड को हटाएँ, या OPENCLAW_BROWSER_HEADLESS=1 सेट करें, Xvfb शुरू करें, एक बार के प्रबंधित लॉन्च के लिए openclaw browser start --headless चलाएँ, अथवा OpenClaw को वास्तविक डेस्कटॉप सत्र में चलाएँ।

समाधान 1: Google Chrome इंस्टॉल करें (अनुशंसित)

wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.debsudo dpkg -i google-chrome-stable_current_amd64.debsudo apt --fix-broken install -y  # यदि निर्भरता संबंधी त्रुटियाँ हों

~/.openclaw/openclaw.json अपडेट करें:

{  "browser": {    "enabled": true,    "executablePath": "/usr/bin/google-chrome-stable",    "headless": true,    "noSandbox": true  }}

समाधान 2: snap Chromium को केवल-अटैच मोड में उपयोग करें

यदि snap Chromium रखना आवश्यक है, तो OpenClaw को ब्राउज़र लॉन्च करने के बजाय मैन्युअल रूप से शुरू किए गए ब्राउज़र से अटैच होने के लिए कॉन्फ़िगर करें:

{  "browser": {    "enabled": true,    "attachOnly": true,    "headless": true,    "noSandbox": true  }}

Chromium को मैन्युअल रूप से शुरू करें:

chromium-browser --headless --no-sandbox --disable-gpu \  --remote-debugging-port=18800 \  --user-data-dir=$HOME/.openclaw/browser/openclaw/user-data \  about:blank &

वैकल्पिक रूप से, इसे systemd उपयोगकर्ता सेवा से स्वतः शुरू करें:

# ~/.config/systemd/user/openclaw-browser.service[Unit]Description=OpenClaw ब्राउज़र (Chrome CDP)After=network.target [Service]ExecStart=/snap/bin/chromium --headless --no-sandbox --disable-gpu --remote-debugging-port=18800 --user-data-dir=%h/.openclaw/browser/openclaw/user-data about:blankRestart=on-failureRestartSec=5 [Install]WantedBy=default.target

systemctl --user enable --now openclaw-browser.service

सत्यापित करें कि ब्राउज़र काम करता है

curl -s http://127.0.0.1:18791/ | jq '{running, pid, chosenBrowser}'curl -s -X POST http://127.0.0.1:18791/startcurl -s http://127.0.0.1:18791/tabs

कॉन्फ़िगरेशन संदर्भ

Raspberry Pi, पुराने VPS होस्ट या धीमे स्टोरेज पर, जब Chrome को अपना CDP HTTP एंडपॉइंट उपलब्ध कराने या तैयार होने में प्रबंधित-ब्राउज़र की समय-सीमा से अधिक समय लगता है, तो attachOnly के साथ मैन्युअल रूप से लॉन्च किए गए ब्राउज़र का उपयोग करें।

समस्या: profile="user" के लिए कोई Chrome टैब नहीं मिला

आप user (existing-session / Chrome MCP) प्रोफ़ाइल का उपयोग कर रहे हैं और अटैच होने के लिए कोई टैब खुला नहीं है।

समाधान के विकल्प:

1. इसके बजाय प्रबंधित ब्राउज़र का उपयोग करें: openclaw browser --browser-profile openclaw start (या browser.defaultProfile: "openclaw" सेट करें)।
2. स्थानीय Chrome को कम-से-कम एक खुले टैब के साथ चालू रखें, फिर --browser-profile user के साथ पुनः प्रयास करें।

टिप्पणियाँ:

• user केवल होस्ट के लिए है। Linux सर्वर, कंटेनर या रिमोट होस्ट पर इसके बजाय CDP प्रोफ़ाइल को प्राथमिकता दें।
• user और अन्य existing-session प्रोफ़ाइल वर्तमान Chrome MCP सीमाएँ साझा करती हैं: केवल संदर्भ-संचालित क्रियाएँ, प्रति अपलोड एक फ़ाइल, कोई डायलॉग timeoutMs ओवरराइड नहीं, कोई wait --load networkidle नहीं, और कोई responsebody, PDF निर्यात, डाउनलोड इंटरसेप्शन या बैच क्रियाएँ नहीं।
• स्थानीय openclaw-ड्राइवर प्रोफ़ाइल स्वतः cdpPort/cdpUrl असाइन करती हैं; इन्हें केवल रिमोट CDP के लिए मैन्युअल रूप से सेट करें।
• रिमोट CDP प्रोफ़ाइल http://, https://, ws://, और wss:// स्वीकार करती हैं। /json/version खोज के लिए HTTP(S) का उपयोग करें, या जब आपकी ब्राउज़र सेवा आपको प्रत्यक्ष DevTools सॉकेट URL देती है, तब WS(S) का उपयोग करें।

संबंधित

• ब्राउज़र
• ब्राउज़र लॉगिन
• ब्राउज़र WSL2 समस्या निवारण