Skip to main content

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

المشكلة: “Failed to start Chrome CDP on port 18800”

يفشل خادم التحكم بالمتصفح في OpenClaw في تشغيل Chrome/Brave/Edge/Chromium مع الخطأ:

السبب الجذري

على Ubuntu (والعديد من توزيعات Linux)، يكون تثبيت Chromium الافتراضي عبارة عن حزمة snap. يتعارض تقييد AppArmor في snap مع الطريقة التي يقوم بها OpenClaw بإنشاء عملية المتصفح ومراقبتها. يقوم الأمر apt install chromium بتثبيت حزمة وسيطة تعيد التوجيه إلى snap:
هذا ليس متصفحًا حقيقيًا — بل مجرد غلاف.

الحل 1: تثبيت Google Chrome (موصى به)

قم بتثبيت حزمة Google Chrome الرسمية .deb، وهي غير معزولة بواسطة snap:
ثم حدّث تهيئة OpenClaw لديك (~/.openclaw/openclaw.json):

الحل 2: استخدام Snap Chromium مع وضع «الارتباط فقط»

إذا كان لا بد من استخدام Chromium بنظام snap، فقم بتهيئة OpenClaw ليرتبط بمتصفح تم تشغيله يدويًا:
  1. تحديث الإعداد:
  1. شغّل Chromium يدويًا:
  1. اختياريًا، أنشئ خدمة مستخدم systemd لبدء Chrome تلقائيًا:
فعِّلها باستخدام: systemctl --user enable --now openclaw-browser.service

التحقق من عمل المتصفح

تحقق من الحالة:
اختبر التصفح:

مرجع التهيئة

المشكلة: “Chrome extension relay is running, but no tab is connected”

أنت تستخدم ملف التعريف chrome (وسيط الامتداد). وهو يتوقع أن يكون امتداد متصفح OpenClaw مرتبطًا بعلامة تبويب نشطة. خيارات الإصلاح:
  1. استخدام المتصفح المُدار: openclaw browser start --browser-profile openclaw (أو تعيين browser.defaultProfile: "openclaw").
  2. استخدام وسيط الامتداد: ثبّت الامتداد، وافتح علامة تبويب، ثم انقر على أيقونة امتداد OpenClaw لربطه.
ملاحظات:
  • يستخدم ملف التعريف chrome متصفح Chromium الافتراضي للنظام متى أمكن.
  • تقوم ملفات التعريف المحلية openclaw بتعيين cdpPort/cdpUrl تلقائيًا؛ لا تقم بتعيينهما إلا لـ CDP البعيد.