---
read_when: Browser control fails on Linux, especially with snap Chromium
summary: Linux पर OpenClaw ब्राउज़र नियंत्रण के लिए Chrome/Brave/Edge/Chromium CDP स्टार्टअप समस्याएँ ठीक करें
title: ब्राउज़र समस्या निवारण
x-i18n:
    generated_at: "2026-07-27T21:46:24Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: 8e5db2da2d43129862f0c005213df828f6eae81f5561e57d41795ea90787822a
    source_path: tools/browser-linux-troubleshooting.md
    workflow: 16
---

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

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

### मूल कारण

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

```text
ध्यान दें, '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 इंस्टॉल करें (अनुशंसित)

```bash
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  # यदि निर्भरता संबंधी त्रुटियाँ हों
```

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

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

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

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

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

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

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

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

```ini
# ~/.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:blank
Restart=on-failure
RestartSec=5

[Install]
WantedBy=default.target
```

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

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

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

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

| विकल्प                      | विवरण                                                          | डिफ़ॉल्ट                                                            |
| --------------------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------ |
| `browser.enabled`           | ब्राउज़र नियंत्रण सक्षम करें                                               | `true`                                                             |
| `browser.executablePath`    | Chromium-आधारित ब्राउज़र बाइनरी का पथ (Chrome/Brave/Edge/Chromium) | स्वतः पता लगाया जाता है (यदि OS का डिफ़ॉल्ट ब्राउज़र Chromium-आधारित हो, तो उसे प्राथमिकता दी जाती है) |
| `browser.headless`          | GUI के बिना चलाएँ                                                      | `false`                                                            |
| `OPENCLAW_BROWSER_HEADLESS` | स्थानीय प्रबंधित ब्राउज़र के हेडलेस मोड के लिए प्रति-प्रक्रिया ओवरराइड         | सेट नहीं                                                              |
| `browser.noSandbox`         | `--no-sandbox` फ़्लैग जोड़ें (कुछ Linux सेटअप के लिए आवश्यक)               | `false`                                                            |
| `browser.attachOnly`        | ब्राउज़र लॉन्च न करें; केवल मौजूदा ब्राउज़र से अटैच हों              | `false`                                                            |

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) का उपयोग करें।

## संबंधित

- [ब्राउज़र](/hi/tools/browser)
- [ब्राउज़र लॉगिन](/hi/tools/browser-login)
- [ब्राउज़र WSL2 समस्या निवारण](/hi/tools/browser-wsl2-windows-remote-cdp-troubleshooting)