> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# browser

# `openclaw browser`

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

ذو صلة:

* أداة المتصفح + واجهة برمجة التطبيقات: [Browser tool](/tools/browser)
* ترحيل امتداد Chrome: [Chrome extension](/tools/chrome-extension)

## Common flags

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

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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.

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw browser profiles
openclaw browser create-profile --name work --color "#FF5A36"
openclaw browser delete-profile --name work
```

استخدام ملف تعريف محدد:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw browser --browser-profile work tabs
```

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw browser tabs
openclaw browser open https://docs.openclaw.ai
openclaw browser focus <targetId>
openclaw browser close <targetId>
```

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

لقطة (Snapshot):

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw browser snapshot
```

لقطة شاشة (Screenshot):

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw browser screenshot
```

تصفح/نقر / نوع (تلقائية واجهة المستخدم القائمة على الرفع):

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw browser navigate https://example.com
openclaw browser click <ref>
openclaw browser type <ref> "hello"
```

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

يتيح هذا الوضع للوكيل التحكم في علامة تبويب Chrome موجودة تقوم بإرفاقها يدويًا (لا يتم الإرفاق تلقائيًا).

ثبّت الامتداد غير المعبّأ إلى مسار ثابت:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw browser extension install
openclaw browser extension path
```

ثم Chrome → `chrome://extensions` → تفعيل «Developer mode» → «Load unpacked» → اختيار المجلد المطبوع.

الدليل الكامل: [Chrome extension](/tools/chrome-extension)

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

إذا كان Gateway يعمل على جهاز مختلف عن المتصفح، فشغّل **مضيف عُقدة** على الجهاز الذي يحتوي على Chrome/Brave/Edge/Chromium. سيقوم Gateway بتمرير إجراءات المتصفح إلى تلك العُقدة (ولا يلزم وجود خادم تحكم بالمتصفح منفصل).

استخدم `gateway.nodes.browser.mode` للتحكم في التوجيه التلقائي و `gateway.nodes.browser.node` لتثبيت عُقدة محددة إذا كان هناك عدة عُقد متصلة.

الأمان + الإعداد عن بُعد: [Browser tool](/tools/browser)، [Remote access](/gateway/remote)، [Tailscale](/gateway/tailscale)، [Security](/gateway/security)