استكشاف أخطاء المتصفح وإصلاحها

​

المشكلة: تعذّر بدء Chrome CDP على المنفذ 18800

{ "error": "Error: Failed to start Chrome CDP on port 18800 for profile \"openclaw\"." }

​

السبب الجذري

Note, selecting 'chromium-browser' instead of 'chromium'
chromium-browser is already the newest version (2:1snap1-0ubuntu2).

• The profile appears to be in use by another Chromium process: ملفات قفل Singleton* قديمة في دليل ملف التعريف المُدار. يزيل OpenClaw هذه الأقفال ويعيد المحاولة مرة واحدة عندما يشير القفل إلى عملية متوقفة أو عملية على مضيف مختلف.
• Missing X server or $DISPLAY: طُلب متصفح مرئي صراحةً على مضيف لا يحتوي على جلسة سطح مكتب. تعود ملفات التعريف المحلية المُدارة إلى الوضع عديم الواجهة على Linux عندما لا يكون كل من DISPLAY وWAYLAND_DISPLAY معيّنًا. إذا عيّنت 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.deb
sudo dpkg -i google-chrome-stable_current_amd64.deb
sudo apt --fix-broken install -y  # إذا كانت هناك أخطاء في التبعيات

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

​

الحل 2: استخدام Chromium من snap في وضع الإرفاق فقط

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

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

# ~/.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

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/start
curl -s http://127.0.0.1:18791/tabs

​

مرجع الإعدادات

​

المشكلة: لم يُعثر على علامات تبويب Chrome لملف التعريف profile="user"

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://. استخدم HTTP(S) لاكتشاف /json/version، أو WS(S) عندما توفر خدمة المتصفح عنوان URL مباشرًا لمقبس DevTools.

​

ذو صلة

• المتصفح
• تسجيل الدخول إلى المتصفح
• استكشاف أخطاء المتصفح في WSL2 وإصلاحها