> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# OpenClaw
# OpenClaw 🦞
> *"قشّر! قشّر!"* — كركند فضائي، على الأرجح
Gateway لأي نظام تشغيل لوكلاء الذكاء الاصطناعي عبر Discord وGoogle Chat وiMessage وMatrix وMicrosoft Teams وSignal وSlack وTelegram وWhatsApp وZalo والمزيد.
أرسل رسالة، واحصل على رد من وكيل من جيبك. شغّل Gateway واحدًا عبر القنوات المدمجة، وPlugins القنوات المرفقة، وWebChat، والعُقد المحمولة.
ثبّت OpenClaw وشغّل Gateway خلال دقائق.
إعداد موجّه باستخدام `openclaw onboard` وتدفقات الاقتران.
شغّل لوحة معلومات المتصفح للدردشة، والإعدادات، والجلسات.
## ما هو OpenClaw؟
OpenClaw هو **Gateway مستضاف ذاتيًا** يربط تطبيقات الدردشة وأسطح القنوات المفضلة لديك — القنوات المدمجة إضافةً إلى Plugins القنوات المرفقة أو الخارجية مثل Discord وGoogle Chat وiMessage وMatrix وMicrosoft Teams وSignal وSlack وTelegram وWhatsApp وZalo والمزيد — بوكلاء برمجة ذكاء اصطناعي. تشغّل عملية Gateway واحدة على جهازك الخاص (أو على خادم)، فتصبح الجسر بين تطبيقات المراسلة لديك ومساعد ذكاء اصطناعي متاح دائمًا.
**لمن هو؟** للمطورين والمستخدمين المتقدمين الذين يريدون مساعد ذكاء اصطناعي شخصيًا يمكنهم مراسلته من أي مكان — من دون التخلي عن التحكم في بياناتهم أو الاعتماد على خدمة مستضافة.
**ما الذي يجعله مختلفًا؟**
* **مستضاف ذاتيًا**: يعمل على عتادك، ووفق قواعدك
* **متعدد القنوات**: يخدم Gateway واحد القنوات المدمجة وPlugins القنوات المرفقة أو الخارجية في الوقت نفسه
* **مصمم للوكلاء**: مبني لوكلاء البرمجة مع استخدام الأدوات، والجلسات، والذاكرة، وتوجيه متعدد الوكلاء
* **مفتوح المصدر**: مرخّص برخصة MIT وتقوده المجتمعات
**ماذا تحتاج؟** Node 24 (موصى به)، أو Node 22 LTS (`22.19+`) للتوافق، ومفتاح API من المزوّد الذي تختاره، و5 دقائق. للحصول على أفضل جودة وأمان، استخدم أقوى نموذج من الجيل الأحدث متاحًا.
## كيف يعمل
```mermaid theme={"theme":{"light":"min-light","dark":"min-dark"}}
flowchart LR
A["Chat apps + plugins"] --> B["Gateway"]
B --> C["OpenClaw agent"]
B --> D["CLI"]
B --> E["Web Control UI"]
B --> F["macOS app"]
B --> G["iOS and Android nodes"]
```
Gateway هو مصدر الحقيقة الوحيد للجلسات، والتوجيه، واتصالات القنوات.
## القدرات الرئيسية
Discord وiMessage وSignal وSlack وTelegram وWhatsApp وWebChat والمزيد عبر عملية Gateway واحدة.
تضيف Plugins المرفقة Matrix وNostr وTwitch وZalo والمزيد في الإصدارات الحالية العادية.
جلسات معزولة لكل وكيل، أو مساحة عمل، أو مُرسل.
أرسل واستقبل الصور، والصوت، والمستندات.
لوحة معلومات في المتصفح للدردشة، والإعدادات، والجلسات، والعُقد.
اقرن عُقد iOS وAndroid لتدفقات عمل Canvas والكاميرا والصوت.
## البدء السريع
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
npm install -g openclaw@latest
```
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --install-daemon
```
افتح واجهة التحكم في متصفحك وأرسل رسالة:
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw dashboard
```
أو صِل قناة ([Telegram](/ar/channels/telegram) هي الأسرع) وابدأ الدردشة من هاتفك.
هل تحتاج إلى إعداد التثبيت والتطوير الكامل؟ راجع [بدء الاستخدام](/ar/start/getting-started).
## لوحة المعلومات
افتح واجهة التحكم في المتصفح بعد بدء Gateway.
* الافتراضي المحلي: [http://127.0.0.1:18789/](http://127.0.0.1:18789/)
* الوصول عن بُعد: [أسطح الويب](/ar/web) و[Tailscale](/ar/gateway/tailscale)
## التكوين (اختياري)
يوجد ملف التكوين في `~/.openclaw/openclaw.json`.
* إذا **لم تفعل شيئًا**، يستخدم OpenClaw وقت تشغيل وكيل OpenClaw المرفق مع جلسات لكل مُرسل.
* إذا أردت تقييده، فابدأ بـ `channels.whatsapp.allowFrom` وقواعد الإشارة (للمجموعات).
مثال:
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
channels: {
whatsapp: {
allowFrom: ["+15555550123"],
groups: { "*": { requireMention: true } },
},
},
messages: { groupChat: { mentionPatterns: ["@openclaw"] } },
}
```
## ابدأ من هنا
كل المستندات والأدلة، منظّمة حسب حالة الاستخدام.
إعدادات Gateway الأساسية، والرموز، وتكوين المزوّد.
أنماط الوصول عبر SSH وtailnet.
إعداد خاص بالقنوات لـ Feishu وMicrosoft Teams وWhatsApp وTelegram وDiscord والمزيد.
عُقد iOS وAndroid مع الاقتران، وCanvas، والكاميرا، وإجراءات الجهاز.
نقطة دخول للإصلاحات الشائعة واستكشاف الأخطاء وإصلاحها.
## تعلّم المزيد
قدرات القنوات، والتوجيه، والوسائط كاملة.
عزل مساحة العمل وجلسات لكل وكيل.
الرموز، وقوائم السماح، وضوابط السلامة.
تشخيصات Gateway والأخطاء الشائعة.
أصول المشروع، والمساهمون، والترخيص.