إضافة Chrome

تتيح إضافة OpenClaw لـ Chrome للوكيل التحكم في علامات تبويب Chrome الحالية (نافذة Chrome العادية الخاصة بك) بدلاً من تشغيل ملف تعريف Chrome منفصل تديره openclaw. يتم الربط/فك الربط عبر زر واحد في شريط أدوات Chrome.

ما هي (المفهوم)

هناك ثلاثة أجزاء:

• خدمة التحكم في المتصفح (البوابة أو العقدة): واجهة برمجة التطبيقات (API) التي يستدعيها الوكيل/الأداة (عبر البوابة)
• خادم النقل المحلي (CDP حلقة العودة): يجسر بين خادم التحكم والإضافة (http://127.0.0.1:18792 افتراضيًا)
• إضافة Chrome MV3: تعلق على علامة التبويب النشطة باستخدام chrome.debugger وتنقل رسائل CDP إلى الناقل

ثم تتحكم OpenClaw في علامة التبويب المرفقة من خلال سطح أداة browser العادي (اختيار ملف التعريف الصحيح).

التثبيت / التحميل (غير معبأة)

1. قم بتثبيت الإضافة في مسار محلي ثابت:

openclaw browser extension install

2. اطبع مسار دليل الإضافة المثبت:

openclaw browser extension path

3. Chrome → chrome://extensions

• قم بتمكين "وضع المطور"
• "تحميل غير معبأ" → حدد الدليل المطبوع أعلاه

4. ثبت الإضافة.

التحديثات (لا توجد خطوة بناء)

يتم شحن الإضافة داخل إصدار OpenClaw (حزمة npm) كملفات ثابتة. لا توجد خطوة "بناء" منفصلة. بعد ترقية OpenClaw:

• أعد تشغيل openclaw browser extension install لتحديث الملفات المثبتة تحت دليل حالة OpenClaw الخاص بك.
• Chrome → chrome://extensions → انقر على "إعادة تحميل" على الإضافة.

استخدامها (تعيين رمز البوابة مرة واحدة)

يتم شحن OpenClaw مع ملف تعريف متصفح مدمج باسم chrome يستهدف ناقل الإضافة على المنفذ الافتراضي. قبل الربط الأول، افتح خيارات الإضافة وعيّن:

• المنفذ (افتراضي 18792)
• رمز البوابة (يجب أن يتطابق مع gateway.auth.token / OPENCLAW_GATEWAY_TOKEN)

استخدمها:

• سطر الأوامر: openclaw browser --browser-profile chrome tabs
• أداة الوكيل: browser مع profile="chrome"

إذا كنت تريد اسمًا مختلفًا أو منفذ نقل مختلف، قم بإنشاء ملف التعريف الخاص بك:

openclaw browser create-profile \
  --name my-chrome \
  --driver extension \
  --cdp-url http://127.0.0.1:18792 \
  --color "#00AA00"

منافذ البوابة المخصصة

إذا كنت تستخدم منفذ بوابة مخصصًا، يتم اشتقاق منفذ نقل الإضافة تلقائيًا: منفذ نقل الإضافة = منفذ البوابة + 3 مثال: إذا كان gateway.port: 19001، إذن:

• منفذ نقل الإضافة: 19004 (البوابة + 3)

قم بتكوين الإضافة لاستخدام منفذ النقل المشتق في صفحة خيارات الإضافة.

الربط / فك الربط (زر شريط الأدوات)

• افتح علامة التبويب التي تريد أن يتحكم فيها OpenClaw.
• انقر على أيقونة الإضافة.
  • تظهر العلامة ON عند الالتحاق.
• انقر مرة أخرى لفك الربط.

أي علامة تبويب يتحكم فيها؟

• لا يتحكم تلقائيًا في "أي علامة تبويب تنظر إليها".
• يتحكم فقط في علامة/علامات التبويب التي ربطتها صراحةً بالنقر على زر شريط الأدوات.
• للتبديل: افتح علامة التبويب الأخرى وانقر على أيقونة الإضافة هناك.

العلامة + الأخطاء الشائعة

• ON: مرتبطة؛ يمكن لـ OpenClaw قيادة تلك علامة التبويب.
• …: جاري الاتصال بالناقل المحلي.
• !: الناقل غير قابل للوصول/غير مصرح به (الأكثر شيوعًا: خادم النقل لا يعمل، أو رمز البوابة مفقود/خاطئ).

إذا رأيت !:

• تأكد من أن البوابة تعمل محليًا (الإعداد الافتراضي)، أو قم بتشغيل مضيف عقدة على هذا الجهاز إذا كانت البوابة تعمل في مكان آخر.
• افتح صفحة خيارات الإضافة؛ فهي تتحقق من قابلية الوصول إلى الناقل + مصادقة رمز البوابة.

بوابة بعيدة (استخدام مضيف عقدة)

بوابة محلية (نفس الجهاز مثل Chrome) — عادة لا توجد خطوات إضافية

إذا كانت البوابة تعمل على نفس الجهاز مثل Chrome، فإنها تبدأ خدمة التحكم في المتصفح على حلقة العودة وتشغل خادم النقل تلقائيًا. تتحدث الإضافة مع الناقل المحلي؛ تذهب استدعاءات سطر الأوامر/الأداة إلى البوابة.

بوابة بعيدة (البوابة تعمل في مكان آخر) — قم بتشغيل مضيف عقدة

إذا كانت بوابتك تعمل على جهاز آخر، ابدأ مضيف عقدة على الجهاز الذي يعمل عليه Chrome. ستقوم البوابة بتمرير إجراءات المتصفح إلى تلك العقدة؛ تبقى الإضافة + الناقل محليين لجهاز المتصفح. إذا كانت هناك عقد متعددة متصلة، فقم بتثبيت واحدة باستخدام gateway.nodes.browser.node أو عيّن gateway.nodes.browser.mode.

العزل (حاويات الأدوات)

إذا كانت جلسة الوكيل الخاصة بك معزولة (agents.defaults.sandbox.mode != "off")، يمكن تقييد أداة browser:

• افتراضيًا، غالبًا ما تستهدف الجلسات المعزولة متصفح العزل (target="sandbox")، وليس Chrome المضيف الخاص بك.
• تتطلب السيطرة على نقل إضافة Chrome التحكم في خادم التحكم في المتصفح المضيف.

الخيارات:

• الأسهل: استخدم الإضافة من جلسة/وكيل غير معزول.
• أو اسمح بالتحكم في متصفح المضيف للجلسات المعزولة:

{
  agents: {
    defaults: {
      sandbox: {
        browser: {
          allowHostControl: true,
        },
      },
    },
  },
}

ثم تأكد من أن الأداة غير مرفوضة بواسطة سياسة الأداة، و (إذا لزم الأمر) استدعِ browser مع target="host". تصحيح الأخطاء: openclaw sandbox explain

نصائح الوصول عن بُعد

• احتفظ بالبوابة ومضيف العقدة على نفس شبكة tailnet؛ تجنب تعريض منافذ النقل لشبكة LAN أو الإنترنت العام.
• قم بإقران العقد عمدًا؛ قم بتعطيل توجيه وكيل المتصفح إذا كنت لا تريد التحكم عن بُعد (gateway.nodes.browser.mode="off").

كيف يعمل "مسار الإضافة"

openclaw browser extension path تطبع دليل المثبت على القرص الذي يحتوي على ملفات الإضافة. لا يطبع سطر الأوامر عمدًا مسار node_modules. قم دائمًا بتشغيل openclaw browser extension install أولاً لنسخ الإضافة إلى موقع ثابت تحت دليل حالة OpenClaw الخاص بك. إذا قمت بنقل أو حذف دليل التثبيت هذا، سيقوم Chrome بوضع علامة على الإضافة على أنها تالفة حتى تقوم بإعادة تحميلها من مسار صالح.

الآثار الأمنية (اقرأ هذا)

هذا قوي ومحفوف بالمخاطر. عامل الأمر كما لو أنك تمنح النموذج "أيدي على متصفحك".

• تستخدم الإضافة واجهة برمجة تطبيقات تصحيح أخطاء Chrome (chrome.debugger). عند الالتحاق، يمكن للنموذج:
  • النقر/الكتابة/التنقل في تلك علامة التبويب
  • قراءة محتوى الصفحة
  • الوصول إلى ما يمكن لجلسة تسجيل الدخول لعلامة التبويب الوصول إليه
• هذا ليس معزولاً مثل ملف التعريف المخصص الذي تديره openclaw.
  • إذا قمت بربط ملف التعريف/علامة التبويب التي تستخدمها يوميًا، فأنت تمنح حق الوصول إلى حالة ذلك الحساب.

التوصيات:

• يُفضل استخدام ملف تعريف Chrome مخصص (منفصل عن تصفحك الشخصي) لاستخدام نقل الإضافة.
• احتفظ بالبوابة وأي مضيفي عقد على شبكة tailnet فقط؛ اعتمد على مصادقة البوابة + إقران العقد.
• تجنب تعريض منافذ النقل عبر شبكة LAN (0.0.0.0) وتجنب Funnel (العام).
• يمنع النقل الأصول غير التابعة للإضافة ويتطلب مصادقة رمز البوابة لكل من /cdp و /extension.

ذات صلة:

• نظرة عامة على أداة المتصفح: المتصفح
• تدقيق أمني: الأمان
• إعداد Tailscale: Tailscale

تسجيل الدخول عبر المتصفحاستكشاف أخطاء المتصفح وإصلاحها