الانتقال إلى المحتوى الرئيسي

openclaw browser

إدارة خادم التحكم بالمتصفح في OpenClaw وتشغيل إجراءات المتصفح (علامات التبويب، اللقطات، لقطات الشاشة، التنقّل، النقرات، الكتابة). ذو صلة:

Common flags

  • --url <gatewayWsUrl>: عنوان URL لـ WebSocket الخاص بـ Gateway (الإعداد الافتراضي من التهيئة).
  • --token <token>: رمز Gateway (إذا كان مطلوبًا).
  • --timeout <ms>: مهلة الطلب (بالمللي ثانية).
  • --browser-profile <name>: اختيار ملف تعريف المتصفح (الافتراضي من التهيئة).
  • --json: مخرجات قابلة للقراءة آليًا (حيثما يكون مدعومًا).

البدء السريع (محليًا)

openclaw browser --browser-profile chrome tabs
openclaw browser --browser-profile openclaw start
openclaw browser --browser-profile openclaw open https://example.com
openclaw browser --browser-profile openclaw snapshot

الملفات الشخصية

الملفات الشخصية هي تهيئات مسماة لتوجيه المتصفح. عمليًا:
  • openclaw: تشغيل/الإرفاق بمثيل Chrome مُدار من OpenClaw ومخصّص (دليل بيانات مستخدم معزول).
  • chrome: التحكم في علامات تبويب Chrome الحالية لديك عبر ترحيل امتداد Chrome.
openclaw browser profiles
openclaw browser create-profile --name work --color "#FF5A36"
openclaw browser delete-profile --name work
استخدام ملف تعريف محدد:
openclaw browser --browser-profile work tabs

علامات التبويب

openclaw browser tabs
openclaw browser open https://docs.openclaw.ai
openclaw browser focus <targetId>
openclaw browser close <targetId>

لقطة / لقطة شاشة / إجراءات

لقطة (Snapshot):
openclaw browser snapshot
لقطة شاشة (Screenshot):
openclaw browser screenshot
تصفح/نقر / نوع (تلقائية واجهة المستخدم القائمة على الرفع):
openclaw browser navigate https://example.com
openclaw browser click <ref>
openclaw browser type <ref> "hello"

ترحيل إضافة Chrome (الاتصال عبر زر شريط الأدوات)

يتيح هذا الوضع للوكيل التحكم في علامة تبويب Chrome موجودة تقوم بإرفاقها يدويًا (لا يتم الإرفاق تلقائيًا). ثبّت الامتداد غير المعبّأ إلى مسار ثابت:
openclaw browser extension install
openclaw browser extension path
ثم Chrome → chrome://extensions → تفعيل «Developer mode» → «Load unpacked» → اختيار المجلد المطبوع. الدليل الكامل: Chrome extension

التحكم عن بُعد في المتصفح (وكيل مضيف node)

إذا كان Gateway يعمل على جهاز مختلف عن المتصفح، فشغّل مضيف عُقدة على الجهاز الذي يحتوي على Chrome/Brave/Edge/Chromium. سيقوم Gateway بتمرير إجراءات المتصفح إلى تلك العُقدة (ولا يلزم وجود خادم تحكم بالمتصفح منفصل). استخدم gateway.nodes.browser.mode للتحكم في التوجيه التلقائي و gateway.nodes.browser.node لتثبيت عُقدة محددة إذا كان هناك عدة عُقد متصلة. الأمان + الإعداد عن بُعد: Browser tool، Remote access، Tailscale، Security