मुख्य सामग्री पर जाएं

​
समस्या: “पोर्ट 18800 पर Chrome CDP शुरू करने में विफल”

OpenClaw का ब्राउज़र नियंत्रण सर्वर Chrome/Brave/Edge/Chromium को इस त्रुटि के साथ लॉन्च करने में विफल होता है: 
{"error":"Error: Failed to start Chrome CDP on port 18800 for profile \"openclaw\"."}

​
मूल कारण

Ubuntu (और कई Linux डिस्ट्रो) पर, डिफ़ॉल्ट Chromium इंस्टॉलेशन एक snap package होता है। Snap का AppArmor confinement OpenClaw द्वारा ब्राउज़र प्रक्रिया शुरू करने और मॉनिटर करने के तरीके में बाधा डालता है। apt install chromium कमांड एक stub package इंस्टॉल करता है जो snap पर रीडायरेक्ट करता है: 
Note, selecting 'chromium-browser' instead of 'chromium'
chromium-browser is already the newest version (2:1snap1-0ubuntu2).
यह वास्तविक ब्राउज़र नहीं है - यह सिर्फ़ एक wrapper है। अन्य सामान्य Linux लॉन्च विफलताएं:
  • The profile appears to be in use by another Chromium process का अर्थ है कि Chrome को managed profile डायरेक्टरी में पुराने Singleton* lock files मिले। OpenClaw उन locks को हटाता है और एक बार फिर कोशिश करता है जब lock किसी मृत या अलग-host प्रक्रिया की ओर संकेत करता है।
  • Missing X server or $DISPLAY का अर्थ है कि desktop session के बिना किसी host पर visible browser स्पष्ट रूप से अनुरोधित था। डिफ़ॉल्ट रूप से, local managed profiles अब Linux पर headless mode पर fallback करते हैं जब DISPLAY और WAYLAND_DISPLAY दोनों unset हों। यदि आपने OPENCLAW_BROWSER_HEADLESS=0, browser.headless: false, या browser.profiles.<name>.headless: false सेट किया है, तो उस headed override को हटाएं, OPENCLAW_BROWSER_HEADLESS=1 सेट करें, Xvfb शुरू करें, one-shot managed launch के लिए openclaw browser start --headless चलाएं, या OpenClaw को वास्तविक desktop session में चलाएं।

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

आधिकारिक Google Chrome .deb package इंस्टॉल करें, जिसे snap sandbox नहीं करता: 
wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo dpkg -i google-chrome-stable_current_amd64.deb
sudo apt --fix-broken install -y  # if there are dependency errors
फिर अपनी OpenClaw config (~/.openclaw/openclaw.json) अपडेट करें: 
{
  "browser": {
    "enabled": true,
    "executablePath": "/usr/bin/google-chrome-stable",
    "headless": true,
    "noSandbox": true
  }
}

​
समाधान 2: Attach-Only Mode के साथ Snap Chromium का उपयोग करें

यदि आपको snap Chromium का उपयोग करना ही है, तो manually-started browser से attach करने के लिए OpenClaw को configure करें:
  1. config अपडेट करें:
{
  "browser": {
    "enabled": true,
    "attachOnly": true,
    "headless": true,
    "noSandbox": true
  }
}
  1. Chromium को manually शुरू करें:
chromium-browser --headless --no-sandbox --disable-gpu \
  --remote-debugging-port=18800 \
  --user-data-dir=$HOME/.openclaw/browser/openclaw/user-data \
  about:blank &
  1. वैकल्पिक रूप से Chrome को auto-start करने के लिए systemd user service बनाएं:
# ~/.config/systemd/user/openclaw-browser.service
[Unit]
Description=OpenClaw Browser (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:blank
Restart=on-failure
RestartSec=5

[Install]
WantedBy=default.target
इससे enable करें: systemctl --user enable --now openclaw-browser.service

​
ब्राउज़र के काम करने की पुष्टि करना

status जांचें: 
curl -s http://127.0.0.1:18791/ | jq '{running, pid, chosenBrowser}'
browsing का परीक्षण करें: 
curl -s -X POST http://127.0.0.1:18791/start
curl -s http://127.0.0.1:18791/tabs

​
Config संदर्भ

विकल्पविवरणडिफ़ॉल्ट
browser.enabledbrowser control सक्षम करेंtrue
browser.executablePathChromium-आधारित browser binary (Chrome/Brave/Edge/Chromium) का pathauto-detected (Chromium-आधारित होने पर default browser को प्राथमिकता देता है)
browser.headlessGUI के बिना चलाएंfalse
OPENCLAW_BROWSER_HEADLESSlocal managed browser headless mode के लिए per-process overrideसेट नहीं
browser.noSandbox--no-sandbox flag जोड़ें (कुछ Linux setups के लिए आवश्यक)false
browser.attachOnlybrowser launch न करें, केवल existing से attach करेंfalse
browser.cdpPortChrome DevTools Protocol port18800
browser.localLaunchTimeoutMsLocal managed Chrome discovery timeout15000
browser.localCdpReadyTimeoutMsLocal managed post-launch CDP readiness timeout8000
Raspberry Pi, पुराने VPS hosts, या slow storage पर, browser.localLaunchTimeoutMs बढ़ाएं जब Chrome को अपना CDP HTTP endpoint expose करने के लिए अधिक समय चाहिए। browser.localCdpReadyTimeoutMs तब बढ़ाएं जब launch सफल हो लेकिन openclaw browser start फिर भी not reachable after start रिपोर्ट करे। मान 120000 ms तक के positive integers होने चाहिए; invalid config values rejected होते हैं।

​
समस्या: “profile=“user” के लिए कोई Chrome tabs नहीं मिले”

आप existing-session / Chrome MCP profile का उपयोग कर रहे हैं। OpenClaw local Chrome देख सकता है, लेकिन attach करने के लिए कोई open tabs उपलब्ध नहीं हैं। Fix विकल्प:
  1. managed browser का उपयोग करें: openclaw browser start --browser-profile openclaw (या browser.defaultProfile: "openclaw" सेट करें)।
  2. Chrome MCP का उपयोग करें: सुनिश्चित करें कि local Chrome कम से कम एक open tab के साथ चल रहा है, फिर --browser-profile user के साथ फिर कोशिश करें।
Notes:
  • user host-only है। Linux servers, containers, या remote hosts के लिए, CDP profiles को प्राथमिकता दें।
  • user / अन्य existing-session profiles वर्तमान Chrome MCP limits रखते हैं: ref-driven actions, one-file upload hooks, कोई dialog timeout overrides नहीं, कोई wait --load networkidle नहीं, और कोई responsebody, PDF export, download interception, या batch actions नहीं।
  • Local openclaw profiles cdpPort/cdpUrl auto-assign करते हैं; इन्हें केवल remote CDP के लिए सेट करें।
  • Remote CDP profiles http://, https://, ws://, और wss:// स्वीकार करते हैं। /json/version discovery के लिए HTTP(S) का उपयोग करें, या WS(S) का उपयोग करें जब आपका browser service आपको direct DevTools socket URL देता है।

​
संबंधित