إضافة Chrome

تتيح إضافة OpenClaw لمتصفح Chrome للوكيل التحكم في علامات تبويب Chrome التي سجّلت الدخول فيها من دون تشغيل متصفح مُدار منفصل، ومن دون مطالبة Chrome المانعة "Allow remote debugging?".

يُعد هذا مهمًا عند التحكم في OpenClaw من هاتف (Telegram أو WhatsApp أو غيرهما): يتصل ملف تعريف user عبر منفذ التصحيح عن بُعد في Chrome، ما يؤدي إلى ظهور مربع حوار موافقة على سطح المكتب لا يستطيع أحد النقر عليه عندما تكون بعيدًا. تستخدم الإضافة واجهة chrome.debugger بدلًا من ذلك، لذا يكون التنبيه الوحيد داخل الصفحة هو شريط Chrome القابل للإغلاق "OpenClaw started debugging this browser".

وهذا هو النهج نفسه الذي تستخدمه إضافتا Anthropic Claude in Chrome وOpenAI Codex لمتصفح Chrome.

آلية العمل

ثلاثة أجزاء:

• خدمة التحكم في المتصفح (Gateway أو مضيف Node): واجهة API التي تستدعيها أداة browser.
• وسيط الإضافة (WebSocket عبر local loopback): خادم صغير تشغّله خدمة التحكم على 127.0.0.1. يوفّر نقطة نهاية لبروتوكول Chrome DevTools إلى OpenClaw ويتواصل مع الإضافة. يصادق الطرفان باستخدام رمز محلي للمضيف (انظر أدناه).
• إضافة OpenClaw لمتصفح Chrome (MV3): تتصل بعلامات التبويب باستخدام chrome.debugger، وتمرر حركة مرور CDP، وتدير مجموعة علامات تبويب OpenClaw.

لا يرى OpenClaw إلا علامات التبويب الموجودة في مجموعة علامات تبويب OpenClaw ولا يتحكم إلا فيها. تمثّل المجموعة حدّ الموافقة: اسحب علامة تبويب إلى داخلها لمشاركتها، واسحبها إلى خارجها (أو انقر زر شريط الأدوات) لإلغاء الوصول فورًا.

التثبيت والإقران

1. اطبع مسار الإضافة غير المحزّمة:

   openclaw browser extension path

2. افتح chrome://extensions، وفعّل Developer mode، وانقر Load unpacked، ثم اختر الدليل المطبوع.

3. اطبع سلسلة الإقران:

   openclaw browser extension pair

4. انقر أيقونة OpenClaw في شريط الأدوات والصق سلسلة الإقران في النافذة المنبثقة. تتحول الشارة إلى ON عندما تتصل الإضافة بالوسيط.

رمز الإقران هو سر محلي للمضيف يُنشأ عند أول استخدام ويُخزّن ضمن credentials/ في دليل الحالة (بالوضع 0600). تمتلك كل آلة تشغّل متصفحًا — مضيف Gateway وكل مضيف Node للمتصفح — رمزها الخاص، لذلك لا يلزم نقل أي بيانات اعتماد بين الآلات. لتدويره، احذف الملف browser-extension-relay.secret وأعِد الإقران.

الاستخدام

حدّد ملف التعريف المضمّن chrome في استدعاء أداة browser، أو اجعله الافتراضي:

openclaw config set browser.defaultProfile chrome

{  browser: {    profiles: {      chrome: { driver: "extension", color: "#FF4500" },    },  },}

• لمشاركة علامة تبويب: انقر زر OpenClaw في شريط الأدوات ضمن علامة التبويب تلك (ستنضم إلى مجموعة علامات تبويب OpenClaw)، أو اسحب أي علامة تبويب إلى المجموعة.
• يمكن للوكيل أيضًا فتح علامات تبويب جديدة، وستُضاف إلى المجموعة تلقائيًا.
• لإلغاء الوصول: انقر الزر مرة أخرى، أو اسحب علامة التبويب خارج المجموعة، أو أغلق شريط التصحيح في Chrome. يفقد الوكيل الوصول إلى علامة التبويب تلك فورًا.

التشغيل عن بُعد / عبر آلات متعددة

ليس من الضروري تشغيل Chrome على مضيف Gateway. تعمل ثلاثة مخططات:

• المضيف نفسه (Gateway وChrome على آلة واحدة): أجرِ الإقران على تلك الآلة باستخدام openclaw browser extension pair. يكون الوسيط مقتصرًا على local loopback.
• الاتصال المباشر بـ Gateway بعيد (Chrome على حاسوبك المحمول، وGateway على خادم VPS، ولا شيء آخر على الحاسوب المحمول): شغّل على Gateway الأمر openclaw browser extension pair --gateway-url wss://your-gateway.example.com. يطبع سلسلة wss://…/browser/extension#<secret>؛ حمّل الإضافة وأقرنها على الحاسوب المحمول. تتصل الإضافة مباشرةً بـ Gateway عبر wss:// — من دون تثبيت OpenClaw أو Node أو CLI، ومن دون منفذ وارد مفتوح على الحاسوب المحمول. هذا هو مسار الاستضافة المُدارة.
• عبر مضيف Node للمتصفح (Chrome على آلة تشغّل بالفعل OpenClaw Node): شغّل pair على Node وأجرِ الإقران محليًا؛ يمرّر Gateway إجراءات المتصفح إلى Node عبر رابط Node الحالي والمصادق عليه.

يكون سر الإقران مخصصًا لكل مضيف (سر Gateway في حالة الاتصال المباشر)، ويتحقق منه مسار /browser/extension في Gateway. بالنسبة إلى المسار المباشر، قدّم Gateway عبر TLS ‏(wss://) لتشفير سر الإقران وحركة مرور CDP. يبقى السر في جزء التجزئة من عنوان URL في سلسلة الإقران، ويُقدَّم أثناء مصافحة WebSocket بوصفه بيانات اعتماد لبروتوكول فرعي، لذلك لا تستلمه عادةً سجلات وصول الوكيل العكسي ضمن عنوان URL للطلب. تأكد من أن أي وكيل عكسي يحافظ على الترويسة القياسية Sec-WebSocket-Protocol.

التشخيص

openclaw browser status --browser-profile chromeopenclaw browser doctor --browser-profile chrome

يُبلغ doctor عن فشل فحص وسيط إضافة Chrome حتى تعرض نافذة الإضافة المنبثقة Connected.

نموذج الأمان

• يرتبط الوسيط بـ local loopback فقط؛ ويخضع كلا طرفي WebSocket للمصادقة باستخدام الرمز المشتق، كما يُتحقق من أن أصل طرف الإضافة هو chrome-extension://.
• لا يقبل الإقران المباشر مع Gateway رمز الوسيط في عنوان URL للطلب؛ بل تحمل الإضافة المضمّنة الرمز ضمن قائمة بروتوكولات WebSocket الفرعية.
• لا يستطيع الوكيل رؤية علامات التبويب الموجودة في مجموعة علامات تبويب OpenClaw أو التحكم إلا فيها. تظل علامات التبويب الأخرى خاصة.
• مقارنةً بملف التعريف user ‏(Chrome MCP)، الذي يكشف متصفحك بالكامل بعد تسجيل الدخول بمجرد موافقتك على مطالبة التصحيح عن بُعد، تحصر الإضافة نطاق المشاركة في مجموعة علامات تبويب يمكنك التحكم فيها بسهولة.

راجع أيضًا: المتصفح للاطلاع على نموذج ملفات التعريف الكامل وملف التعريف المُدار openclaw وملف تعريف Chrome MCP‏ user.